Get-EntraContactDirectReport

Module:
Microsoft.Entra.DirectoryManagement Module v1.3

De direct ondergeschikten voor een contactpersoon ophalen.

Syntax

Default (Standaard) 

Get-EntraContactDirectReport

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

Description

De Get-EntraContactDirectReport cmdlet haalt de direct ondergeschikten voor een contactpersoon op.

Voor gedelegeerde scenario's met betrekking tot werk- of schoolaccounts moet de aangemelde gebruiker beschikken over een ondersteunde Microsoft Entra-rol of een aangepaste rol met de vereiste machtigingen. De volgende rollen met minimale bevoegdheden ondersteunen deze bewerking:

  • Adreslijstlezers: basiseigenschappen lezen
  • Globale lezer
  • Adreslijstschrijvers
  • Intune-beheerder
  • Gebruikersbeheerder

Voorbeelden

Voorbeeld 1: De direct ondergeschikten van een contactpersoon ophalen

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

In dit voorbeeld ziet u hoe u direct ondergeschikten voor een organisatiecontactpersoon ophaalt.

U kunt de opdracht Get-EntraBetaContact gebruiken om de contactpersoon van de organisatie op te halen.

  • -OrgContactId parameter geeft de contact-id.

Voorbeeld 2: Alle direct ondergeschikten van een contactpersoon ophalen

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

In dit voorbeeld ziet u hoe u alle direct ondergeschikten voor een organisatiecontactpersoon ophaalt.

  • -OrgContactId parameter geeft de contact-id.

Voorbeeld 3: de twee belangrijkste direct ondergeschikten van een contactpersoon ophalen

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

In dit voorbeeld ziet u hoe u de twee belangrijkste direct ondergeschikten voor een organisatiecontactpersoon ophaalt. U kunt -Limit gebruiken als alias voor -Top.

  • -OrgContactId parameter geeft de contact-id.

Parameters

-All

Alle pagina's weergeven.

Parametereigenschappen

Type:System.Management.Automation.SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-OrgContactId

Hiermee geeft u de id van een contactpersoon in Microsoft Entra ID.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:ObjectId

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Property

Hiermee geeft u eigenschappen die moeten worden geretourneerd.

Parametereigenschappen

Type:

System.String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Selecteren

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Top

Hiermee geeft u het maximum aantal records dat moet worden geretourneerd.

Parametereigenschappen

Type:System.Int32
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Limit

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.