के माध्यम से साझा करें


ट्यूटोरियल: बनाएँ, अद्यतन करें और सूचीबद्ध करें पर्यावरण प्रबंधन सेटिंग्स

यह ट्यूटोरियल दर्शाता है कि पर्यावरण प्रबंधन सेटिंग्स बनाने, अपडेट करने और सूचीबद्ध करने के लिए Power Platform API (पूर्वावलोकन) का उपयोग कैसे करें।

इस ट्यूटोरियल में जानें कि कैसे:

  1. Power Platform API का उपयोग करके प्रमाणीकरण करें.
  2. एक नया सेटिंग मान बनाएँ.
  3. परिवेश के लिए सभी प्रबंधन सेटिंग मानों को सूचीबद्ध करें.
  4. सेटिंग मान अपडेट करें.

इस परिदृश्य के उदाहरण के रूप में, कोई ग्राहक संग्रहण साझा पहुँच हस्ताक्षर (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 स्क्रिप्ट का उपयोग करें। इस चरण में, आप स्टोरेज साझा एक्सेस हस्ताक्षर (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 संदर्भ के बारे में अधिक जानें - पर्यावरण प्रबंधन सेटिंग्स अपडेट करें .

पर्यावरण प्रबंधन सेटिंग्स