Den här självstudien visar hur du använder programmeringsverktygen för att skapa isoleringsrapporter mellan klientorganisationer.
I den här självstudien får du lära dig att:
- Skapa en rapport
- Ange alla rapporter för klientorganisationen
- Hämta en enskild rapport
Skapa en rapport
Använd följande information för att hitta olika sätt på vilka du kan skapa en ny rapport.
Obs
Du kan endast skapa en rapport per klientorganisation per kalenderdag.
Lägg till en ny åtgärd på arbetsytan och sök efter "Skapa en begäran för att generera en anslutningsrapport mellan klientorganisationer för en klientorganisation eller returnera en befintlig rapport". Det krävs inga parametrar.
Använd följande PowerShell-skript för att skapa rapporten.
Import-Module "MSAL.PS"
$AuthResult = Get-MsalToken -ClientId '<client id of your Microsoft Entra ID application registration>' -Scope 'https://api.powerplatform.com/.default'
$Headers = @{Authorization = "Bearer $($AuthResult.AccessToken)"}
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 anslutningsrapport mellan klientorganisationer
Ange alla rapporter för klientorganisationen
Lägg till en ny åtgärd på arbetsytan och sök efter "Lista anslutningsrapporter mellan klientorganisationer för en klientorganisation". Det krävs inga parametrar.
Använd följande PowerShell-skript om du vill visa alla tillgängliga rapporter för klientorganisationen.
Import-Module "MSAL.PS"
$AuthResult = Get-MsalToken -ClientId '<client id of your Microsoft Entra ID application registration>' -Scope 'https://api.powerplatform.com/.default'
$Headers = @{Authorization = "Bearer $($AuthResult.AccessToken)"}
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 anslutningsrapport för flera klientorganisationer
Hämta en enskild rapport
Lägg till en ny åtgärd på arbetsytan och sök efter "Hämta en anslutningsrapport mellan klientorganisationer efter rapport-ID för en klientorganisation". Ange rapport-ID från tidigare steg.
Använd följande PowerShell-skript om du vill hämta en enskild rapport för klientorganisationen om anslutningar som används i klientorganisationen.
Import-Module "MSAL.PS"
$AuthResult = Get-MsalToken -ClientId '<client id of your Microsoft Entra ID application registration>' -Scope 'https://api.powerplatform.com/.default'
$Headers = @{Authorization = "Bearer $($AuthResult.AccessToken)"}
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: Lista anslutningsrapporter för flera klientorganisationer
Relaterat innehåll
Power Platform API-referens – Anslutningsrapporter mellan klientorganisationer