Tutoriala: Sortu, eguneratu eta zerrendatu ingurumena kudeatzeko ezarpenak

Tutorial honek Power Platform APIa (aurreargitalpen) nola erabili erakusten du Ingurunearen kudeaketa ezarpenak sortzeko, eguneratzeko eta zerrendatzeko.

Tutorial honetan, ikasi nola egin:

1. Autentifikatu Power Platform APIa erabiliz.
2. Sortu ezarpen-balio berri bat.
3. Zerrendatu ingurumenaren kudeaketa-ezarpen-balio guztiak.
4. Eguneratu ezarpen-balioa.

Agertoki honen adibide gisa, bezero batek Storage Shared Access Signature (SAS) IP murrizketak eta SAS deien erregistroa aktibatu nahi ditu.

1. urratsa. Autentifikatu Power Platform APIa erabiliz

Erabili PowerShell script hau Power Platform APIa erabiliz autentifikatzeko.

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. urratsa. Sortu ezarpen-balio berri bat

Erabili PowerShell script-a Honako ezarpen-balio berri bat sortzeko Biltegiratze Sarbide Partekatuaren Sinadura (SAS) IP murrizketetarako eta erlazionatutako auditoria erregistro-gaitasunerako. Bi ezarpen hauek desaktibatuta daude, baina geroago eguneratuko ditugu aktibatzeko.

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

Lortu informazio gehiago Power Platform APIaren erreferentziari buruz Ingurugiroa kudeatzeko ezarpenak - Sortu ingurunea kudeatzeko ezarpenak atalean.

3. urratsa. Zerrendatu ingurumenaren kudeaketa-ezarpen guztiak

Erabili PowerShell script hau aldez aurretik ingurune honetarako sortutako ezarpen guztiak zerrendatzeko.

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

Lortu informazio gehiago Power Platform APIaren erreferentziari buruz Ingurugiroa kudeatzeko ezarpenak - Zerrendatu ingurunearen kudeaketa ezarpenak atalean.

4. urratsa. Eguneratu ezarpen-balio bat

Erabili PowerShell script hau aldez aurretik definitutako ezarpen-balioa eguneratzeko. Urrats honetan, Biltegiratze Partekatutako Sarbide Sinaduraren (SAS) erregistroa aktibatzen duzu.

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

Lortu informazio gehiago Power Platform APIaren erreferentziari buruz Ingurugiroa kudeatzeko ezarpenak - Eguneratu ingurumena kudeatzeko ezarpenak atalean.

Erlazionatutako informazioa

Ingurumena kudeatzeko ezarpenak