Vadnica: Ustvarjanje poročil navzkrižni osamitvi najemnika (predogledna različica)

Članek
07/30/2024

[Ta članek je del predizdajne dokumentacije in se lahko spremeni.]

Ta vadnica prikazuje, kako uporabiti Power Platform API (predogledna različica) za ustvarjanje navzkrižnih osamitev najemnika poročil.

V tej vadnici se naučite, kako:

Preverjanje pristnosti z Power Platform API
Ustvarite poročilo
Navedite vsa poročila za najemnika
Pridobite eno poročilo

Pomembno

To je funkcija predogleda.
Poskusne funkcije niso za komercialno uporabo, njihovo delovanje je lahko omejeno. Te funkcije so na voljo še pred uradno izdajo, da lahko stranke predčasno dostopajo do njih in posredujejo povratne informacije.
Ime gostitelja in podatkovne pogodbe se lahko spremenijo v obdobju te funkcije predogledna različica.
Za več podrobnosti o osamitev najemnika glejte Omejitve dohodnih in odhodnih najemnikov.

1. korak: Preverjanje pristnosti z Power Platform API

Uporabite naslednji skript PowerShell za preverjanje pristnosti z Power Platform API.

opomba,

Uporabniki z vlogo Power Platform skrbnika Entra ID imajo dovoljenje za izvajanje poročila o vplivu osamitev najemnika.

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

2. korak. Ustvarite poročilo

Za ustvarjanje poročila uporabite naslednji skript PowerShell.

opomba,

Ustvarite lahko samo eno poročilo na najemnika na koledarski dan.

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 Referenca API-ja: Ustvari poročilo o povezavi med najemniki

3. korak. Navedite vsa poročila za najemnika

Uporabite naslednji skript PowerShell za seznam vseh razpoložljivih poročil za vašega najemnika.

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 Referenca API-ja: Pridobite poročilo o povezavi med najemniki

4. korak. Pridobite eno poročilo

Uporabite naslednji skript PowerShell, da za svojega najemnika pridobite eno poročilo o povezavah, uporabljenih znotraj najemnika.

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 Referenca API-ja: Seznam poročil o povezavah med najemniki

Glejte tudi

Power Platform Referenca API-ja - Poročila o povezavah med najemniki

Deli z drugimi prek