Delen via

Zelfstudie: Instellingen voor omgevingsbeheer maken, bijwerken en weergeven (preview)

  • Artikel

[Dit artikel maakt deel uit van de voorlopige documentatie en kan nog veranderen.]

In deze zelfstudie wordt gedemonstreerd hoe u de API (preview) kunt gebruiken om beheerinstellingen voor omgeving te maken, bij te werken en weer te geven. Power Platform

In deze zelfstudie leert u het volgende:

  1. Verifiëren via de Power Platform API.
  2. Maak een nieuwe instelwaarde.
  3. Geef alle beheerinstellingswaarden voor omgeving weer.
  4. Een instellingswaarde bijwerken.

Als voorbeeld van dit scenario wil een klant mogelijk Storage Shared Access Signature (SAS) IP-beperkingen en het loggen van SAS-aanroepen inschakelen.

Belangrijk

  • Dit is een preview-functie.
  • Preview-functies zijn niet bedoeld voor productiegebruik en bieden mogelijk beperkte functionaliteit. Deze functies zijn beschikbaar vóór een officiële release zodat klanten vroeg toegang kunnen krijgen en feedback kunnen geven.

Stap 1. Verifiëren met Power Platform API

Gebruik het volgende PowerShell-script om te verifiëren met behulp van de Power Platform API:

Import-Module "MSAL.PS"
$AuthResult = Get-MsalToken -ClientId '49676daf-ff23-4aac-adcc-55472d4e2ce0' -Scope 'https://api.powerplatform.com/.default'
$Headers = @{Authorization = "Bearer $($AuthResult.AccessToken)"}

Stap 2. Een nieuwe instellingswaarde maken

Gebruik het volgende script PowerShell om een nieuwe instellingswaarde te maken voor IP-beperkingen van Storage Shared Access Signature (SAS) en de bijbehorende auditregistratiefunctie. Deze twee instellingen zijn uitgeschakeld, maar we zullen ze later bijwerken om ze in te schakelen.

#Set your environment ID
$environmentId = "ENV_ID_HERE"

# Please uncomment the values that need to be updated
$EnvironmentManagementSettings = @{
    "EnableIpBasedStorageAccessSignatureRule" = $false
    "LoggingEnabledForIpBasedStorageAccessSignature" = $false
}

$body = $json = $EnvironmentManagementSettings | ConvertTo-Json

try 
{
    # Create the new setting value
    Write-Host "Invoking Create Management Setting for Environment $environmentId with body $body"
    $apiResponse = Invoke-WebRequest -Method Post -Uri "https://api.powerplatform.com/environmentmanagement/environments/$environmentId/settings/?api-version=2022-03-01-preview" -Headers $Headers -Body $body

    Write-Host "Operation Status: $apiResponse.StatusDescription"
} 
catch 
{
    # Dig into the exception to get the Response details.
    Write-Host "Response CorrelationId:" $_.Exception.Response.Headers["x-ms-correlation-id"]
    Write-Host "StatusCode:" $_.Exception.Response.StatusCode.value__ 
    Write-Host "StatusDescription:" $_.Exception.Response.StatusDescription
    $result = $_.Exception.Response.GetResponseStream()
        $reader = New-Object System.IO.StreamReader($result)
        $reader.BaseStream.Position = 0
        $reader.DiscardBufferedData()
        $responseBody = $reader.ReadToEnd();

        Write-Host $responseBody
}

Meer informatie over de Power Platform API-referentie in omgeving Beheerinstellingen - omgeving Beheerinstellingen maken.

Stap 3. Geef alle beheerinstellingen voor omgeving weer

Gebruik het volgende script PowerShell om alle eerder gemaakte instellingen voor omgeving weer te geven.

#Set your environment ID
$environmentId = "ENV_ID_HERE"

try 
{
    # Create the new setting value
    Write-Host "Invoking List Management Settings for Environment $environmentId"
    $apiResponse = Invoke-WebRequest -Method Get -Uri "https://api.powerplatform.com/environmentmanagement/environments/$environmentId/settings/?api-version=2022-03-01-preview&$select=EnableIpBasedStorageAccessSignatureRule,LoggingEnabledForIpBasedStorageAccessSignature" -Headers $Headers

    Write-Host $apiResponse
} 
catch 
{
    # Dig into the exception to get the Response details.
    Write-Host "Response CorrelationId:" $_.Exception.Response.Headers["x-ms-correlation-id"]
    Write-Host "StatusCode:" $_.Exception.Response.StatusCode.value__ 
    Write-Host "StatusDescription:" $_.Exception.Response.StatusDescription
    $result = $_.Exception.Response.GetResponseStream()
        $reader = New-Object System.IO.StreamReader($result)
        $reader.BaseStream.Position = 0
        $reader.DiscardBufferedData()
        $responseBody = $reader.ReadToEnd();

        Write-Host $responseBody
}

Meer informatie over de Power Platform API-referentie in omgeving Beheerinstellingen - Lijst met omgeving Beheerinstellingen.

Stap 4. Een instellingswaarde bijwerken

Gebruik het volgende script PowerShell om een eerder gedefinieerde instellingswaarde bij te werken. In deze stap schakelt u de logging voor Storage Shared Access Signature (SAS) in.

#Set your environment ID
$environmentId = "ENV_ID_HERE"

# Please uncomment the values that need to be updated
$EnvironmentManagementSettings = @{
    "LoggingEnabledForIpBasedStorageAccessSignature" = $true
}

$body = $json = $EnvironmentManagementSettings | ConvertTo-Json

try 
{
    # Updating the setting value
    Write-Host "Invoking Update Management Setting for Environment $environmentId with body $body"
    $apiResponse = Invoke-WebRequest -Method Patch -Uri "https://api.powerplatform.com/environmentmanagement/environments/$environmentId/settings/?api-version=2022-03-01-preview" -Headers $Headers -Body $body

    Write-Host "Operation Status: $apiResponse.StatusDescription"
} 
catch 
{
    # Dig into the exception to get the Response details.
    Write-Host "Response CorrelationId:" $_.Exception.Response.Headers["x-ms-correlation-id"]
    Write-Host "StatusCode:" $_.Exception.Response.StatusCode.value__ 
    Write-Host "StatusDescription:" $_.Exception.Response.StatusDescription
    $result = $_.Exception.Response.GetResponseStream()
        $reader = New-Object System.IO.StreamReader($result)
        $reader.BaseStream.Position = 0
        $reader.DiscardBufferedData()
        $responseBody = $reader.ReadToEnd();

        Write-Host $responseBody
}

Meer informatie over de Power Platform API-referentie vindt u in omgeving Beheerinstellingen - omgeving Beheerinstellingen bijwerken.

omgeving Beheerinstellingen