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

[Tento článek představuje předběžnou dokumentaci a může se změnit.]

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 protokolu SAS (Storage Shared Access Signature) a protokolování hovorů SAS.

Důležité

• Toto je funkce Preview.
• Funkce Preview nejsou určené pro normální používání a mohou mít omezené fungování. Jsou to funkce, které jsou poskytnuté před svým oficiálním vydáním, aby si je zákazníci mohli co nejdříve vyzkoušet a mohli nám napsat své názory.

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 '49676daf-ff23-4aac-adcc-55472d4e2ce0' -Scope 'https://api.powerplatform.com/.default'
$Headers = @{Authorization = "Bearer $($AuthResult.AccessToken)"}

Krok 2. Vytvořte novou hodnotu nastavení

Pomocí následujícího skriptu PowerShell vytvořte novou hodnotu nastavení pro omezení IP protokolu SAS (Storage Shared Access Signature) a související schopnost protokolování auditu. Tato dvě nastavení jsou vypnutá, později je však 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í.

Související informace

Nastavení správy prostředí