Tutorial: Crear informes de aislamiento entre inquilinos

Artículo
02/12/2025

Este tutorial muestra cómo usar la Power Platform API para crear informes de aislamiento entre inquilinos.

En este tutorial, aprenderá a:

Autenticar usando Power Platform API
Crear un informe
Mostrar todos los informes del inquilino
Obtener un único informe

Importante

Para obtener más detalles sobre el aislamiento de inquilinos, consulte Restricciones de entrada y salida entre inquilinos.

Paso 1. Autenticar usando la API Power Platform

Utilice el siguiente script de PowerShell para autenticarse mediante la API Power Platform.

Nota

Los usuarios con el rol de administrador de Entra ID en Power Platform tienen permiso para ejecutar el informe de impacto del aislamiento de inquilinos.

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

Paso 2. Crear un informe

Utilice el siguiente script de PowerShell para crear el informe.

Nota

Solo puede crear un informe por inquilino por día 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
}

Power Platform Referencia de API: Crear informe de conexión entre inquilinos

Paso 3. Mostrar todos los informes del inquilino

Utilice el siguiente script de PowerShell para enumerar todos los informes disponibles para su inquilino.

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
}

Referencia de la API de Power Platform: Obtener informe de conexión entre inquilinos

Paso 4. Obtener un único informe

Utilice el siguiente script de PowerShell para obtener un informe único para su inquilino sobre las conexiones utilizadas dentro del inquilino.

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
}

Referencia de la API de Power Platform: Mostrar informes de conexión entre inquilinos

Consultar también

Referencia de la API de Power Platform: informes de conexión entre inquilinos

Compartir vía