Oktatóanyag: Bérlők közötti elszigetelési jelentések létrehozása (előzetes verzió)

Cikk
10/23/2023

[Ez a cikk egy előzetes kiadási dokumentáció, amely a későbbiekben változhat.]

Ez az oktatóanyag bemutatja, hogyan használható az Power Platform API (előzetes verzió) bérlők közötti elkülönítési jelentések létrehozásához.

Ebből az oktatóanyagból megtudhatja, hogyan:

Hitelesítés API-val Power Platform
Jelentés létrehozása
A bérlő összes jelentésének listázása
Egyetlen jelentés lekérése

Fontos

Ez egy előnézeti funkció.
Az előzetes funkciókat nem célszerű termelési környezetben használni, és előfordulhat, hogy korlátozott funkcionalitással rendelkeznek. Ezek a funkciók a hivatalos kiadás előtt érhetők el, hogy az ügyfelek korán megismerkedhessenek velük, és visszajelzést adhassanak róluk.
Az állomásnév és az adategyezmények változhatnak a funkció előzetes verziójának időszakában.
A bérlők elkülönítésével kapcsolatos további részletekért lásd: Bérlők közötti bejövő és kimenő korlátozások.

1. lépés Hitelesítés API-val Power Platform

Az API-val való Power Platform hitelesítéshez használja a következő PowerShell-szkriptet.

Feljegyzés

Csak a globális rendszergazdai és Power Platform rendszergazdai Entra-azonosító szerepkörökkel rendelkező felhasználók rendelkeznek engedéllyel a bérlői elkülönítési hatásjelentés futtatásához.

Import-Module "MSAL.PS"
$AuthResult = Get-MsalToken -ClientId '49676daf-ff23-4aac-adcc-55472d4e2ce0' -Scope 'https://api.powerplatform.com/.default'
$Headers = @{Authorization = "Bearer $($AuthResult.AccessToken)"}

2. lépés Jelentés létrehozása

A jelentés létrehozásához használja a következő PowerShell-szkriptet.

Feljegyzés

Bérlőnként és naptári naponként csak egy jelentést hozhat létre.

try 
{
    # Create a cross tenant connections report
    $tenantReportCreateResponse = Invoke-RestMethod -Method Post -Uri "https://api.powerplatform.com/governance/crossTenantConnectionReports?api-version=2022-03-01-preview" -Headers $Headers -Body ""
    $reportId = $tenantReportCreateResponse.reportId
    $reportStatus = $tenantReportCreateResponse.status

    Write-Host "Cross tenant connections report created with ID=$reportId and status=$reportStatus" 

} 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-referencia: Bérlők közötti kapcsolati jelentés létrehozása

3. lépés A bérlő összes jelentésének listázása

A következő PowerShell-szkript használatával listába sorolhatja a bérlő számára elérhető összes jelentést.

try 
{
     # Get all available cross tenant connections reports for a tenant
    $tenantListReportResponse = Invoke-RestMethod -Method Get -Uri "https://api.powerplatform.com/governance/crossTenantConnectionReports?api-version=2022-03-01-preview" -Headers $Headers
    $report = $tenantListReportResponse | ConvertTo-Json -Depth 3 
    Write-Host $report 

} 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-referencia: Bérlők közötti kapcsolati jelentés lekérte

4. lépés Egyetlen jelentés lekérése

A következő PowerShell-szkript használatával egyetlen jelentést kérhet le a bérlő számára a bérlőn belül használt kapcsolatokról.

try 
{
   # Get one cross tenant connections report for a tenant
    $tenantListReportResponse = Invoke-RestMethod -Method Get -Uri "https://api.powerplatform.com/governance/crossTenantConnectionReports/{$reportId}?api-version=2022-03-01-preview" -Headers $Headers
    $report = $tenantListReportResponse | ConvertTo-Json -Depth 2 
    Write-Host $report
    Write-Host "" 

} catch {
    # Go through 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-hivatkozás: Bérlők közötti kapcsolati jelentések listázása

Kapcsolódó információk

Power Platform API-referencia – Bérlők közötti kapcsolati jelentések

Share via