Öğretici: Ortam Yönetimi Ayarları oluşturma, güncelleştirme ve listeleme

Bu öğreticide, Ortam Yönetimi Ayarlarını oluşturmak, güncelleştirmek ve listelemek için API'nin Power Platform (önizleme) nasıl kullanılacağı gösterilmektedir.

Bu öğreticide aşağıdakilerin nasıl yapılacağını öğreneceksiniz:

1. API kullanarak Power Platform kimlik doğrulaması yapın.
2. Yeni bir ayar değeri oluşturun.
3. Ortam için tüm yönetim ayarı değerlerini listeleyin.
4. Bir ayar değerini güncelleyin.

Bu senaryoya örnek olarak, müşteri Depolama Paylaşılan Erişim İmzası (SAS) IP kısıtlamalarını ve SAS çağrılarının günlüğe kaydedilmesini açmak isteyebilir.

1. Adım. Power Platform API'sini kullanarak kimlik doğrulama

Power Platform API'sini kullanarak kimlik doğrulaması yapmak için aşağıdaki PowerShell betiğini kullanın.

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. Adım. Yeni bir ayar değeri oluşturma

Depolama Paylaşılan Erişim İmzası (SAS) IP kısıtlamaları ve ilgili denetim günlüğü özelliği için yeni bir ayar değeri oluşturmak için aşağıdaki PowerShell betiğini kullanın. Bu iki ayar kapalıdır, ancak daha sonra bunları açmak için güncelleştireceğiz.

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

Ortam Yönetimi Ayarları - Ortam Yönetimi Ayarları Power Platform Oluşturma bölümündeki API başvurusu hakkındadaha fazla bilgi edinin.

3. Adım. Ortam için tüm yönetim ayarlarını listeleme

Bu ortam için önceden oluşturulmuş tüm ayarları listelemek için aşağıdaki PowerShell betiğini kullanın.

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

Ortam Yönetimi Ayarları - Ortam Yönetimi Ayarlarını Power Platform Listeleme bölümündeki API başvurusu hakkındadaha fazla bilgi edinin.

4. Adım. Ayar değerini güncelleme

Önceden tanımlanmış bir ayar değerini güncelleştirmek için aşağıdaki PowerShell komut dosyasını kullanın. Bu adımda, Depolama Paylaşılan Erişim İmzası (SAS) günlüğünü açarsınız.

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

Ortam Yönetimi Ayarları - Ortam Yönetimi Ayarlarını Power Platform Güncelleştir'deki API başvurusu hakkındadaha fazla bilgi edinin.

İlgili bilgiler

Ortam Yönetimi Ayarları