Get-EntraContactDirectReport

Module:
Microsoft.Entra.DirectoryManagement Module v1.3

Obtenez les rapports directs pour un contact.

Syntaxe

Default (Par défaut) 

Get-EntraContactDirectReport

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

Description

L’applet Get-EntraContactDirectReport de commande obtient les rapports directs pour un contact.

Pour les scénarios délégués impliquant des comptes professionnels ou scolaires, l’utilisateur connecté doit disposer d’un rôle Microsoft Entra pris en charge ou d’un rôle personnalisé avec les autorisations requises. Les rôles les moins privilégiés suivants prennent en charge cette opération :

  • Lecteurs d’annuaire : Lire les propriétés de base
  • Lecteur global
  • Rédacteurs d'annuaires
  • Administrateur Intune
  • Administrateur d’utilisateurs

Exemples

Exemple 1 : Obtenir les rapports directs d’un contact

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

Cet exemple montre comment récupérer des rapports directs pour un contact organisationnel.

Vous pouvez utiliser la commande Get-EntraBetaContact pour obtenir le contact de l’organisation.

  • -OrgContactId spécifie l’ID de contact.

Exemple 2 : Obtenir tous les rapports directs d’un contact

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

Cet exemple montre comment récupérer tous les rapports directs d’un contact professionnel.

  • -OrgContactId spécifie l’ID de contact.

Exemple 3 : Obtenir les deux principaux rapports directs d’un contact

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

Cet exemple montre comment récupérer les deux principaux rapports directs pour un contact organisationnel. Vous pouvez utiliser -Limit comme alias pour -Top.

  • -OrgContactId spécifie l’ID de contact.

Paramètres

-All

Répertorier toutes les pages.

Propriétés du paramètre

Type:System.Management.Automation.SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-OrgContactId

Spécifie l’ID d’un contact dans Microsoft Entra ID.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Identifiant d'objet (ObjectId)

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Property

Spécifie les propriétés à retourner.

Propriétés du paramètre

Type:

System.String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Sélectionnez

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Top

Spécifie le nombre maximal d’enregistrements à retourner.

Propriétés du paramètre

Type:System.Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Limite

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.