Esercitazione: creare report di isolamento dei tenant

Articolo
02/12/2025

Questa esercitazione dimostra come usare l'API Power Platform per creare report di isolamento dei tenant.

In questa esercitazione, scopri come:

Esegui autenticazione tramite API Power Platform
Creazione di un report
Elenca tutti i report per il tenant
Recupera un singolo report

Importante

Per ulteriori dettagli sull'isolamento del tenant, vedi Restrizioni in entrata e in uscita tra tenant.

Passaggio 1: Esegui autenticazione tramite API Power Platform

Utilizza il seguente script PowerShell per eseguire l'autenticazione usando l'API Power Platform.

Nota

Gli utenti con il ruolo di amministratore Entra ID in Power Platform dispongono dell'autorizzazione per eseguire il report sull'impatto dell'isolamento del tenant.

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

Passaggio 2. Creazione di un report

Utilizza il seguente script PowerShell per creare il report.

Nota

Puoi creare un solo report per tenant per giorno di calendario.

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
}

Riferimento API Power Platform: Crea report di connessione tra tenant

Passaggio 3: Elenca tutti i report per il tenant

Utilizza il seguente script di PowerShell per elencare tutti i report disponibili per il tuo tenant.

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
}

Riferimento API Power Platform: Ottieni report di connessione tra tenant

Passaggio 4: Recupera un singolo report

Utilizza il seguente script di PowerShell per recuperare un singolo report per il tuo tenant sulle connessioni utilizzate all'interno del tenant.

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
}

Riferimento API Power Platform: Elenca report di connessione tra tenant

Vedi anche

Riferimento API di Power Platform: report di connessione tra tenant

Condividi tramite