Sdílet prostřednictvím

Kurz: Vytvoření, aktualizace a zobrazení seznamu nastavení správy prostředí

Tento tutoriál ukazuje, jak použít Power Platform API (Preview) k vytvoření, aktualizaci a výpisu nastavení správy prostředí.

V tomto kurzu se naučíte:

  1. Ověření pomocí Power Platform API.
  2. Vytvořte novou hodnotu nastavení.
  3. Vypište všechny hodnoty nastavení správy pro dané prostředí.
  4. Aktualizujte hodnotu nastavení.

Jako příklad tohoto scénáře může zákazník chtít zapnout omezení IP sdíleného přístupového podpisu úložiště (SAS) a protokolování volání SAS.

Krok 1. Ověřování pomocí rozhraní Power Platform API

Pomocí následujícího skriptu PowerShell provedete ověřování pomocí rozhraní 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)"}

Krok 2. Vytvořte novou hodnotu nastavení

Pomocí následujícího skriptu PowerShellu vytvořte novou hodnotu nastavení pro omezení IP podpisu sdíleného přístupového podpisu (SAS) úložiště a související možnosti protokolování auditu. Tato dvě nastavení jsou vypnutá, ale později je aktualizujeme, abychom je zapnuli.

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

Další informace o Power Platform referenčním rozhraní API naleznete v Nastavení správy prostředí – Vytvoření nastavení správy prostředí.

Krok 3. Vypište všechna nastavení správy pro dané prostředí

Pomocí následujícího skriptu PowerShell vypíšete všechna dříve vytvořená nastavení pro toto prostředí.

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

Další informace o Power Platform referenčním rozhraní API naleznete v Nastavení správy prostředí – Seznam nastavení správy prostředí.

Krok 4. Aktualizujte hodnotu nastavení

Pomocí následujícího skriptu PowerShell aktualizujte dříve definovanou hodnotu nastavení. V tomto krok zapnete protokolování pro 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
}

Další informace o Power Platform referenčním rozhraní API naleznete v Nastavení správy prostředí – Aktualizace nastavení správy prostředí.

Nastavení správy prostředí

  • Last updated on