Dela via

Självstudier: Skapa, uppdatera och lista inställningar för miljöhantering (förhandsversion)

  • Artikel

[Den här artikeln är en förhandsversion av dokumentationen och kan komma att ändras.]

Den här självstudien visar hur du använder API:et Power Platform (förhandsversion) för att skapa, uppdatera och lista miljöhanteringsinställningar.

I den här självstudien får du lära dig att:

  1. Autentisera med Power Platform API.
  2. Skapa ett nytt inställningsvärde.
  3. Visa en lista över alla värden för hanteringsinställningar för miljön.
  4. Uppdatera ett inställningsvärde.

Som ett exempel på det här scenariot kanske en kund vill aktivera IP-begränsningar för signatur för delad åtkomst (SAS) och loggning av SAS-anrop.

Viktigt

  • Detta är en förhandsversion.
  • Förhandsversion ska inte användas i produktion, och funktionerna kan vara begränsade. funktionerna är tillgängliga före den officiella publiceringen så att kunderna kan få tillgång tidigare och ge oss feedback.

Steg 1. Autentisera med hjälp av Power Platform API

Använd följande PowerShell-skript för att autentisera 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)"}

Steg 2. Skapa ett nytt inställningsvärde

Använd följande PowerShell skript för att skapa ett nytt inställningsvärde för IP-begränsningar för signatur för delad åtkomst (SAS) för lagring och den relaterade funktionen för granskningsloggning. Dessa två inställningar är avstängda, men vi kommer senare att uppdatera dem för att aktivera 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
}

Läs mer om API-referensen Power Platform i Inställningar för miljöhantering – Skapa inställningar för miljöhantering.

Steg 3. Visa en lista över alla hanteringsinställningar för miljön

Använd följande PowerShell skript för att visa en lista över alla tidigare skapade inställningar för den här miljön.

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

Läs mer om API-referensen Power Platform i Inställningar för miljöhantering – Lista inställningar för miljöhantering.

Steg 4. Uppdatera ett inställningsvärde

Använd följande PowerShell skript för att uppdatera ett tidigare definierat inställningsvärde. I det här steget aktiverar du loggning för signatur för delad åtkomst (Storage Shared Access Signature).

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

Läs mer om API-referensen Power Platform i Inställningar för miljöhantering – Uppdatera inställningar för miljöhantering.

Inställningar för miljöhantering