Partilhar via

Tutorial: Criar, atualizar e listar Definições de Gestão do Ambiente (pré-visualização)

  • Artigo

[Este artigo inclui documentação pré-versão e está sujeito a alterações.]

Este tutorial demonstra como usar a Power Platform API (pré-visualização) para criar, atualizar e listar as Configurações de Gerenciamento de Ambiente.

Neste tutorial, saiba como:

  1. Autentique-se usando Power Platform API.
  2. Crie um novo valor de configuração.
  3. Liste todos os valores de configuração de gerenciamento para o ambiente.
  4. Atualize um valor de configuração.

Como exemplo desse cenário, um cliente pode querer ativar as restrições de IP SAS (Storage Shared Access Signature) e o registro de chamadas SAS.

Importante

  • Esta é uma funcionalidade de pré-visualização.
  • As caraterísticas de pré-visualização não se destinam à produção e poderão ter caraterísticas restritas. Estas caraterísticas estão disponíveis antes do lançamento oficial, para que os clientes possam ter acesso antecipado e enviar comentários.

Passo 1. Autenticar com a API do Power Platform

Utilize o seguinte script do PowerShell para autenticar com a API do Power Platform.

Import-Module "MSAL.PS"
$AuthResult = Get-MsalToken -ClientId '49676daf-ff23-4aac-adcc-55472d4e2ce0' -Scope 'https://api.powerplatform.com/.default'
$Headers = @{Authorization = "Bearer $($AuthResult.AccessToken)"}

Passo 2. Criar um novo valor de configuração

Use o seguinte script PowerShell para criar um novo valor de configuração para restrições de IP SAS (Storage Shared Access Signature) e o recurso de log de auditoria relacionado. Essas duas configurações estão desativadas, no entanto, mais tarde as atualizaremos para ativá-las.

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

Saiba mais sobre a referência da Power Platform API em Configurações de gerenciamento de ambiente - Criar configurações de gerenciamento de ambiente.

Passo 3. Listar todas as configurações de gerenciamento para o ambiente

Use o seguinte script PowerShell para listar todas as configurações criadas anteriormente para esse 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
}

Saiba mais sobre a referência da Power Platform API em Configurações de gerenciamento de ambiente - Listar configurações de gerenciamento de ambiente.

Passo 4. Atualizar um valor de configuração

Use o seguinte script PowerShell para atualizar um valor de configuração definido anteriormente. Nesse passo, você ativa o log para SAS (Storage Shared Access Signature).

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

Saiba mais sobre a referência da Power Platform API em Configurações de gerenciamento de ambiente - Atualizar configurações de gerenciamento de ambiente.

Configurações de gerenciamento de ambiente