Get-EntraContactDirectReport

モジュール:
Microsoft.Entra.DirectoryManagement Module v1.3

連絡先の直属の部下を取得します。

構文

Default (既定) 

Get-EntraContactDirectReport

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

説明

Get-EntraContactDirectReport コマンドレットは、連絡先の直属の部下を取得します。

職場または学校アカウントを含む委任されたシナリオの場合、サインインしているユーザーは、サポートされているMicrosoft Entraロールまたは必要なアクセス許可を持つカスタム ロールを持っている必要があります。 この操作は、次の最小特権ロールでサポートされています。

  • ディレクトリ 閲覧者: 基本プロパティの読み取り
  • グローバルリーダー
  • ディレクトリ製作者
  • Intune 管理者
  • ユーザー管理者

例

例 1: 連絡先の直属の部下を取得する

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

この例では、組織の連絡先の直属の部下を取得する方法を示します。

コマンド Get-EntraBetaContact を使用して、組織の連絡先を取得できます。

  • -OrgContactId パラメーターは、連絡先 ID を指定します。

例 2: 連絡先のすべての直属の部下を取得する

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

この例では、組織の連絡先のすべての直属の部下を取得する方法を示します。

  • -OrgContactId パラメーターは、連絡先 ID を指定します。

例 3: 連絡先の上位 2 件の直属部下を取得する

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

この例では、組織の連絡先の上位 2 つの直属の部下を取得する方法を示します。 -Limitのエイリアスとして-Topを使用できます。

  • -OrgContactId パラメーターは、連絡先 ID を指定します。

パラメーター

-All

すべてのページを一覧表示します。

パラメーターのプロパティ

型:System.Management.Automation.SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-OrgContactId

Microsoft Entra IDの連絡先の ID を指定します。

パラメーターのプロパティ

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:オブジェクト識別子

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Property

返されるプロパティを指定します。

パラメーターのプロパティ

型:

System.String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:Select

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Top

返されるレコードの最大数を指定します。

パラメーターのプロパティ

型:System.Int32
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:極限

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。