บทช่วยสอน: สร้างรายงานการแยกข้ามผู้เช่า

บทช่วยสอนนี้สาธิตวิธีการใช้เครื่องมือการเขียนโปรแกรมเพื่อสร้างรายงานการแยกข้ามผู้เช่า

ในบทช่วยสอนนี้ เรียนรู้วิธีการ:

สร้างรายงาน
รายการรายงานทั้งหมดสำหรับผู้เช่า
ดึงรายงานเดียว
ค้นหาสภาพแวดล้อมสําหรับการเชื่อมต่อที่รายงาน

สำคัญ

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการแยกผู้เช่า โปรดดู ข้อจำกัดขาเข้าและขาออกระหว่างผู้เช่า

สร้างรายงาน

ใช้ข้อมูลต่อไปนี้เพื่อค้นหาวิธีต่าง ๆ ที่คุณสามารถสร้างรายงานใหม่ได้

หมายเหตุ

คุณสามารถสร้างได้หนึ่งรายงานต่อผู้เช่าต่อวันปฏิทินเท่านั้น

Power Automate / Logic Apps
PowerShell

เพิ่มการดําเนินการใหม่ไปยังพื้นที่ทํางาน ค้นหา "สร้างคําขอเพื่อสร้างรายงานการเชื่อมต่อข้ามผู้เช่าสําหรับผู้เช่า หรือส่งกลับรายงานที่มีอยู่" การดําเนินการไม่จําเป็นต้องใช้พารามิเตอร์ใดๆ

สกรีนช็อตสร้างรายงานการเชื่อมต่อข้ามผู้เช่า

ใช้สคริป 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: รายการรายงานการเชื่อมต่อข้ามผู้เช่า

ดึงรายงานเดียว

Power Automate / Logic Apps
PowerShell

เพิ่มการดําเนินการใหม่ลงในพื้นที่ทํางาน และค้นหา รับรายงานการเชื่อมต่อข้ามผู้เช่าตาม ID รายงานสําหรับผู้เช่า ระบุ 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: รับรายงานการเชื่อมต่อข้ามผู้เช่า

ทําความเข้าใจสิ่งที่รายงานประกอบด้วย

รายงานที่เสร็จสมบูรณ์แต่ละรายงานประกอบด้วย connections อาร์เรย์ รายการทั้งหมดจะอธิบายการเชื่อมต่อข้ามผู้เช่าที่เกิดขึ้นในหน้าต่างการรายงานและรวมถึง:

tenantId: ผู้เช่าภายนอกที่มีการเชื่อมต่อถึง
connectionType: ทิศทางของการเชื่อมต่อ อย่างใดอย่างหนึ่ง outbound (จากผู้เช่าของคุณไปยังผู้เช่าภายนอก) หรือinbound
connectionId: ตัวระบุของการเชื่อมต่อ ค่านี้ตรงกับของการเชื่อมต่อ name (เซกเมนต์สุดท้ายของ ID ทรัพยากรของการเชื่อมต่อ) ในสภาพแวดล้อมที่การเชื่อมต่ออยู่

หมายเหตุ

บันทึกรายงานจะ พยายาม เชื่อมต่อข้ามผู้เช่าในระหว่างหน้าต่างการรายงาน ไม่ใช่เฉพาะการเชื่อมต่อที่มีอยู่ในขณะนี้เท่านั้น ชนิดการเชื่อมต่อนี้รวมถึงความพยายาม ที่ถูกบล็อกโดยการแยกผู้เช่า บนผู้เช่าของคุณหรือในผู้เช่าเป้าหมาย connectionIdด้วยเหตุนี้ ในรายงานอาจไม่สอดคล้องกับการเชื่อมต่อที่มีอยู่ในสภาพแวดล้อมของคุณในปัจจุบัน คุณไม่สามารถค้นหาความพยายามในการเชื่อมต่อที่ถูกบล็อก (และการเชื่อมต่อที่ถูกลบในภายหลัง) โดยใช้ขั้นตอนในส่วนถัดไป

ค้นหาสภาพแวดล้อมสําหรับการเชื่อมต่อที่รายงาน

รายงานระบุการเชื่อมต่อแต่ละรายการตาม connectionIdแต่ไม่มีสภาพแวดล้อมที่การเชื่อมต่ออยู่ เมื่อต้องการค้นหาสภาพแวดล้อม ให้ระบุสภาพแวดล้อมในผู้เช่าของคุณ ระบุรายการการเชื่อมต่อของแต่ละสภาพแวดล้อม และจับคู่กับการเชื่อมต่อname

ใช้สคริปต์ PowerShell ต่อไปนี้เพื่อค้นหาสภาพแวดล้อมของคุณสําหรับรายงานconnectionId ระบุรหัสสภาพแวดล้อมของคุณอย่างไรก็ตามที่คุณต้องการ เช่น จาก ศูนย์การจัดการ Power Platform หรือ API ของสภาพแวดล้อม และให้ connectionId ค่าจากรายงาน

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 = "******"}

# The connectionId values from the report you fetched in the previous step.
$reportConnectionIds = @('<connectionId-1>', '<connectionId-2>')

# The environments in your tenant to search.
$environmentIds = @('<environment-id-1>', '<environment-id-2>')

foreach ($environmentId in $environmentIds)
{
    try
    {
        # List the connections in the environment.
        $uri = "https://api.powerplatform.com/connectivity/environments/$environmentId/connections?api-version=2024-10-01"
        $connections = (Invoke-RestMethod -Method Get -Uri $uri -Headers $Headers).value

        foreach ($connectionId in $reportConnectionIds)
        {
            # The report's connectionId matches the connection's 'name'.
            $match = $connections | Where-Object { $_.name -eq $connectionId }
            if ($match)
            {
                Write-Host "connectionId $connectionId is in environment $environmentId (connector: $($match.properties.apiId), display name: $($match.properties.displayName))"
            }
        }
    }
    catch
    {
        Write-Host "Could not list connections for environment ${environmentId}: $($_.Exception.Message)"
    }
}

ถ้าไม่พบรายงาน connectionId ในสภาพแวดล้อมใด ๆ อาจเป็นความพยายามที่ถูกบล็อก (ดูหมายเหตุก่อนหน้า) หรือการเชื่อมต่อที่ถูกลบหลังจากสร้างรายงาน

การอ้างอิง Power Platform API: เชื่อมต่อรายการในสภาพแวดล้อม

การอ้างอิง Power Platform API - รายงานการเชื่อมต่อข้ามผู้เช่า

การอ้างอิง Power Platform API - การเชื่อมต่อ

คำติชม

หน้านี้มีประโยชน์หรือไม่

อัปเดตล่าสุดเมื่อ 2026-08-13