Kopīgot, izmantojot

Apmācība: vides pārvaldības iestatījumu izveide, atjaunināšana un uzskaitīšana

Šī apmācība parāda, kā izmantot Power Platform API (priekšskatījums), lai izveidotu, atjauninātu un uzskaitītu vides pārvaldības iestatījumus.

Šajā apmācībā uzziniet, kā:

  1. Autentificēties, izmantojot Power Platform API.
  2. Izveidojiet jaunu iestatījuma vērtību.
  3. Uzskaitiet visas vides pārvaldības iestatījumu vērtības.
  4. Atjauniniet iestatījuma vērtību.

Kā piemēru šim scenārijam klients, iespējams, vēlēsies ieslēgt krātuves koplietojamās piekļuves paraksta (SAS) IP ierobežojumus un SAS zvanu reģistrēšanu.

1. darbība. Autentificēties, izmantojot Power Platform API

Izmantojiet šo PowerShell skriptu, lai autentificētos, izmantojot 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. darbība. Jaunas iestatījuma vērtības izveide

Izmantojiet tālāk norādīto PowerShell skriptu, lai izveidotu jaunu iestatījuma vērtību krātuves koplietojamās piekļuves paraksta (SAS) IP ierobežojumiem un saistītajai audita reģistrēšanas iespējai. Šie divi iestatījumi ir izslēgti, bet mēs tos atjaunināsim vēlāk, lai tos ieslēgtu.

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

Uzziniet vairāk par Power Platform API atsauci sadaļā Vides pārvaldības iestatījumi — izveidojiet vides pārvaldības iestatījumus.

3. darbība. Uzskaitiet visus vides pārvaldības iestatījumus

Izmantojiet šo PowerShell skriptu, lai uzskaitītu visus iepriekš izveidotos iestatījumus šai videi.

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

Uzziniet vairāk par Power Platform API atsauci sadaļā Vides pārvaldības iestatījumi — saraksts Vides pārvaldības iestatījumi.

4. darbība. Iestatījuma vērtības atjaunināšana

Izmantojiet šo PowerShell skriptu, lai atjauninātu iepriekš definētu iestatījuma vērtību. Šajā solis tiek ieslēgta krātuves koplietojamās piekļuves paraksta (SAS) reģistrēšana.

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

Uzziniet vairāk par Power Platform API atsauci sadaļā Vides pārvaldības iestatījumi — atjauniniet vides pārvaldības iestatījumus.

Vides pārvaldības iestatījumi

  • Last updated on