Get-EntraContactDirectReport

Modul:
Microsoft.Entra.DirectoryManagement Module v1.3

Hämta direktrapporterna för en kontakt.

Syntax

Default (Standard) 

Get-EntraContactDirectReport

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

Description

Cmdleten Get-EntraContactDirectReport hämtar direktrapporterna för en kontakt.

För delegerade scenarier med arbets- eller skolkonton måste den inloggade användaren ha en Microsoft Entra roll som stöds eller en anpassad roll med nödvändiga behörigheter. Följande minst privilegierade roller stöder den här åtgärden:

  • Katalogläsare: Läsa grundläggande egenskaper
  • Global läsare
  • Katalogförfattare
  • Intune-administratör
  • Användaradministratör

Exempel

Exempel 1: Hämta direktrapporter för en kontakt

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

Det här exemplet visar hur du hämtar direkta rapporter för en organisationskontakt.

Du kan använda kommandot Get-EntraBetaContact för att hämta organisationskontakt.

  • -OrgContactId parametern anger kontakt-ID:t.

Exempel 2: Hämta alla direkta rapporter om en kontakt

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

Det här exemplet visar hur du hämtar alla direktrapporter för en organisationskontakt.

  • -OrgContactId parametern anger kontakt-ID:t.

Exempel 3: Hämta de två främsta direktrapporterna för en kontakt

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

Det här exemplet visar hur du hämtar de två främsta direktrapporterna för en organisationskontakt. Du kan använda -Limit som ett alias för -Top.

  • -OrgContactId parametern anger kontakt-ID:t.

Parametrar

-All

Visa en lista över alla sidor.

Parameteregenskaper

Typ:System.Management.Automation.SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-OrgContactId

Anger ID för en kontakt i Microsoft Entra ID.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Objekt-ID

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Property

Anger egenskaper som ska returneras.

Parameteregenskaper

Typ:

System.String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Select

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Top

Anger det maximala antalet poster som ska returneras.

Parameteregenskaper

Typ:System.Int32
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Limit

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.