Get-EntraUserCreatedObject
获取用户创建的对象。
语法
Default (默认值)
Get-EntraUserCreatedObject
-UserId <String>
[-All]
[-Top <Int32>]
[-Property <String[]>]
[<CommonParameters>]
说明
该 Get-EntraUserCreatedObject cmdlet 检索由非管理员用户创建的目录对象。 如果用户具有管理员角色,则返回一个空对象。
示例
示例 1:获取用户创建的对象
Connect-Entra -Scopes 'User.Read','User.Read.All'
Get-EntraUserCreatedObject -UserId 'SawyerM@contoso.com' | Select-Object Id, DisplayName, '@odata.type'
Id displayName @odata.type
-- ----------- -----------
cccccccc-2222-3333-4444-dddddddddddd Contoso Group #microsoft.graph.group
此示例检索由指定用户创建的对象。
-
-UserId参数指定用户的对象 ID(作为 UserPrincipalName 或 UserId)。
示例 2:获取所有用户创建的对象
Connect-Entra -Scopes 'User.Read','User.Read.All'
Get-EntraUserCreatedObject -UserId 'SawyerM@contoso.com' -All | Select-Object Id, DisplayName, '@odata.type'
Id displayName @odata.type
-- ----------- -----------
cccccccc-2222-3333-4444-dddddddddddd Contoso Group #microsoft.graph.group
此示例检索指定用户创建的所有对象。
-
-UserId参数指定用户的对象 ID(作为 UserPrincipalName 或 UserId)。
示例 3:获取一个用户创建的前一个对象
Connect-Entra -Scopes 'User.Read','User.Read.All'
Get-EntraUserCreatedObject -UserId 'SawyerM@contoso.com' -Top 1 | Select-Object Id, DisplayName, '@odata.type'
Id displayName @odata.type
-- ----------- -----------
cccccccc-2222-3333-4444-dddddddddddd Contoso Group #microsoft.graph.group
此示例检索由指定用户创建的第一个对象。 您可以将 -Limit 用作 -Top 的别名。
-
-UserId参数指定用户的对象 ID(作为 UserPrincipalName 或 UserId)。
参数
-All
列出所有页面。
参数属性
| 类型: | System.Management.Automation.SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Property
指定要返回的属性。
参数属性
| 类型: | System.String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | Select |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Top
指定要返回的最大记录数。
参数属性
| 类型: | System.Int32 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | Limit |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-UserId
指定Microsoft Entra ID中用户的 ID(作为 UserPrincipalName 或 UserId)。
参数属性
| 类型: | System.String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 对象标识符 (ObjectId), UPN, Identity, UserPrincipalName |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。