Dalintis per

Mokymo priemonė: aplinkos valdymo parametrų kūrimas ir sąrašų sudarymas

Šiame vadovėlyje parodyta, kaip naudoti Power Platform API (peržiūros versija) kuriant, naujinant ir išvardijant aplinkos valdymo parametrus.

Šioje pamokoje sužinosite, kaip:

  1. Autentifikuokite naudodami Power Platform API.
  2. Sukurkite naują parametro reikšmę.
  3. Išvardykite visas aplinkos valdymo parametrų reikšmes.
  4. Atnaujinkite parametro reikšmę.

Kaip šio scenarijaus pavyzdį klientas gali norėti įjungti saugyklos bendrinamos prieigos parašo (SAS) IP apribojimus ir SAS iškvietimų registravimą.

1 veiksmas. Autentifikuokite naudodami Power Platform API

Naudokite šį PowerShell scenarijų, kad autentifikuotumėte naudodami 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 veiksmas. Naujos parametro reikšmės kūrimas

Naudokite šį "PowerShell" scenarijų, kad sukurtumėte naują saugyklos bendrinamo prieigos parašo (SAS) IP apribojimų ir susijusios audito registravimo galimybės parametro reikšmę. Šie du parametrai išjungti, bet vėliau juos atnaujinsime, kad juos įjungtume.

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

Sužinokite daugiau apie Power Platform API nuorodą aplinkos valdymo nustatymuose - Aplinkos valdymo parametrų kūrimas.

3 veiksmas. Išvardykite visus aplinkos valdymo parametrus

Naudokite šį PowerShell scenarijų, kad pateiktumėte visus anksčiau sukurtus šios aplinkos parametrus.

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

Sužinokite daugiau apie Power Platform API nuorodą aplinkos valdymo parametrų sąraše - Aplinkos valdymo parametrų sąrašas.

4 veiksmas. Parametro reikšmės naujinimas

Naudokite šį PowerShell scenarijų, kad atnaujintumėte anksčiau apibrėžtą parametro reikšmę. Atlikdami šį veiksmą įjungiate saugyklos bendrinamos prieigos parašo (SAS) registravimą.

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

Sužinokite daugiau apie Power Platform API nuorodą aplinkos valdymo parametrų dalyje – Aplinkos valdymo parametrų naujinimas.

Aplinkos valdymo parametrai

  • Last updated on