Get-EntraContactDirectReport

Moduł:
Microsoft.Entra.DirectoryManagement Module v1.3

Pobierz bezpośrednie raporty dla kontaktu.

Składnia

Default (domyślnie) 

Get-EntraContactDirectReport

    -OrgContactId <String>
    [-All]
    [-Top <Int32>]
    [-Property <String[]>]
    [<CommonParameters>]

Opis

Polecenie Get-EntraContactDirectReport cmdlet pobiera bezpośrednie raporty dla kontaktu.

W przypadku scenariuszy delegowanych obejmujących konta służbowe zalogowany użytkownik musi mieć obsługiwaną rolę Microsoft Entra lub rolę niestandardową z wymaganymi uprawnieniami. Następujące najmniej uprzywilejowane role obsługują tę operację:

  • Czytelnicy katalogu: odczytywanie podstawowych właściwości
  • Globalny czytnik
  • Autorzy katalogów
  • Administrator usługi Intune
  • Administrator użytkowników

Przykłady

Przykład 1. Pobieranie bezpośrednich raportów kontaktu

Connect-Entra -Scopes 'OrgContact.Read.All'
$contact = Get-EntraContact -Filter "displayName eq 'Contoso Contact'"
Get-EntraContactDirectReport -OrgContactId $contact.Id

W tym przykładzie pokazano, jak pobierać bezpośrednie raporty dla kontaktu organizacyjnego.

Możesz użyć polecenia Get-EntraBetaContact , aby uzyskać kontakt organizacyjny.

  • -OrgContactId parametr określa identyfikator kontaktu.

Przykład 2. Pobieranie wszystkich bezpośrednich raportów kontaktu

Connect-Entra -Scopes 'OrgContact.Read.All'
$contact = Get-EntraContact -Filter "displayName eq 'Contoso Contact'"
Get-EntraContactDirectReport -OrgContactId $contact.Id -All

W tym przykładzie pokazano, jak pobrać wszystkie bezpośrednie raporty dla kontaktu organizacyjnego.

  • -OrgContactId parametr określa identyfikator kontaktu.

Przykład 3. Uzyskiwanie dwóch bezpośrednich raportów kontaktu

Connect-Entra -Scopes 'OrgContact.Read.All'
$contact = Get-EntraContact -Filter "displayName eq 'Contoso Contact'"
Get-EntraContactDirectReport -OrgContactId $contact.Id -Top 2

W tym przykładzie pokazano, jak pobrać dwa pierwsze bezpośrednie raporty dla kontaktu organizacyjnego. Możesz użyć -Limit jako aliasu dla -Top.

  • -OrgContactId parametr określa identyfikator kontaktu.

Parametry

-All

Wyświetl listę wszystkich stron.

Właściwości parametru

Typ:System.Management.Automation.SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-OrgContactId

Określa identyfikator kontaktu w Microsoft Entra ID.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Identyfikator Obiektu

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Property

Określa właściwości, które mają być zwracane.

Właściwości parametru

Typ:

System.String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Select

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Top

Określa maksymalną liczbę rekordów do zwrócenia.

Właściwości parametru

Typ:System.Int32
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Ograniczenie

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.