Tutorial: Membuat, memperbarui, dan membuat daftar Pengaturan Manajemen Lingkungan

Tutorial ini menunjukkan cara menggunakan Power Platform API (pratinjau) untuk membuat, memperbarui, dan mencantumkan Pengaturan Manajemen Lingkungan.

Dalam tutorial ini, pelajari cara:

1. Autentikasi menggunakan Power Platform API.
2. Buat nilai pengaturan baru.
3. Mencantumkan semua nilai pengaturan manajemen untuk lingkungan.
4. Perbarui nilai pengaturan.

Sebagai contoh skenario ini, pelanggan mungkin ingin mengaktifkan pembatasan IP Storage Shared Access Signature (SAS) dan pengelogan panggilan SAS.

Langkah 1. Autentikasi menggunakan Power Platform API

Gunakan skrip PowerShell berikut untuk mengautentikasi 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. Membuat nilai pengaturan baru

Gunakan skrip PowerShell berikut untuk membuat nilai pengaturan baru untuk pembatasan IP Storage Shared Access Signature (SAS), dan kemampuan pengelogan audit terkait. Kedua pengaturan ini nonaktif, tetapi kami akan memperbaruinya nanti untuk mengaktifkannya.

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

Pelajari selengkapnya tentang Power Platform referensi API di Pengaturan Manajemen Lingkungan - Buat Pengaturan Manajemen Lingkungan.

Langkah 3. Mencantumkan semua pengaturan manajemen untuk lingkungan

Gunakan skrip PowerShell berikut untuk mencantumkan semua pengaturan yang dibuat sebelumnya untuk lingkungan 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
}

Pelajari selengkapnya tentang Power Platform referensi API di Pengaturan Manajemen Lingkungan - Daftar Pengaturan Manajemen Lingkungan.

Langkah 4. Memperbarui nilai pengaturan

Gunakan skrip PowerShell berikut untuk memperbarui nilai pengaturan yang ditentukan sebelumnya. Dalam langkah ini, Anda mengaktifkan pengelogan untuk Tanda Tangan Akses Bersama Penyimpanan (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
}

Pelajari selengkapnya tentang Power Platform referensi API di Pengaturan Manajemen Lingkungan - Perbarui Pengaturan Manajemen Lingkungan.

Informasi terkait

Pengaturan Manajemen Lingkungan