Поділитися через

Посібник: створення, оновлення та перелік параметрів керування середовищем

У цьому посібнику 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