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

  • Članek

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

Ta vadnica prikazuje, kako uporabiti Power Platform API (predogled) za ustvarjanje poročil o izolaciji med najemniki.

V tej vadnici se naučite, kako:

  1. Preverjanje pristnosti z Power Platform API
  2. Ustvarite poročilo
  3. Navedite vsa poročila za najemnika
  4. 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 tem obdobju predogleda funkcije.
  • Za več podrobnosti o izolaciji najemnikov glejte Omejitve dohodnih in izhodnih najemnikov.

1. korak: Preverjanje pristnosti z Power Platform API

Za preverjanje pristnosti z Power Platform API-jem uporabite naslednji skript PowerShell.

opomba,

Samo uporabniki z vlogama globalnega skrbnika in Power Platform skrbnika Entra ID imajo dovoljenje za zagon poročila o vplivu izolacije 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 - Poročila o povezavah navzkrižnih najemnikov