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 cmdlet 基于 ID 列表检索目录对象（最多包含 1000 个 GUID 的列表（作为字符串）来检索对象。
示例
示例 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参数指定要为其检索对象的最多 1000 个 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参数指定要为其检索对象的最多 1000 个 GUID 的列表（作为字符串）。 -
-ObjectTypes参数指定对象 ID 的类型。
参数
-DirectoryObjectIds
一个或多个对象 ID，用逗号分隔，为其检索对象。 ID 是 GUID，表示为字符串。 最多可以指定 1,000 个 ID。
参数属性
| 类型: | System.Collections.Generic.List`1[System.String] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | ObjectIds |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ObjectTypes
指定 cmdlet 返回的对象的类型。 如果未指定，则默认值为 directoryObject，其中包括目录中定义的所有资源类型。 可以在集合中指定派生自 directoryObject 的任何对象，例如用户、组和设备对象。
参数属性
| 类型: | System.Collections.Generic.List`1[System.String] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | Types |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Property
指定要返回的属性。
参数属性
| 类型: | System.String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | Select |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。