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。