Udostępnij za pośrednictwem

Samouczek: tworzenie, aktualizowanie i wyświetlanie listy ustawień zarządzania środowiskiem (wersja zapoznawcza)

  • Artykuł

[Ten artykuł stanowi wstępną wersję dokumentacji i może ulec zmianie.]

W tym samouczku pokazano, jak używać Power Platform interfejsu API (wersja zapoznawcza) do tworzenia, aktualizowania i wyświetlania listy ustawień zarządzania środowiskiem.

Z tego samouczka dowiesz się, jak wykonywać następujące czynności:

  1. Uwierzytelnianie za pomocą Power Platform interfejsu API.
  2. Utwórz nową wartość ustawienia.
  3. Wyświetl listę wszystkich wartości ustawień zarządzania dla środowiska.
  4. Zaktualizuj wartość ustawienia.

Przykładem tego scenariusza może być włączenie ograniczeń adresów IP sygnatury dostępu współdzielonego magazynu (SAS) i rejestrowanie wywołań sygnatury dostępu współdzielonego.

Ważne

  • Jest to funkcja w wersji zapoznawczej.
  • Funkcje w wersji zapoznawczej nie są przeznaczone do użytku w środowiskach produkcyjnych i mogą mieć ograniczoną funkcjonalność. Te funkcje są udostępniane przed oficjalnym wydaniem, dzięki czemu klienci mogą szybciej uzyskać do nich dostęp i przekazać opinie na ich temat.

Krok 1. Uwierzytelniaj przy użyciu API Power Platform

Do utworzenia adresu API Power Platform może służyć następujący skrypt programu PowerShell.

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. Tworzenie nowej wartości ustawienia

Użyj poniższego skryptu PowerShell, aby utworzyć nową wartość ustawienia dla ograniczeń adresów IP sygnatury dostępu współdzielonego (SAS) magazynu i powiązanej funkcji rejestrowania inspekcji. Te dwa ustawienia są wyłączone, jednak później zaktualizujemy je, aby je włączyć.

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

Dowiedz się więcej o Power Platform dokumentacji interfejsu API w temacie Ustawienia zarządzania środowiskiem — tworzenie ustawień zarządzania środowiskiem.

Krok 3. Wyświetlanie listy wszystkich ustawień zarządzania dla środowiska

Użyj poniższego skryptu PowerShell, aby wyświetlić listę wszystkich wcześniej utworzonych ustawień dla tego środowiska.

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

Dowiedz się więcej o Power Platform dokumentacji interfejsu API w temacie Ustawienia zarządzania środowiskiem - Wyświetlanie listy ustawień zarządzania środowiskiem.

Krok 4. Aktualizowanie wartości ustawienia

Użyj następującego skryptu PowerShell, aby zaktualizować wcześniej zdefiniowaną wartość ustawienia. W tym kroku włączysz rejestrowanie sygnatury dostępu współdzielonego magazynu (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
}

Dowiedz się więcej o Power Platform dokumentacji interfejsu API w temacie Ustawienia zarządzania środowiskiem - Aktualizacja ustawień zarządzania środowiskiem.

Ustawienia zarządzania środowiskiem