Zelfstudie: Isolatierapporten voor meerdere tenants maken (preview)

Artikel
10/16/2024

[Dit artikel maakt deel uit van de voorlopige documentatie en kan nog veranderen.]

Deze zelfstudie laat het gebruik zien van de Power Platform API (preview) om isolatierapporten voor meerdere tenants te maken.

In deze zelfstudie leert u het volgende:

Authenticeren met behulp van Power Platform API
Een rapport maken
Maak een lijst van alle rapporten voor de huurder
Eén enkel rapport ophalen

Belangrijk

Dit is een preview-functie.
Preview-functies zijn niet bedoeld voor productiegebruik en bieden mogelijk beperkte functionaliteit. Deze functies zijn beschikbaar vóór een officiële release zodat klanten vroeg toegang kunnen krijgen en feedback kunnen geven.
De hostnaam en de datacontracten kunnen tijdens deze preview-periode van de functie veranderen.
Zie Beperkingen voor inkomend en uitgaand verkeer tussen tenants voor meer informatie over het isoleren van tenants.

Stap 1. Verifiëren met Power Platform API

Gebruik het volgende PowerShell-script om te verifiëren met behulp van de Power Platform API:

Notitie

Gebruikers met de Entra ID-rol Beheerder hebben toestemming om het impactrapport tenantisolatie uit te voeren. Power Platform

Import-Module "MSAL.PS"
$AuthResult = Get-MsalToken -ClientId '00001111-aaaa-2222-bbbb-3333cccc4444' -Scope 'https://api.powerplatform.com/.default'
$Headers = @{Authorization = "Bearer $($AuthResult.AccessToken)"}

Stap 2. Een rapport maken

Gebruik het volgende PowerShell-script om het rapport te maken.

Opmerking

Per tenant kunt u slechts één rapport per kalenderdag maken.

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-referentie: Een rapport over meerdere tenantverbindingen maken

Stap 3. Een lijst maken van alle rapporten voor de tenant

Gebruik het volgende PowerShell-script om alle beschikbare rapporten voor uw tenant weer te geven.

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-referentie: Een rapport over meerdere tenantverbindingen ophalen

Stap 4. Een enkel rapport ophalen

Gebruik het volgende PowerShell-script om een enkel rapport voor uw tenant op te halen over verbindingen die binnen de tenant worden gebruikt.

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-referentie: Rapporten over meerdere tenantverbindingen vermelden

Zie ook

Power Platform API-referentie - Cross Tenant Connection-rapporten

Delen via