Споделяне чрез

Въвеждащ курс: Създаване, актуализиране и изброяване на настройките за управление на среда

Този урок демонстрира как да използвате Power Platform API (преглед) за създаване, актуализиране и изброяване на настройките за управление на средата.

В този урок научете как да:

  1. Удостоверяване с помощта Power Platform на API.
  2. Създайте нова стойност на настройката.
  3. Избройте всички стойности на настройките за управление за околната среда.
  4. Актуализиране на стойност на настройката.

Като пример за този сценарий, клиентът може да иска да включи IP ограниченията за подпис за споделен достъп (SAS) за място за съхранение и да регистрира повикванията от SAS.

Стъпка 1. Удостоверяване с помощта Power Platform на API

Използвайте следния скрипт PowerShell за удостоверяване с помощта 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)"}

Стъпка 2. Създаване на нова стойност на настройката

Използвайте следния скрипт на PowerShell, за да създадете нова стойност на настройка за IP ограниченията за подпис за споделен достъп (SAS) за съхранение и свързаната възможност за регистриране на проверка. Тези две настройки са изключени, но ще ги актуализираме по-късно, за да ги включим.

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

Научете повече за справката за Power Platform API в Настройки за управление на околната среда - Създаване на настройки за управление на средата.

Стъпка 3. Изброяване на всички настройки за управление на средата

Използвайте следния скрипт PowerShell, за да изброите всички предварително създадени настройки за тази среда.

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

Научете повече за справката за Power Platform API в Настройки за управление на околната среда - Списък с настройки за управление на средата.

Стъпка 4. Актуализиране на стойност на настройка

Използвайте следния скрипт PowerShell, за да актуализирате предварително дефинирана стойност на настройката. В тази стъпка включвате регистрирането за подпис за споделен достъп за съхранение (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
}

Научете повече за справката за Power Platform API в Настройки за управление на средата - Актуализиране на настройките за управление на средата.

Настройки за управление на околната среда

  • Last updated on