Compartir por

Titorial: Crear, actualizar e enumerar as opcións de xestión de ambientes

Este titorial mostra como usar a Power Platform API (versión preliminar) para crear, actualizar e enumerar as opcións de xestión do entorno.

Neste tutorial, aprende a:

  1. Autentique mediante Power Platform API.
  2. Crea un novo valor de configuración.
  3. Enumere todos os valores de configuración de xestión para o ambiente.
  4. Actualiza un valor de configuración.

Como exemplo deste escenario, un cliente pode querer activar as restricións IP de sinatura de acceso compartido de almacenamento (SAS) e o rexistro de chamadas SAS.

Paso 1. Autentique mediante Power Platform API

Use o seguinte script PowerShell para autenticarse mediante 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)"}

Paso 2. Crea un novo valor de configuración

Use o seguinte script de PowerShell para crear un novo valor de configuración para as restricións IP de firma de acceso compartido de almacenamento (SAS) e a capacidade de rexistro de auditoría relacionada. Estas dúas opcións están desactivadas, pero actualizarémolas máis tarde para activalas.

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

Obtén máis información sobre a Power Platform referencia da API en Configuración de xestión do entorno: crear configuracións de xestión do entorno.

Paso 3. Enumere todas as opcións de xestión do contorno

Use o seguinte script PowerShell para listar todos os axustes creados anteriormente para este ambiente.

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

Obtén máis información sobre a Power Platform referencia da API en Configuración de xestión de ambientes: lista de configuracións de xestión de ambientes.

Paso 4. Actualizar un valor de configuración

Use o seguinte script PowerShell para actualizar un valor de configuración definido previamente. Neste paso, activas o rexistro para a sinatura de acceso compartido de almacenamento (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
}

Obtén máis información sobre a Power Platform referencia da API en Configuración de xestión do medio ambiente - Actualizar a configuración da xestión do entorno.

Configuración da xestión ambiental

  • Last updated on