Comparteix via

Tutorial: Crear i actualitzar configuracions d'administració de l'entorn i obtenir-ne un llistat

Aquest tutorial mostra com utilitzar l'API Power Platform (versió preliminar) per crear, actualitzar i enumerar la configuració d'administració de l'entorn.

En aquest tutorial, apreneu a:

  1. Autenticar-se mitjançant Power Platform l'API.
  2. Creeu un valor de configuració nou.
  3. Llista tots els valors de configuració d'administració per a l'entorn.
  4. Actualitzeu un valor de configuració.

Com a exemple d'aquest escenari, és possible que un client vulgui activar les restriccions d'IP de la signatura d'accés compartit d'emmagatzematge (SAS) i el registre de trucades SAS.

Pas 1. Autenticar-se mitjançant Power Platform API

Utilitzeu l'script PowerShell següent per autenticar-vos mitjançant Power Platform l'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)"}

Pas 2. Crear un valor de configuració nou

Utilitzeu l'script del PowerShell següent per crear un valor de configuració nou per a les restriccions IP de la signatura d'accés compartit d'emmagatzematge (SAS) i la capacitat de registre d'auditoria relacionada. Aquests dos paràmetres estan desactivats, però els actualitzarem més endavant per activar-los.

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

Obteniu més informació sobre la referència de l'API a Power Platform Configuració de l'administració de l'entorn - Crear la configuració de l'administració de l'entorn.

Pas 3. Llista de tots els paràmetres d'administració de l'entorn

Utilitzeu l'script PowerShell següent per enumerar tots els paràmetres creats anteriorment per a aquest entorn.

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

Obteniu més informació sobre la referència de l'API Power Platform a Configuració de l'administració de l'entorn - Llista de la configuració de l'administració de l'entorn.

Pas 4. Actualitzar un valor de configuració

Utilitzeu l'script PowerShell següent per actualitzar un valor de configuració definit anteriorment. En aquest pas, activeu el registre de la signatura d'accés compartit (SAS) d'emmagatzematge.

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

Obteniu més informació sobre la referència de l'API a Power Platform Configuració de l'administració de l'entorn - Actualitzar la configuració de l'administració de l'entorn.

Configuració de l'administració de l'entorn

  • Last updated on