Vadnica: ustvarjanje, posodabljanje in objavljanje nastavitev za upravljanja okolja

Ta vadnica prikazuje, kako uporabiti Power Platform API (predogledna različica) za ustvarjanje, posodabljanje in seznam nastavitev upravljanja okolja.

V tej vadnici se naučite, kako:

1. Preverjanje pristnosti z Power Platform API.
2. Ustvarite novo vrednost nastavitve.
3. Navedite vse vrednosti nastavitev upravljanja za okolje.
4. Posodobite vrednost nastavitve.

Kot primer tega scenarija bo stranka morda želeli vklopiti omejitve naslovov IP za podpis v skupni rabi shrambe (SAS) in zapisovanje klicev SAS v dnevnik.

1. korak: Preverjanje pristnosti z Power Platform API

Uporabite naslednji skript PowerShell za preverjanje pristnosti z 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. korak. Ustvarite novo vrednost nastavitve

S tem skriptom PowerShell ustvarite novo vrednost nastavitve za omejitve NASLOVOV IP za podpis v skupni rabi shrambe (SAS) in povezano zmogljivost pisanja dnevnika nadzora. Ti dve nastavitvami sta izklopljeni, vendar ju bomo pozneje posodobili, da jih bomo lahko vklopili.

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

Izvedite več o Power Platform referenci API-ja v Nastavitve upravljanja okolja - Ustvarite nastavitve upravljanja okolja.

3. korak. Navedite vse nastavitve upravljanja za okolje

Uporabite naslednji skript PowerShell za seznam vseh predhodno ustvarjenih nastavitev za to okolje.

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

Več o Power Platform referenci API-ja v Nastavitve upravljanja okolja - Seznam nastavitev upravljanja okolja.

4. korak. Posodobite vrednost nastavitve

Uporabite naslednji skript PowerShell, da posodobite predhodno določeno vrednost nastavitve. V tem korak vklopite beleženje za podpis skupnega dostopa do shranjevanja (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
}

Izvedite več o Power Platform referenci API-ja v Nastavitve upravljanja okolja - posodobite nastavitve upravljanja okolja.

Sorodne informacije

Nastavitve upravljanja okolja