Partajați prin

Tutorial: Crearea, actualizarea și listarea setărilor de gestionare a mediului

Acest tutorial demonstrează cum să utilizați Power Platform API-ul (versiune preliminară) pentru a crea, actualiza și lista setări de gestionare a mediului.

În acest tutorial, aflați cum să:

  1. Autentificați-vă folosind Power Platform API.
  2. Creați o nouă valoare de setare.
  3. Listați toate valorile setărilor de management pentru mediu.
  4. Actualizați o valoare de setare.

Ca exemplu al acestui scenariu, un client poate dori să activeze restricțiile IP pentru semnătura de acces partajat de stocare (SAS) și înregistrarea în jurnal a apelurilor SAS.

Pasul 1. Autentificați-vă folosind Power Platform API

Utilizați următorul script PowerShell pentru a vă autentifica folosind 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)"}

Pasul 2. Creați o nouă valoare de setare

Utilizați următorul script PowerShell pentru a crea o nouă valoare de setare pentru restricțiile IP pentru semnătura de acces partajat de stocare (SAS) și capacitatea de înregistrare în jurnalul de auditare asociat. Aceste două setări sunt dezactivate, dar le vom actualiza mai târziu pentru a le activa.

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

Aflați mai multe despre Power Platform referința API în Setări de gestionare a mediului - Creați setări de gestionare a mediului.

Pasul 3. Listați toate setările de management pentru mediu

Utilizați următorul script PowerShell pentru a lista toate setările create anterior pentru acest mediu.

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

Aflați mai multe despre Power Platform referința API în Setări de gestionare a mediului - Listează setările de gestionare a mediului.

Pasul 4. Actualizați o valoare de setare

Utilizați următorul script PowerShell pentru a actualiza o valoare de setare definită anterior. În acest pas, activați înregistrarea pentru semnătura de acces partajat la stocare (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
}

Aflați mai multe despre Power Platform referința API în Setări de gestionare a mediului - Actualizați setările de gestionare a mediului.

Setări de management al mediului

  • Last updated on