Zelfstudie: Isolatierapporten voor meerdere tenants maken

Artikel
02/12/2025

In deze zelfstudie wordt gedemonstreerd hoe u de Power Platform-API kunt gebruiken om isolatierapporten voor meerdere tenants te maken.

In deze zelfstudie leert u het volgende:

Verifiëren met de Power Platform-API
Een rapport maken
Een lijst maken van alle rapporten voor de tenant
Een enkel rapport ophalen

Belangrijk

Zie Beperkingen voor inkomend en uitgaand verkeer tussen tenants voor meer informatie over het isoleren van tenants.

Stap 1. Verifiëren met Power Platform API

Gebruik het volgende PowerShell-script om te verifiëren met behulp van de Power Platform API:

Notitie

Gebruikers met de Power Platform-beheerderrol Entra ID hebben toestemming om het rapport over de impact van tenantisolatie uit te voeren.

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

Stap 2. Een rapport maken

Gebruik het volgende PowerShell-script om het rapport te maken.

Opmerking

Per tenant kunt u slechts één rapport per kalenderdag maken.

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-referentie: Een rapport over meerdere tenantverbindingen maken

Stap 3. Een lijst maken van alle rapporten voor de tenant

Gebruik het volgende PowerShell-script om alle beschikbare rapporten voor uw tenant weer te geven.

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-referentie: Een rapport over meerdere tenantverbindingen ophalen

Stap 4. Een enkel rapport ophalen

Gebruik het volgende PowerShell-script om een enkel rapport voor uw tenant op te halen over verbindingen die binnen de tenant worden gebruikt.

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-referentie: Rapporten over meerdere tenantverbindingen vermelden

Zie ook

Power Platform API-referentie - Rapporten over meerdere tenantverbindingen

Delen via