Оқулық: ортаны басқару параметрлерін жасау, жаңарту және тізімдеу

Бұл оқулық Қоршаған ортаны басқару параметрлерін жасау, жаңарту және тізімдеу үшін Power Platform API (алдын ала қарау нұсқасы) пайдалану жолын көрсетеді.

Бұл оқулықта мыналарды үйреніңіз:

  1. Power Platform API арқылы аутентификация.
  2. Жаңа параметр мәнін жасаңыз.
  3. Ортаға арналған барлық басқару параметрінің мәндерін тізімдеңіз.
  4. Параметр мәнін жаңартыңыз.

Осы сценарийге мысал ретінде тұтынушы Storage Shared Access Signature (SAS) IP шектеулерін және SAS қоңырауларын журналдауды қосқысы келуі мүмкін.

1-қадам. Power Platform API арқылы аутентификация

Power Platform API арқылы аутентификациялау үшін келесі PowerShell сценарийін пайдаланыңыз.

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-қадам. Жаңа параметр мәнін жасаңыз

Сақтау ортақ қатынау қолтаңбасы (SAS) IP шектеулері және тиісті аудит журналы мүмкіндігі үшін жаңа параметр мәнін жасау үшін келесі PowerShell сценарийін пайдаланыңыз. Бұл екі параметр өшірілген, бірақ біз оларды қосу үшін кейінірек жаңартамыз.

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

Power Platform API сілтемесі туралы қосымша ақпаратты Ортаны басқару параметрлері - Ортаны басқару параметрлерін жасау бөлімінен қараңыз.

3-қадам. Ортаға арналған барлық басқару параметрлерін тізімдеңіз

Осы орта үшін бұрын жасалған барлық параметрлерді тізімдеу үшін келесі PowerShell сценарийін пайдаланыңыз.

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

Power Platform API анықтамасы туралы толығырақ ақпаратты Қоршаған ортаны басқару параметрлері - Ортаны басқару параметрлерінің тізімі бөлімінен қараңыз.

4-қадам. Параметр мәнін жаңартыңыз

Бұрын анықталған параметр мәнін жаңарту үшін келесі PowerShell сценарийін пайдаланыңыз. Осы қадам ішінде сіз Storage Shared Access Signature (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
}

Power Platform API анықтамасы туралы қосымша ақпаратты Ортаны басқару параметрлері - Ортаны басқару параметрлерін жаңарту бөлімінен қараңыз.

Қоршаған ортаны басқару параметрлері

  • Last updated on