Esercitazione: Creare report di isolamento tra tenant

Questa esercitazione illustra come usare gli strumenti di programmabilità per creare report di isolamento tra tenant.

In questa esercitazione, scopri come:

• 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.

Creazione di un report

Usare le informazioni seguenti per trovare vari modi in cui è possibile creare un nuovo report.

Nota

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

Power Automate/App per la logica

Aggiungere una nuova azione all'area di disegno, cercare "Creare una richiesta per generare un report di connessione tra tenant per un tenant o restituire un report esistente". Non sono necessari parametri.

PowerShell

Utilizza il seguente script PowerShell per creare il report.

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
}

Informazioni di riferimento sull'API Power Platform: Creare un report di connessione tra tenant

Elenca tutti i report per il tenant

Power Automate/App per la logica

Aggiungere una nuova azione all'area di disegno, cercando "Elencare i report di connessione tra tenant per un tenant". Non sono necessari parametri.

PowerShell

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

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
}

Informazioni di riferimento sull'API Power Platform: Ottenere un report di connessione tra tenant

Recupera un singolo report

Power Automate/App per la logica

Aggiungere una nuova azione all'area di disegno, cercando "Ottenere un report di connessione tra tenant in base all'ID report per un tenant". Specificare l'ID del report dai passaggi precedenti.

PowerShell

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

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
}

Informazioni di riferimento sulle API di Power Platform: Elencare i report di connessione tra tenant

Contenuti correlati

Informazioni di riferimento sulle API di Power Platform - Report di connessione tra tenant