Tutorial: Cipta laporan pengasingan merentas penyewa

Tutorial ini menunjukkan cara menggunakan alat kebolehaturcaraan untuk mencipta laporan pengasingan merentas penyewa.

Dalam tutorial ini, ketahui cara:

• Buat laporan
• Senaraikan semua laporan untuk penyewa
• Ambil laporan tunggal

Penting

Untuk butiran lanjut tentang pengasingan penyewa, lihat Sekatan masuk dan keluar merentas penyewa.

Buat laporan

Gunakan maklumat berikut untuk mencari pelbagai cara anda boleh mencipta laporan baharu.

Nota

Anda hanya boleh membuat satu laporan bagi setiap penyewa setiap hari kalendar.

Power Automate / Aplikasi Logik

Tambah tindakan baharu pada kanvas, mencari "Cipta permintaan untuk menjana laporan sambungan merentas penyewa untuk penyewa atau mengembalikan laporan sedia ada". Tiada parameter diperlukan.

Powershell

Gunakan skrip PowerShell berikut untuk mencipta laporan.

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
}

Rujukan API Power Platform: Cipta Laporan Sambungan Rentas Penyewa

Senaraikan semua laporan untuk penyewa

Power Automate / Aplikasi Logik

Tambah tindakan baharu pada kanvas, mencari "Senaraikan laporan sambungan merentas penyewa untuk penyewa". Tiada parameter diperlukan.

Powershell

Gunakan skrip PowerShell berikut untuk menyenaraikan semua laporan yang tersedia untuk penyewa anda.

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
}

Rujukan API Power Platform: Dapatkan Laporan Sambungan Merentas Penyewa

Ambil laporan tunggal

Power Automate / Aplikasi Logik

Tambah tindakan baharu pada kanvas, mencari "Dapatkan laporan sambungan merentas penyewa mengikut ID laporan untuk penyewa". Berikan ID laporan daripada langkah terdahulu.

Powershell

Gunakan skrip PowerShell berikut untuk mengambil satu laporan untuk penyewa anda tentang sambungan yang digunakan dalam penyewa.

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
}

Rujukan API Power Platform: Senaraikan Laporan Sambungan Merentas Penyewa

Kandungan berkaitan

Rujukan API Power Platform - Laporan Sambungan Rentas Penyewa