ערכת לימוד: יצירה, עדכון ופירוט של הגדרות ניהול סביבה

מדריך זה מדגים כיצד להשתמש ב Power Platform API (Preview) כדי ליצור, לעדכן ולפרט את הגדרות ניהול הסביבה.

במדריך זה, תלמד איך:

1. אימות באמצעות Power Platform API.
2. צור ערך הגדרה חדש.
3. רשום את כל ערכי הגדרות הניהול עבור הסביבה.
4. עדכן ערך הגדרה.

כדוגמה לתרחיש זה, ייתכן שללקוח תרצה להפעיל הגבלות IP של חתימה משותפת של גישה משותפת לאחסון (SAS) ולרישום של שיחות SAS.

שלב 1. אמת באמצעות Power Platform API

השתמש בקובץ ה- Script הבא של 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. צור ערך הגדרה חדש

השתמש בקובץ ה- Script הבא של 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 הבא כדי לעדכן ערך הגדרה שהוגדר קודם לכן. ב-צעד הזה, אתה מפעיל את הרישום עבור 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
}

למידע נוסף על ההפניה ל Power Platform API ב הגדרות ניהול סביבה - עדכון הגדרות ניהול סביבה.

מידע קשור

הגדרות ניהול סביבה