Condividi tramite

Tutorial: creare, aggiornare ed elencare le impostazioni di gestione ambiente (anteprima)

  • Articolo

[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]

Questo tutorial mostra come utilizzare l'API (anteprima) per creare, aggiornare ed elencare le impostazioni di gestione ambiente. Power Platform

In questa esercitazione, scopri come:

  1. Autenticazione tramite API Power Platform .
  2. Crea un nuovo valore di impostazione.
  3. Elenca tutti i valori delle impostazioni di gestione per ambiente.
  4. Aggiorna il valore di un'impostazione.

Come esempio di questo scenario, un cliente potrebbe voler attivare le restrizioni IP di Storage Shared Access Signature (SAS) e la registrazione delle chiamate SAS. ...

Importante

  • Questa è una funzionalità di anteprima.
  • Le funzionalità di anteprima non sono destinate a essere utilizzate per la produzione e sono soggette a restrizioni. Queste funzionalità sono disponibili prima di una versione ufficiale di modo che i clienti possano ottenere un accesso prioritario e fornire dei commenti.

Passaggio 1: Esegui autenticazione tramite API Power Platform

Utilizza il seguente script PowerShell per eseguire l'autenticazione usando l'API Power Platform.

Import-Module "MSAL.PS"
$AuthResult = Get-MsalToken -ClientId '00001111-aaaa-2222-bbbb-3333cccc4444' -Scope 'https://api.powerplatform.com/.default'
$Headers = @{Authorization = "Bearer $($AuthResult.AccessToken)"}

Passaggio 2. Crea un nuovo valore di impostazione

Utilizzare il seguente script di PowerShell per creare un nuovo valore di impostazione per le restrizioni IP di Storage Shared Access Signature (SAS) e la relativa funzionalità di registrazione dei controlli. Queste due impostazioni sono disattivate, tuttavia le aggiorneremo in seguito per attivarle.

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

Per ulteriori informazioni sul riferimento API, vedere Power Platform Impostazioni di gestione ambiente - Crea impostazioni di gestione ambiente .

Passaggio 3: Elenca tutte le impostazioni di gestione per ambiente

Utilizzare il seguente script di PowerShell per elencare tutte le impostazioni create in precedenza per questo 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
}

Per ulteriori informazioni sul riferimento API, vedere Power Platform ambiente Impostazioni di gestione - Elenco ambiente Impostazioni di gestione .

Passaggio 4: Aggiornare un valore di impostazione

Utilizzare il seguente script di PowerShell per aggiornare un valore di impostazione definito in precedenza. In questo passaggio, attivi la registrazione per Storage Shared Access Signature (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
}

Per ulteriori informazioni sul riferimento API, vedere Impostazioni di gestione ambiente - Aggiorna Impostazioni di gestione ambiente. Power Platform

ambiente Impostazioni di gestione