Opplæring: Opprett rapporter om kryssleierisolasjon (forhåndsversjon)

Artikkel
10/24/2023

[Denne artikkelen inneholder dokumentasjon for forhåndsversjonen og kan bli endret.]

Denne veiledningen viser hvordan du bruker Power Platform API (forhåndsvisning) til å opprette rapporter om kryssleierisolasjon.

I denne opplæringen lærer du hvordan du kan gjøre følgende:

Godkjenning med Power Platform API
Opprette en rapport
Vis alle rapporter for leieren
Hente én enkelt rapport

Viktig

Dette er en forhåndsversjonsfunksjon.
Evalueringsfunksjonalitet er ikke ment for produksjonsbruk og kan ha begrensninger. Disse funksjonene er tilgjengelige før en offisiell utgivelse, slik at kunder kan få tidlig tilgang og gi tilbakemelding.
Vertsnavnet og datakontraktene kan bli endret i løpet av denne forhåndsvisningsperioden for funksjonen.
Hvis du vil ha mer informasjon om leierisolasjon, kan du se Innkommende og utgående begrensninger på tvers av leier.

Trinn 1. Godkjenn med Power Platform API

Bruk følgende PowerShell-skript til å godkjenne med Power Platform API.

Merk

Bare brukere med Entra ID-rollene global administrator og Power Platform-administrator har tillatelse til å kjøre rapporten om innvirkningen til leierisolasjon.

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

Trinn 2. Opprette en rapport

Bruk følgende PowerShell-skript til å opprette rapporten.

Merk

Du kan bare opprette én rapport per leier per 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-referanse: Opprette rapport om tilkobling på tvers av leier

Trinn 3. Vis alle rapporter for leieren

Bruk følgende PowerShell-skript nedenfor til å vise alle tilgjengelige rapporter for leieren.

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-referanse: Få rapport om tilkobling på tvers av leier

Trinn 4. Hente én enkelt rapport

Bruk PowerShell-skriptet nedenfor til å hente én enkelt rapport for leieren om tilkoblinger som brukes i leieren.

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-referanse: Vis rapporter om tilkobling på tvers av leier

Se også

Power Platform API-referanse - Rapporter om tilkobling på tvers av leier

Del via