Selvstudium: Oprettelse af isolerede rapporter på tværs af lejere (forhåndsversion)

Artikel
10/16/2024

[Denne artikel er dokumentation til den foreløbige udgivelse. Der kan forekomme ændringer.]

Dette selvstudium viser, hvordan du bruger Power Platform API'en (forhåndsversion) til at oprette isolationsrapporter på tværs af lejere.

I dette selvstudium lærer du, hvordan du kan:

Godkend ved hjælp af Power Platform API
Opret en rapport
Vis alle rapporter for lejeren
Hent en enkelt rapport

Vigtigt

Dette er en forhåndsversion af funktionen.
Forhåndsversionsfunktionerne er ikke beregnet til produktionsformål og kan have begrænset funktionalitet. Disse funktioner er tilgængelige før en officiel udgivelse, så kunderne kan få tidlig adgang og give feedback.
Værtsnavnet og datakontrakterne kan blive ændret i løbet af eksempelperioden for denne funktion.
Du kan finde flere oplysninger om isolation af lejere i indgående og udgående begrænsninger på tværs af lejere.

Trin 1. Godkend via Power Platform API

Brug følgende PowerShell-script til at godkende Power Platform API.

Bemærk

Brugere med Power Platform rollen administrator-id har tilladelse til at køre rapporten om påvirkning af lejerisolation.

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

Trin 2. Opret en rapport

Brug følgende PowerShell-script til at oprette rapporten.

Bemærk!

Du kan kun oprette én rapport pr. lejer pr. kalenderdag.

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-reference: Rapporten Opret forbindelse på tværs af lejere

Trin 3. Vis alle rapporter for lejeren

Brug følgende PowerShell-script til at få vist en liste over alle tilgængelige rapporter for lejeren.

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-reference: Hent Rapporten Opret forbindelse på tværs af lejere

Trin 4. Hent en enkelt rapport

Brug følgende PowerShell-script til at hente en enkelt rapport til lejeren om de forbindelser, der bruges i lejeren.

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-reference: Opfør Rapporterne Opret forbindelse på tværs af lejere

Se også

Power Platform API-reference – Forbindelsesrapporter på tværs af lejere

Del via