Opplæring: Opprett, oppdater og vis innstillinger for miljøadministrasjon (forhåndsversjon)

[Denne artikkelen inneholder dokumentasjon for forhåndsversjonen og kan bli endret.]

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 scenariet kan det hende at en kunde vil aktivere IP-begrensninger for lagring av signatur for delt tilgang (SAS) og logging av SAS-samtaler.

Viktig!

• Dette er forhåndsversjonsfunksjon.
• Evalueringsfunksjonalitet er ikke ment for produksjonsbruk og kan ha begrensninger. Disse funksjonene er tilgjengelige før en offisiell utgivelse, slik at kunder kan få tidlig tilgang og gi tilbakemeldinger.

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 '49676daf-ff23-4aac-adcc-55472d4e2ce0' -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 IP-begrensninger for lagring av signatur for delt tilgang (SAS) og den relaterte funksjonen for overvåkingslogging. Disse to innstillingene er av, men vi vil senere oppdatere dem for å slå dem på.

#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