Dijeli putem


Korisnički priručnik: Izrada, ažuriranje i popis postavki upravljanja okruženjem

Ovaj vodič pokazuje kako koristiti Power Platform API (pretpregled) za stvaranje, ažuriranje i popis postavki upravljanja okruženjem.

U ovom vodiču saznajte kako:

  1. Provjera autentičnosti pomoću Power Platform API-ja.
  2. Stvorite novu vrijednost postavke.
  3. Navedite sve vrijednosti postavki upravljanja za okruženje.
  4. Ažurirajte vrijednost postavke.

Kao primjer ovog scenarija, korisnik može uključiti IP ograničenja potpisa za zajednički pristup pohrani (SAS) i zapisivanje SAS poziva.

1. korak Provjera autentičnosti pomoću Power Platform API-ja

Upotrijebite sljedeću skriptu PowerShell za provjeru autentičnosti pomoću Power Platform API-ja.

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 Stvaranje nove vrijednosti postavke

Upotrijebite sljedeću skriptu powershell da biste stvorili novu vrijednost postavke za OGRANIČENJA IP-a za potpis zajedničkog pristupa pohrani (SAS) i povezane mogućnosti zapisivanja nadzora. Te su dvije postavke isključene, ali kasnije ćemo ih ažurirati da bismo ih uključili.

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

Saznajte više o referenci API-ja Power Platform u odjeljku Postavke upravljanja okruženjem – Stvaranje postavki upravljanja okruženjem.

3. korak Navedite sve postavke upravljanja za okruženje

Upotrijebite sljedeću skriptu PowerShell da biste nabrojali sve prethodno stvorene postavke za ovo okruženje.

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

Saznajte više o referenci API-ja Power Platform u odjeljku Postavke upravljanja okruženjem – popis postavki upravljanja okruženjem.

4. korak Ažuriranje vrijednosti postavke

Upotrijebite sljedeću skriptu PowerShell da biste ažurirali prethodno definiranu vrijednost postavke. U ovom korak uključit ćete zapisivanje za potpis zajedničkog pristupa pohrani (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
}

Saznajte više o referenci API-ja Power Platform u odjeljku Postavke upravljanja okruženjem – Ažuriranje postavki upravljanja okruženjem.

Postavke upravljanja okruženjem