Öğretici: Kiracılar arası yalıtım raporları oluşturma (önizleme)

Makale
07/26/2024

[Bu makale, yayın öncesi belgelerine dahildir ve değiştirilebilir.]

Bu öğreticide, kiracılar arası yalıtım raporları (önizleme) oluşturmak için Power Platform API'sini (önizleme) kullanma gösterilmektedir.

Bu öğreticide aşağıdakilerin nasıl yapılacağını öğreneceksiniz:

API kullanarak Power Platform kimlik doğrulama
Rapor oluşturma
Kiracı için tüm raporları listeleme
Tek bir rapor getirme

Önemli

Bu, bir önizleme özelliğidir.
Önizleme özellikleri, üretimde kullanıma yönelik değildir ve sınırlı işlevselliğe sahip olabilir. Bu özellikler, müşterilerin erken erişim elde etmesi ve geri bildirim sağlaması amacıyla resmi sürümden önce kullanıma sunulur.
Ana bilgisayar adı ve veri sözleşmeleri bu özellik önizleme döneminde değişebilir.
Kiracı yalıtımı hakkında daha ayrıntılı bilgi için bkz. Kiracılar arası gelen ve giden kısıtlamalar.

1. Adım. Power Platform API'sini kullanarak kimlik doğrulama

Power Platform API'sini kullanarak kimlik doğrulaması yapmak için aşağıdaki PowerShell betiğini kullanın.

Not

Yönetici Entra Kimliği rolüne sahip Power Platform kullanıcılar, kiracı yalıtımı etki raporunu çalıştırma iznine sahiptir.

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. Adım. Rapor oluşturma

Raporu oluşturmak için aşağıdaki PowerShell betiğini kullanın.

Not

Her takvim günü için kiracı başına yalnızca bir rapor oluşturabilirsiniz.

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 başvurusu: Kiracılar Arası Bağlantı Raporu Oluşturma

3. Adım. Kiracı için tüm raporları listeleme

Kiracınıza yönelik kullanılabilir tüm raporları listelemek için aşağıdaki PowerShell betiğini kullanın.

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 başvurusu: Kiracılar Arası Bağlantı Raporu Alma

4. Adım. Tek bir rapor getirme

Kiracınız için kiracı içinde kullanılan bağlantılar hakkında tek bir rapor almak için aşağıdaki PowerShell betiğini kullanın.

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 başvurusu: Kiracılar Arası Bağlantı Raporlarını Listeleme

Ayrıca bkz.

Power Platform API başvurusu - Kiracılar Arası Bağlantı Raporları

Aracılığıyla paylaş