Get-EntraContactDirectReport

Modul:
Microsoft.Entra.DirectoryManagement Module v1.3

Rufen Sie die direkten Berichte für einen Kontakt ab.

Syntax

Default (Standard) 

Get-EntraContactDirectReport

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

Beschreibung

Das Get-EntraContactDirectReport Cmdlet ruft die direkten Berichte für einen Kontakt ab.

Für delegierte Szenarien mit Geschäfts-, Schul- oder Unikonten muss der angemeldete Benutzer über eine unterstützte Microsoft Entra Rolle oder eine benutzerdefinierte Rolle mit den erforderlichen Berechtigungen verfügen. Die folgenden am wenigsten privilegierten Rollen unterstützen diesen Vorgang:

  • Verzeichnisleser: Grundlegende Eigenschaften lesen
  • Globaler Leser
  • Verzeichnisautoren
  • Intune-Administrator
  • Benutzeradministrator

Beispiele

Beispiel 1: Abrufen der direkten Berichte eines Kontakts

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

In diesem Beispiel wird gezeigt, wie Direkte Berichte für einen Organisationskontakt abgerufen werden.

Sie können den Befehl Get-EntraBetaContact verwenden, um den Organisationskontakt abzurufen.

  • -OrgContactId der Parameter gibt die Kontakt-ID an.

Beispiel 2: Abrufen aller direkten Berichte eines Kontakts

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

In diesem Beispiel wird gezeigt, wie alle direkten Berichte für einen Organisationskontakt abgerufen werden.

  • -OrgContactId der Parameter gibt die Kontakt-ID an.

Beispiel 3: Abrufen der beiden wichtigsten direkten Berichte eines Kontakts

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

In diesem Beispiel wird gezeigt, wie sie die beiden wichtigsten direkten Berichte für einen Organisationskontakt abrufen. Sie können -Limit als Alias für -Top verwenden.

  • -OrgContactId der Parameter gibt die Kontakt-ID an.

Parameter

-All

Alle Seiten auflisten.

Parametereigenschaften

Typ:System.Management.Automation.SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OrgContactId

Gibt die ID eines Kontakts in Microsoft Entra ID an.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Objekt-ID

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Property

Gibt eigenschaften an, die zurückgegeben werden sollen.

Parametereigenschaften

Typ:

System.String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Select

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Top

Gibt die maximale Anzahl der zurückzugebenden Datensätze an.

Parametereigenschaften

Typ:System.Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Begrenzung

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.