Κοινοποίηση μέσω

Πρόγραμμα εκμάθησης: Δημιουργία, ενημέρωση και λίστα ρυθμίσεων διαχείρισης περιβάλλοντος

Αυτό το πρόγραμμα εκμάθησης δείχνει πώς μπορείτε να χρησιμοποιήσετε το Power Platform API (έκδοση προεπισκόπησης) για να δημιουργήσετε, να ενημερώσετε και να παραθέσετε τις ρυθμίσεις διαχείρισης περιβάλλοντος.

Σε αυτό το εκπαιδευτικό βοήθημα, μάθετε πώς μπορείτε να κάνετε τα εξής:

  1. Έλεγχος ταυτότητας με χρήση Power Platform API.
  2. Δημιουργήστε μια νέα τιμή ρύθμισης.
  3. Καταχωρίστε όλες τις τιμές ρύθμισης διαχείρισης για το περιβάλλον.
  4. Ενημερώστε μια τιμή ρύθμισης.

Για παράδειγμα αυτού του σεναρίου, ένας πελάτης μπορεί να θέλει να ενεργοποιήσει τους περιορισμούς IP της υπογραφής κοινόχρηστης πρόσβασης χώρου αποθήκευσης (SAS) και την καταγραφή κλήσεων SAS.

Βήμα 1. Έλεγχος ταυτότητας με χρήση Power Platform API

Χρησιμοποιήστε την παρακάτω δέσμη ενεργειών PowerShell για να ελέγξετε την ταυτότητα χρησιμοπιώντας 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)"}

Βήμα 2. Δημιουργία νέας τιμής ρύθμισης

Χρησιμοποιήστε την ακόλουθη δέσμη ενεργειών PowerShell για να δημιουργήσετε μια νέα τιμή ρύθμισης για τους περιορισμούς IP της υπογραφής κοινόχρηστης πρόσβασης χώρου αποθήκευσης (SAS) και τη σχετική δυνατότητα καταγραφής ελέγχου. Αυτές οι δύο ρυθμίσεις είναι απενεργοποιημένες, αλλά θα τις ενημερώσουμε αργότερα για να τις ενεργοποιήσουμε.

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

Μάθετε περισσότερα σχετικά με την Power Platform αναφορά API στις Ρυθμίσεις διαχείρισης περιβάλλοντος - Δημιουργία ρυθμίσεων διαχείρισης περιβάλλοντος.

Βήμα 3. Λίστα όλων των ρυθμίσεων διαχείρισης για το περιβάλλον

Χρησιμοποιήστε την ακόλουθη δέσμη ενεργειών PowerShell για να παραθέσετε όλες τις ρυθμίσεις που δημιουργήθηκαν προηγουμένως για αυτό το περιβάλλον.

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

Μάθετε περισσότερα σχετικά με την Power Platform αναφορά API στις Ρυθμίσεις διαχείρισης περιβάλλοντος - Λίστα ρυθμίσεων διαχείρισης περιβάλλοντος.

Βήμα 4. Ενημέρωση τιμής ρύθμισης

Χρησιμοποιήστε την ακόλουθη δέσμη ενεργειών PowerShell για να ενημερώσετε μια τιμή ρύθμισης που έχει οριστεί προηγουμένως. Σε αυτήν την βήμα, μπορείτε να ενεργοποιήσετε την καταγραφή για υπογραφή κοινόχρηστης πρόσβασης αποθήκευσης (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
}

Μάθετε περισσότερα σχετικά με την Power Platform αναφορά API στις Ρυθμίσεις διαχείρισης περιβάλλοντος - Ενημέρωση ρυθμίσεων διαχείρισης περιβάλλοντος.

Ρυθμίσεις διαχείρισης περιβάλλοντος

  • Last updated on