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。