다음을 통해 공유

자습서: 테넌트 간 격리 보고서 만들기(프리뷰)

  • 아티클

[이 문서는 시험판 문서이며 변경될 수 있습니다.]

이 자습서에서는 Power Platform API(프리뷰)를 사용하여 테넌트 간 격리 보고서를 만드는 방법을 보여줍니다.

이 자습서에서는 다음 작업을 수행하는 방법을 알아봅니다.

  1. Power Platform API를 사용하여 인증
  2. 보고서 만들기
  3. 세입자에 대한 모든 보고서를 나열합니다.
  4. 단일 보고서 가져오기

중요

  • 이는 프리뷰 기능입니다.
  • 프리뷰 기능은 생산용으로 만들어진 것이 아니므로 기능이 제한될 수 있습니다. 이런 기능은 공식 릴리스 전에 사용할 수 있으므로 고객이 조기에 액세스하고 피드백을 제공할 수 있습니다.
  • 이 기능 프리뷰 기간 동안 호스트 이름과 데이터 계약이 변경될 수 있습니다.
  • 테넌트 격리에 대한 자세한 내용은 테넌트 간 인바운드 및 아웃바운드 제한 사항을 참조하세요.

1단계. Power Platform API를 사용하여 인증

Power Platform API를 사용하여 인증하려면 다음 PowerShell 스크립트를 사용하세요.

참고

Power Platform 관리자 Entra ID 역할을 가진 사용자는 테넌트 격리 영향 보고서를 실행할 수 있는 권한이 있습니다.

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단계. 보고서 만들기

보고서를 만들려면 다음 PowerShell 스크립트를 사용하십시오.

노트

달력일 기준으로 테넌트당 하나의 보고서만 만들 수 있습니다.

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 참조: 테넌트 간 연결 보고서 만들기

3단계. 테넌트에 대한 모든 보고서 나열

다음 PowerShell 스크립트를 사용하여 테넌트에 대해 사용 가능한 모든 보고서를 나열합니다.

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 참조: 테넌트 간 연결 보고서 가져오기

4단계. 단일 보고서 가져오기

다음 PowerShell 스크립트를 사용하여 테넌트 내에서 사용되는 연결에 대한 테넌트에 대한 단일 보고서를 가져옵니다.

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 참조 - 크로스 테넌트 연결 보고서