Get-EntraDirectoryObject
ID の一覧に基づいてディレクトリ オブジェクトを取得します。
構文
Default (既定)
Get-EntraDirectoryObject
-DirectoryObjectIds <System.Collections.Generic.List`1[String]>
[-ObjectTypes <System.Collections.Generic.List`1[String]>]
[-Property <String[]>]
[<CommonParameters>]
説明
Get-EntraDirectoryObject コマンドレットは、ID の一覧 (オブジェクトを取得する最大 1,000 個の GUID (文字列) のリスト) に基づいてディレクトリ オブジェクトを取得します。
例
例 1: オブジェクト 1 つ以上のオブジェクト ID を取得する
Connect-Entra -Scopes 'Directory.Read.All'
$groups = Get-EntraGroup -Limit 4
Get-EntraDirectoryObject -DirectoryObjectIds $groups.Id |
Select-Object Id, DisplayName, '@odata.type'
id displayName @odata.type
-- ----------- -----------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Adele Vance #microsoft.graph.user
bbbbbbbb-1111-2222-3333-cccccccccccc Contoso User #microsoft.graph.user
この例では、指定したオブジェクト ID のオブジェクトを取得する方法を示します。
-
DirectoryObjectIdsパラメーターは、オブジェクトを取得する最大 1,000 個の GUID のリストを文字列として指定します。
例 2: 型別にオブジェクトを取得する
Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraDirectoryObject -DirectoryObjectIds 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb', 'bbbbbbbb-1111-2222-3333-cccccccccccc' -ObjectTypes 'User' |
Select-Object Id, DisplayName, '@odata.type'
id displayName @odata.type
-- ----------- -----------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Adele Vance #microsoft.graph.user
bbbbbbbb-1111-2222-3333-cccccccccccc Contoso User #microsoft.graph.user
この例では、指定したオブジェクト型のオブジェクトを取得する方法を示します。
-
-DirectoryObjectIdsパラメーターは、オブジェクトを取得する最大 1,000 個の GUID のリストを文字列として指定します。 -
-ObjectTypesパラメーターは、オブジェクト ID の型を指定します。
パラメーター
-DirectoryObjectIds
オブジェクトが取得される 1 つ以上のオブジェクト ID をコンマで区切って指定します。 ID は GUID であり、文字列として表されます。 最大 1,000 個の ID を指定できます。
パラメーターのプロパティ
| 型: | System.Collections.Generic.List`1[System.String] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | Objectid |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ObjectTypes
コマンドレットが返すオブジェクトの種類を指定します。 指定しない場合、既定値は directoryObject であり、ディレクトリで定義されているすべてのリソースの種類が含まれます。 ユーザー、グループ、デバイス オブジェクトなど、コレクション内の directoryObject から派生した任意のオブジェクトを指定できます。
パラメーターのプロパティ
| 型: | System.Collections.Generic.List`1[System.String] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | Types |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Property
返されるプロパティを指定します。
パラメーターのプロパティ
| 型: | System.String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | Select |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。