Freigeben über

Tutorial: Einstellungen für Umgebungsmanagement erstellen, aktualisieren und auflisten (Vorschauversion)

  • Artikel

[Dieser Artikel ist Teil der Dokumentation zur Vorschauversion und kann geändert werden.]

Dieses Tutorial zeigt, wie Sie mit der Power Platform API (Vorschauversion) Umgebung-Verwaltungseinstellungen erstellen, aktualisieren und auflisten.

In diesem Tutorial lernen Sie, wie Sie:

  1. Authentifizieren Sie sich mithilfe der Power Platform API.
  2. Erstellen Sie einen neuen Einstellungswert.
  3. Listet alle Verwaltungseinstellungswerte für Umgebung auf.
  4. Aktualisieren Sie einen Einstellungswert.

Als Beispiel für dieses Szenario möchte ein Kunde möglicherweise Storage Shared Access Signature (SAS)-IP-Einschränkungen und die Protokollierung von SAS-Anrufen aktivieren.

Wichtig

  • Dies ist eine Vorschauversion.
  • Funktionen in der Vorschauversion sind nicht für den produktiven Einsatz gedacht und können eine eingeschränkte Funktionalität aufweisen. Diese Funktionen stehen vor der offiziellen Veröffentlichung zur Verfügung, damit Kunden frühzeitig Zugriff erhalten und Feedback geben können.

Schritt 1. Mit der Power Platform-API authentifizieren

Verwenden Sie das folgende PowerShell-Skript, um mithilfe der Power Platform-API eine Authentifizierung durchzuführen.

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

Schritt 2. Neuen Einstellungswert erstellen

Verwenden Sie das folgende Skript PowerShell, um einen neuen Einstellungswert für Storage Shared Access Signature (SAS)-IP-Einschränkungen und die zugehörige Überwachungsprotokollierungsfunktion zu erstellen. Diese beiden Einstellungen sind deaktiviert. Wir werden sie jedoch später aktualisieren, um sie zu aktivieren.

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

Erfahren Sie mehr über die Power Platform API-Referenz in Umgebung-Verwaltungseinstellungen – Umgebung-Verwaltungseinstellungen erstellen.

Schritt 3. Listen Sie alle Verwaltungseinstellungen für Umgebung auf.

Verwenden Sie das folgende PowerShell-Skript, um alle zuvor erstellten Einstellungen für dieses Umgebung aufzulisten.

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

Erfahren Sie mehr über die Power Platform API-Referenz in Umgebung-Verwaltungseinstellungen – Liste der Umgebung-Verwaltungseinstellungen.

Schritt 4. Aktualisieren eines Einstellungswerts

Verwenden Sie das folgende Skript PowerShell, um einen zuvor definierten Einstellungswert zu aktualisieren. In diesem Schritt aktivieren Sie die Protokollierung für 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
}

Erfahren Sie mehr über die Power Platform API-Referenz in Umgebung-Verwaltungseinstellungen – Update Umgebung-Verwaltungseinstellungen.

Umgebung Verwaltungseinstellungen