Упутство: Креирање, ажурирање и навођење листе поставки за управљање окружењем

Овај туторијал показује како користити Power Platform АПИ (< ДИЦТ__верзија за преглед > превиеw ) за креирање, ажурирање и листу поставки управљања окружењем.

У овом водичу научите како:

  1. Аутентификујте помоћу Power Platform АПИ-ја.
  2. Креирајте нову вредност подешавања.
  3. Наведите све вредности подешавања управљања за животну средину.
  4. Ажурирајте вредност подешавања.

Као пример овог сценарија, корисник би можда желео да укључи ИП ограничења за складиштење дељени приступни потпис (САС) и евидентирање САС позива.

Корак 1. Аутентификујте помоћу Power Platform АПИ-ја

Користите следећу #глср_цихцдиедз скрипту за аутентификацију помоћу Power Platform АПИ-ја.

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. корак Креирајте нову вредност подешавања

Користите следећу ПоверСхелл скрипту да бисте креирали нову вредност подешавања за ИП ограничења Стораге Схаред Аццесс Сигнатуре (САС) и сродну могућност пријављивања ревизије. Ова два подешавања су искључена, али ћемо их касније ажурирати да их укључимо.

#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 у Подешавања управљања окружењем - Креирајте поставке управљања окружењем.

3. корак Наведите сва подешавања управљања за животну средину

Користите следећу #глср_цихцдиедз скрипту да наведете сва претходно креирана подешавања за ово окружење.

#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 у Подешавања управљања окружењем - Листа поставки управљања окружењем.

4. корак Ажурирајте вредност подешавања

Користите следећу #глср_цихцдиедз скрипту да ажурирате претходно дефинисану вредност подешавања. У овом корак укључите пријављивање за Стораге Схаред Аццесс Сигнатуре (САС).

#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 у Подешавања управљања окружењем - Ажурирање поставки управљања окружењем.

Подешавања управљања окружењем