Oktatóanyag: Környezetkezelési beállítások létrehozása, frissítése és listázása

Ez az oktatóanyag bemutatja, hogyan használhatja az Power Platform API-t (előzetes verzió) környezetkezelési beállítások létrehozására, frissítésére és listázására.

Ebből az oktatóanyagból megtudhatja, hogyan:

1. Hitelesítés API használatával Power Platform .
2. Hozzon létre egy új beállítási értéket.
3. Sorolja fel a környezet összes felügyeleti beállításának értékét.
4. Beállítás értékének frissítése.

Erre a forgatókönyvre példaként előfordulhat, hogy az ügyfél szeretné bekapcsolni a tároló megosztott hozzáférésű jogosultságkódjának (SAS) IP-korlátozásait és az SAS-hívások naplózását.

1. lépés Hitelesítés API-val Power Platform

Az API-val való Power Platform hitelesítéshez használja a következő PowerShell szkriptet.

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. lépés Új beállítási érték létrehozása

A következő PowerShell-szkripttel hozzon létre egy új beállításértéket a megosztott hozzáférésű tárolókód (SAS) IP-korlátozásainak és a kapcsolódó naplózási funkciónak. Ez a két beállítás ki van kapcsolva, de később frissítjük őket, hogy bekapcsoljuk őket.

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

További információ az API-referenciáról: Power Platform Környezetkezelési beállítások – Környezetkezelési beállítások létrehozása.

3. lépés A környezet összes kezelési beállításának felsorolása

A következő PowerShell parancsfájllal listába sorolhatja a környezethez korábban létrehozott összes beállítást.

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

További információ az API-referenciáról: Power Platform Környezetkezelési beállítások – Környezetkezelési beállítások listázása.

4. lépés Beállítási érték frissítése

A következő PowerShell szkripttel frissíthet egy korábban definiált beállítási értéket. Ebben a lépés bekapcsolja a Storage közös hozzáférésű jogosultságának aláírása (SAS) naplózását.

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

További információ az Power Platform API-referenciáról: Környezetkezelési beállítások – Környezetkezelési beállítások frissítése.

Kapcsolódó információk

Környezetkezelési beállítások