Självstudier: Skapa isoleringsrapporter för flera klientorganisationer (förhandsgranskning)

Artikel
10/16/2024

[Den här artikeln är en förhandsversion av dokumentationen och kan komma att ändras.]

Denna självstudie visar hur du använder Power Platform API (förhandsgranskning) för att skapa isoleringsrapporter för flera klientorganisationer.

I den här självstudien får du lära dig att:

Autentisera med hjälp av Power Platform API
Skapa en rapport
Visa en lista över alla rapporter för klientorganisationen
Hämta en enskild rapport

Viktigt!

Detta är en förhandsversion.
Förhandsversion ska inte användas i produktion, och funktionerna kan vara begränsade. funktionerna är tillgängliga före den officiella publiceringen så att kunderna kan få tillgång tidigare och ge oss feedback.
Värdnamnet och datakontrakten kan ändras under den här förhandsgranskningsperioden för funktionen.
Mer information om isolering av klientorganisation finns i Begränsningar för klientorganisation för flera klientorganisationer.

Steg 1. Autentisera med hjälp av Power Platform API

Använd följande PowerShell-skript för att autentisera med Power Platform API.

Obs

Användare med Power Platform rollen Administratör Entra-ID har behörighet att köra rapporten isolering av klientorganisation.

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

Steg 2. Skapa en rapport

Använd följande PowerShell-skript för att skapa rapporten.

Anteckning

Du kan endast skapa en rapport per klientorganisation 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-referens: Skapa anslutning för flera klientorganisation

Steg 3. Ange alla rapporter för klientorganisationen

Använd följande PowerShell-skript om du vill visa alla tillgängliga rapporter för klientorganisationen.

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-referens: Hämta anslutning för flera klientorganisation

Steg 4. Hämta en enskild rapport

Använd följande PowerShell-skript om du vill hämta en enskild rapport för klientorganisationen om anslutningar som används i klientorganisationen.

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-referens: Ange rapporter anslutning för flera klientorganisation

Se även

Power Platform API-referens – Anslutningsrapporter mellan klientorganisationer

Dela via