Opplæring: Opprett rapporter om kryssleierisolasjon
Denne opplæringen demonstrerer hvordan du bruker Power Platform-API-en til å opprette rapporter om kryssleierisolasjon.
I denne opplæringen lærer du hvordan du kan gjøre følgende:
- Godkjenn ved hjelp av Power Platform-API
- Opprette en rapport
- Vis alle rapporter for leieren
- Hente én enkelt rapport
Viktig!
Hvis du vil ha mer informasjon om leierisolasjon, kan du se Innkommende og utgående begrensninger på tvers av leier.
Trinn 1. Godkjenn med Power Platform API
Bruk følgende PowerShell-skript til å godkjenne med Power Platform API.
Notat
Brukere med rollen som Power Platform-administrator for Entra ID har tillatelse til å kjøre rapporten om innvirkning av leierisolasjon.
Import-Module "MSAL.PS"
$AuthResult = Get-MsalToken -ClientId '49676daf-ff23-4aac-adcc-55472d4e2ce0' -Scope 'https://api.powerplatform.com/.default'
$Headers = @{Authorization = "Bearer $($AuthResult.AccessToken)"}
Trinn 2. Opprette en rapport
Bruk følgende PowerShell-skript til å opprette rapporten.
Merk
Du kan bare opprette én rapport per leier per kalenderdag.
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-referanse: Opprette rapport om tilkobling på tvers av leier
Trinn 3. Vis alle rapporter for leieren
Bruk følgende PowerShell-skript nedenfor til å vise alle tilgjengelige rapporter for leieren.
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-referanse: Få rapport om tilkobling på tvers av leier
Trinn 4. Hente én enkelt rapport
Bruk PowerShell-skriptet nedenfor til å hente én enkelt rapport for leieren om tilkoblinger som brukes i leieren.
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-referanse: Vis rapporter om tilkobling på tvers av leier
Se også
Power Platform API-referanse - Rapporter om tilkobling på tvers av leier