Del via


Selvstudium: Oprette tværgående lejerisolationsrapporter

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

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

  1. Godkend via Power Platform API
  2. Opret en rapport
  3. Vis alle rapporter for lejeren
  4. Hent en enkelt rapport

Vigtige oplysninger

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 rollen som Power Platform administrator Entra ID har tilladelse til at køre rapporten om lejerisolationspåvirkning.

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 - Forbindelsesrapport på tværs af lejere