Tutorial: Cipta, kemas kini dan senaraikan Tetapan Pengurusan Persekitaran

Tutorial ini menunjukkan cara menggunakan Power Platform API (pratonton) untuk mencipta, mengemas kini dan menyenaraikan Tetapan Pengurusan Persekitaran.

Dalam tutorial ini, ketahui cara:

1. Sahkan menggunakan Power Platform API.
2. Buat nilai tetapan baharu.
3. Senaraikan semua nilai tetapan pengurusan untuk persekitaran.
4. Kemas kini nilai tetapan.

Sebagai contoh senario ini, pelanggan mungkin mahu menghidupkan sekatan IP Tandatangan Capaian Dikongsi Storan (SAS) dan pengelogan panggilan SAS.

Langkah 1. Sahkan menggunakan Power Platform API

Gunakan skrip PowerShell berikut untuk mengesahkan menggunakan 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)"}

Langkah 2. Cipta nilai seting baharu

Gunakan skrip PowerShell berikut untuk mencipta nilai seting baharu untuk sekatan IP Tandatangan Capaian Dikongsi (SAS) Storan dan keupayaan pengelogan audit yang berkaitan. Kedua-dua tetapan ini dimatikan, tetapi kami akan mengemas kininya kemudian untuk menghidupkannya.

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

Ketahui lebih lanjut tentang Power Platform rujukan API dalam Tetapan Pengurusan Alam Sekitar - Cipta Tetapan Pengurusan Persekitaran.

Langkah 3. Senaraikan semua tetapan pengurusan untuk persekitaran

Gunakan skrip PowerShell berikut untuk menyenaraikan semua tetapan yang dicipta sebelum ini untuk persekitaran ini.

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

Ketahui lebih lanjut tentang Power Platform rujukan API dalam Tetapan Pengurusan Alam Sekitar - Tetapan Pengurusan Alam Sekitar Senarai.

Langkah 4. Kemas kini nilai tetapan

Gunakan skrip PowerShell berikut untuk mengemas kini nilai tetapan yang ditakrifkan sebelum ini. Dalam langkah ini, anda menghidupkan pengelogan untuk Tandatangan Akses Dikongsi Storan (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
}

Ketahui lebih lanjut tentang Power Platform rujukan API dalam Tetapan Pengurusan Alam Sekitar - Kemas kini Tetapan Pengurusan Persekitaran.

Maklumat berkaitan

Tetapan Pengurusan Alam Sekitar