Κοινή χρήση μέσω

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

  • Άρθρο

[Αυτό το άρθρο αποτελεί τεκμηρίωση προέκδοσης και ενδέχεται να αλλάξει.]

Αυτό το πρόγραμμα εκμάθησης δείχνει πώς μπορείτε να χρησιμοποιήσετε το 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 '49676daf-ff23-4aac-adcc-55472d4e2ce0' -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 στις Ρυθμίσεις διαχείρισης περιβάλλοντος - Ενημέρωση ρυθμίσεων διαχείρισης περιβάλλοντος.

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