Opplæring: Opprett, oppdater og vis innstillinger for miljøadministrasjon

Denne opplæringen viser hvordan du bruker API-en Power Platform (forhåndsversjon) til å opprette, oppdatere og vise innstillinger for miljøbehandling.

I denne opplæringen lærer du hvordan du kan gjøre følgende:

1. Godkjenn ved hjelp av Power Platform API.
2. Opprett en ny innstillingsverdi.
3. Vis alle administrasjonsinnstillingsverdier for miljøet.
4. Oppdater en innstillingsverdi.

Som et eksempel på dette scenarioet kan det hende at en kunde ønsker å aktivere SAS-begrensninger (Storage Shared Access Signature) og logging av SAS-anrop.

Trinn 1. Godkjenn med Power Platform API

Bruk følgende PowerShell-skript til å godkjenne med Power Platform API.

Import-Module "MSAL.PS"
$AuthResult = Get-MsalToken -ClientId '<client id of your Microsoft Entra ID application registration>' -Scope 'https://api.powerplatform.com/.default'
$Headers = @{Authorization = "Bearer $($AuthResult.AccessToken)"}

Trinn 2. Opprette en ny innstillingsverdi

Bruk følgende PowerShell-skript til å opprette en ny innstillingsverdi for SAS-begrensninger (Storage Shared Access Signature) og den relaterte funksjonen for overvåkingslogging. Disse to innstillingene er deaktivert, men vi oppdaterer dem senere for å aktivere dem.

#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
}

Finn ut mer om API-referansen Power Platform i Innstillinger for miljøbehandling – Opprett innstillinger for miljøbehandling.

Trinn 3. Vis alle administrasjonsinnstillinger for miljøet

Bruk følgende PowerShell-skript til å vise alle de tidligere opprettede innstillingene for dette miljøet.

#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
}

Finn ut mer om API-referansen Power Platform i Innstillinger for miljøbehandling – Innstillinger for listemiljøbehandling.

Trinn 4. Oppdatere en innstillingsverdi

Bruk følgende PowerShell-skript til å oppdatere en tidligere definert innstillingsverdi. I dette trinnet aktiverer du logging for Storage Shared Access Signature (SAS).

#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
}

Finn ut mer om API-referansen Power Platform i Innstillinger for miljøbehandling – Oppdater innstillinger for miljøbehandling.

Relatert informasjon

Innstillinger for miljøadministrasjon