Get-EntraUserCreatedObject
取得使用者建立的物件。
語法
Default (預設值)
Get-EntraUserCreatedObject
-UserId <String>
[-All]
[-Top <Int32>]
[-Property <String[]>]
[<CommonParameters>]
Description
指令 Get-EntraUserCreatedObject 長用來檢索非管理員使用者建立的目錄物件。 如果使用者有管理員角色,會回傳一個空物件。
範例
範例 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 |
| 別名: | 選取 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Top
指定回傳的最大紀錄數量。
參數屬性
| 類型: | System.Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 極限 |
參數集
(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。