Tutorial: Berichte über die übergreifende Mandantenisolierung erstellen

Artikel
02/12/2025

Dieses Tutorial zeigt, wie Sie die Power Platform-API verwenden, um Berichte über die übergreifende Mandantenisolierung zu erstellen.

In diesem Tutorial lernen Sie, wie Sie:

Authentifizieren mit der Power Platform-API
Einen Bericht erstellen
Alle Berichte für den Mandanten auflisten
Einzelnen Bericht abrufen

Wichtig

Weitere Details zur Mandantenisolierung finden Sie unter Mandantenübergreifende ein- und ausgehende Einschränkungen.

Schritt 1. Mit der Power Platform-API authentifizieren

Verwenden Sie das folgende PowerShell-Skript, um mithilfe der Power Platform-API eine Authentifizierung durchzuführen.

Anmerkung

Benutzende mit der Entra ID-Rolle der Fachkraft für die Power Platform-Administration verfügen über die Berechtigung zum Ausführen des Berichts zu Auswirkungen der Mandantenisolierung.

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

Schritt 2. Einen Bericht erstellen

Verwenden Sie das folgende PowerShell-Skript, um den Bericht zu erstellen.

Anmerkung

Sie können nur einen Bericht pro Mandant und Kalendertag erstellen.

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-Referenz: Mandantenübergreifenden Verbindungsbericht erstellen

Schritt 3. Alle Berichte für den Mandanten auflisten

Verwenden Sie das folgende PowerShell-Skript, um alle verfügbaren Berichte für Ihren Mandanten aufzulisten.

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-Referenz: Mandantenübergreifenden Verbindungsbericht abrufen

Schritt 4. Einzelnen Bericht abrufen

Verwenden Sie das folgende PowerShell-Skript, um für Ihren Mandanten einen einzelnen Bericht über die innerhalb des Mandanten verwendeten Verbindungen abzurufen.

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-Referenz: Mandantenübergreifenden Verbindungsberichte auflisten

Siehe auch

Power Platform-API-Referenz – Bericht über mandantenübergreifende Verbindungen

Freigeben über