Get-EntraContactDirectReport

取得聯絡人的直接下屬。

語法

Default (預設值)

Get-EntraContactDirectReport

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

Description

Get-EntraContactDirectReport指揮官會直接接收聯絡人的直接報告。

對於涉及工作或學校帳號的委派情境,登入使用者必須擁有支援的 Microsoft Entra 角色或具備所需權限的自訂角色。 以下最低權限角色支援此操作:

  • 目錄讀取器:讀取基本屬性
  • 全球閱讀器
  • 目錄編輯者
  • Intune 管理員
  • 使用者管理員

範例

範例一:取得聯絡人的直接下屬

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

此範例展示了如何為組織聯絡人取得直接下屬資料。

你可以用這個指令 Get-EntraBetaContact 來取得組織聯繫。

  • -OrgContactId 參數指定聯絡 ID。

範例二:取得聯絡人的所有直接下屬

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

這個範例展示了如何取得組織聯絡人的所有直接下屬。

  • -OrgContactId 參數指定聯絡 ID。

範例三:取得聯絡人中前兩名的直接下屬

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

此範例展示了如何取得組織聯絡人中前兩名的直接下屬。 您可以使用 -Limit 作為 -Top的別名。

  • -OrgContactId 參數指定聯絡 ID。

參數

-All

列出所有頁面。

參數屬性

類型:System.Management.Automation.SwitchParameter
預設值:False
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-OrgContactId

指定 Microsoft Entra ID 中聯絡人的 ID。

參數屬性

類型:System.String
預設值:None
支援萬用字元:False
不要顯示:False
別名:ObjectId (物件識別碼)

參數集

(All)
Position:Named
必要:True
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Property

指定要回傳的屬性。

參數屬性

類型:

System.String[]

預設值:None
支援萬用字元:False
不要顯示:False
別名:選取

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Top

指定回傳的最大紀錄數量。

參數屬性

類型:System.Int32
預設值:None
支援萬用字元:False
不要顯示:False
別名:極限

參數集

(All)
Position:Named
必要:False
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。