In diesem Lernprogramm wird die Verwendung der Programmiertools zum Erstellen mandantenübergreifender Isolationsberichte veranschaulicht.
In diesem Tutorial lernen Sie, wie Sie:
- Einen Bericht erstellen
- Alle Berichte für den Mandanten auflisten
- Einzelnen Bericht abrufen
Einen Bericht erstellen
Verwenden Sie die folgenden Informationen, um verschiedene Möglichkeiten zu finden, wie Sie einen neuen Bericht erstellen können.
Anmerkung
Sie können nur einen Bericht pro Mandant und Kalendertag erstellen.
Fügen Sie dem Zeichenbereich eine neue Aktion hinzu, suchen Sie nach "Erstellen einer Anforderung zum Generieren eines mandantenübergreifenden Verbindungsberichts für einen Mandanten oder Zurückgeben eines vorhandenen Berichts". Es sind keine Parameter erforderlich.
Verwenden Sie das folgende PowerShell-Skript, um den Bericht zu erstellen.
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)"}
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
}
Referenz zur Power Platform-API: Erstellen eines mandantenübergreifenden Verbindungsberichts
Alle Berichte für den Mandanten auflisten
Fügen Sie dem Zeichenbereich eine neue Aktion hinzu, und suchen Sie nach "Mandantenübergreifende Verbindungsberichte auflisten". Es sind keine Parameter erforderlich.
Verwenden Sie das folgende PowerShell-Skript, um alle verfügbaren Berichte für Ihren Mandanten aufzulisten.
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)"}
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
}
Referenz zur Power Platform-API: Abrufen eines mandantenübergreifenden Verbindungsberichts
Einzelnen Bericht abrufen
Fügen Sie dem Zeichenbereich eine neue Aktion hinzu, und suchen Sie nach "Abrufen eines mandantenübergreifenden Verbindungsberichts nach Berichts-ID für einen Mandanten". Geben Sie die Berichts-ID aus vorherigen Schritten an.
Verwenden Sie das folgende PowerShell-Skript, um für Ihren Mandanten einen einzelnen Bericht über die innerhalb des Mandanten verwendeten Verbindungen abzurufen.
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)"}
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
}
Referenz zur Power Platform-API: Auflisten von mandantenübergreifenden Verbindungsberichten
Verwandte Inhalte
Referenz zur Power Platform-API – Mandantenübergreifende Verbindungsberichte