이 자습서에서는 프로그래밍 기능 도구를 사용하여 테넌트 간 격리 보고서를 만드는 방법을 보여 줍니다.
이 자습서에서는 다음 작업을 수행하는 방법을 알아봅니다.
- 보고서 만들기
- 테넌트에 대한 모든 보고서 나열
- 단일 보고서 가져오기
보고서 만들기
다음 정보를 사용하여 새 보고서를 만들 수 있는 다양한 방법을 찾을 수 있습니다.
참고
달력일 기준으로 테넌트당 하나의 보고서만 만들 수 있습니다.
캔버스에 새 작업을 추가하여 "테넌트에 대한 테넌트 간 연결 보고서를 생성하거나 기존 보고서를 반환하는 요청 만들기"를 검색합니다. 매개 변수가 필요하지 않습니다.
보고서를 만들려면 다음 PowerShell 스크립트를 사용하십시오.
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 참조: 테넌트 간 연결 보고서 만들기
테넌트에 대한 모든 보고서 나열
캔버스에 새 작업을 추가하여 "테넌트에 대한 테넌트 간 연결 보고서 나열"을 검색합니다. 매개 변수가 필요하지 않습니다.
다음 PowerShell 스크립트를 사용하여 테넌트에 대해 사용 가능한 모든 보고서를 나열합니다.
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 참조: 테넌트 간 연결 보고서 가져오기
단일 보고서 가져오기
캔버스에 새 작업을 추가하여 "테넌트에 대한 보고서 ID로 테넌트 간 연결 보고서 가져오기"를 검색합니다. 이전 단계의 보고서 ID를 제공합니다.
다음 PowerShell 스크립트를 사용하여 테넌트 내에서 사용되는 연결에 대한 테넌트에 대한 단일 보고서를 가져옵니다.
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 참조: 테넌트 간 연결 보고서 나열
관련 콘텐츠
Power Platform API 참조 - 테넌트 간 연결 보고서