Vadnica: Ustvarjanje poročil o osamitvi med najemnikom

Ta vadnica prikazuje, kako uporabiti orodja za programljivost za ustvarjanje poročil o osamitvi med najemnikom.

V tej vadnici se naučite, kako:

  • Ustvarite poročilo
  • Navedite vsa poročila za najemnika
  • Pridobite eno poročilo
  • Iskanje okolja za sporočeno povezavo

Pomembno

Za več podrobnosti o izolaciji najemnikov glejte Omejitve dohodnih in izhodnih najemnikov.

Ustvarite poročilo

S temi informacijami lahko poiščete različne načine za ustvarjanje novega poročila.

opomba,

Ustvarite lahko samo eno poročilo na najemnika na koledarski dan.

Dodajte novo dejanje na platno in poiščite »Ustvarjanje zahteve za ustvarjanje poročila o povezavi med najemnikom za najemnika ali vrnitev obstoječega poročila«. Dejanje ne zahteva nobenih parametrov.

Posnetek zaslona za ustvarjanje poročila o povezavi med najemnikom.

Navedite vsa poročila za najemnika

Dodajte novo dejanje na platno in poiščite poročila o povezavi med najemnikom seznama za najemnika. Dejanje ne zahteva nobenih parametrov.

Navedi poročila o povezavi med najemnikom za posnetek zaslona najemnika.

Pridobite eno poročilo

Dodajte novo dejanje na platno in poiščite Pridobi poročilo o povezavi med najemnikom po ID-ju poročila za najemnika. Navedite ID poročila iz prejšnjih korakov.

Pridobite poročilo o povezavi med najemnikom po ID-ju poročila za posnetek zaslona najemnika.

Razumevanje, kaj poročilo vsebuje

Vsako dokončano poročilo vključuje matriko connections . Vsak vnos opisuje povezavo med najemnikom, ki je bila opažena med oknom poročanja, in vključuje:

  • tenantId: zunanji najemnik, ki ga doseže povezava.
  • connectionType: smer povezave (od najemnika outbound do zunanjega najemnika) ali inbound.
  • connectionId: identifikator povezave. Ta vrednost se ujema s povezavo name (zadnji segment ID-ja vira povezave) v okolju, kjer je povezava.

opomba,

Poročilo beleži poskuse povezave med najemnikom , ki so bili opaženi med oknom poročanja, ne le povezave, ki trenutno obstajajo. Ta vrsta povezave vključuje poskuse, ki jih je osamitev najemnika blokirala v najemniku ali ciljnem najemniku. Zato poročilo morda ne connectionId bo ustrezalo povezavi, ki danes obstaja v katerem koli vašem okolju. Blokiranih poskusov povezave (in povezav, ki so bile pozneje izbrisane) ni mogoče najti po navodilih v naslednjem razdelku.

Iskanje okolja za sporočeno povezavo

Poročilo identificira vsako povezavo po connectionId, vendar ne vključuje okolja, kjer je povezava. Če želite poiskati okolje, oštevilčite okolja v najemniku, navedite povezave posameznega okolja in se ujemajte s povezavo name.

Če želite v okoljih, ki so bila prijavljena, poiskati prijavljeno datoteko, uporabite ta skript ogrodja connectionIdPowerShell. Oštevilčite ID-je okolja, ki jih želite – na primer iz skrbniškega središča za Power Platform ali api-ja connectionId za okolja – in navedite vrednosti iz poročila.

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)"
    }
}

Če prijavljenega elementa connectionId ni mogoče najti v katerem koli okolju, je bil najverjetneje blokiran poskus (glejte prejšnjo opombo) ali povezava, ki je bila izbrisana po tem, ko je bilo poročilo ustvarjeno.

Sklic na API platforme Power Platform: Povezave seznama v okolju

Sorodna vsebina

Sklic na API platforme Power – poročila o povezavi med najemnikoma

Sklic na VMESNIK API za Power Platform – povezljivost

  • Last updated on