Εκπαιδευτικό βοήθημα: Δημιουργία αναφορών απομόνωσης μεταξύ μισθωτή (έκδοση προεπισκόπησης)

Άρθρο
07/23/2024

[Αυτό το άρθρο αποτελεί τεκμηρίωση προέκδοσης και ενδέχεται να αλλάξει.]

Αυτό το εκπαιδευτικό βοήθημα δείχνει πώς να χρησιμοποιείτε το Power Platform API (έκδοση προεπισκόπησης) για να δημιουργείτε αναφορές απομόνωσης μισθωτή.

Σε αυτό το εκπαιδευτικό βοήθημα, μάθετε πώς μπορείτε να κάνετε τα εξής:

Έλεγχος ταυτότητας με χρήση Power Platform API
Δημιουργία αναφοράς
Λίστα όλων των αναφορών για τον μισθωτή
Λήψη μεμονωμένης αναφοράς

Σημαντικό

Αυτή είναι μια δυνατότητα προεπισκόπησης.
Οι δυνατότητες προεπισκόπησης δεν προορίζονται για χρήση παραγωγής και ενδέχεται να έχουν περιορισμένη λειτουργικότητα. Αυτές οι δυνατότητες είναι διαθέσιμες πριν από μια επίσημη κυκλοφορία έτσι ώστε οι πελάτες να έχουν πρόσβαση από νωρίς και να κάνουν σχόλια.
Το όνομα κεντρικού υπολογιστή και οι συμβάσεις δεδομένων ενδέχεται να αλλάξουν κατά τη διάρκεια αυτής της περιόδου έκδοσης προεπισκόπησης της δυνατότητας.
Για περισσότερες πληροφορίες σχετικά με την απομόνωση μισθωτή, ανατρέξτε στο θέμαΠεριορισμοί εισερχομένων και εξερχόμενων μεταξύ μισθωτών.

Βήμα 1. Έλεγχος ταυτότητας με χρήση Power Platform API

Χρησιμοποιήστε την παρακάτω δέσμη ενεργειών PowerShell για να ελέγξετε την ταυτότητα χρησιμοπιώντας Power Platform API.

Σημείωμα

Οι χρήστες με ρόλο Διαχειριστής 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 - Αναφορές σύνδεσης μεταξύ μισθωτών

Κοινή χρήση μέσω