Tutorial: Mandantenübergreifende Isolierungsberichte erstellen (Vorschau)

Artikel
10/16/2024

[Dieser Artikel ist Teil der Dokumentation zur Vorschauversion und kann geändert werden.]

Dieses Tutorial zeigt, wie Sie mit der Power Platform-API (Vorschau) mandantenübergreifende Isolierungsberichte erstellen.

In diesem Tutorial lernen Sie, wie Sie:

Authentifizierung per Power Platform API
Erstellen eines Berichts
Alle Berichte für den Mandanten auflisten
Einen einzelnen Bericht abrufen

Wichtig

Dies ist eine Vorschauversion.
Funktionen in der Vorschauversion sind nicht für den produktiven Einsatz gedacht und können eine eingeschränkte Funktionalität aufweisen. Diese Funktionen stehen vor der offiziellen Veröffentlichung zur Verfügung, damit Kunden frühzeitig Zugriff erhalten und Feedback geben können.
Der Hostname und die Datenverträge können sich während dieses Feature-Vorschauzeitraums ändern.
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

Benutzer mit der Entra-ID-Rolle Power Platform Administrator sind berechtigt, den Auswirkungsbericht Mandantenisolierung auszuführen.

Import-Module "MSAL.PS"
$AuthResult = Get-MsalToken -ClientId '00001111-aaaa-2222-bbbb-3333cccc4444' -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 – Berichte zu mandantenübergreifenden Verbindungen

Freigeben über