Get-EntraUserOwnedDevice

模块:
Microsoft.Entra.Users Module v1.3

获取用户拥有的已注册设备。

语法

Default (默认值) 

Get-EntraUserOwnedDevice

    -UserId <String>
    [-All]
    [-Top <Int32>]
    [-Property <String[]>]
    [<CommonParameters>]

说明

cmdlet Get-EntraUserOwnedDevice 在 Microsoft Entra ID 中获取指定用户拥有的已注册设备。

示例

示例 1：获取用户拥有的设备

Connect-Entra -Scopes 'User.Read.All'
Get-EntraUserOwnedDevice -UserId 'SawyerM@contoso.com'

ObjectId                             DeviceId                             DisplayName
--------                             --------                             -----------
bbbbbbbb-1111-2222-3333-cccccccccccc aaaa0000-bb11-2222-33cc-444444dddddd Device1
cccccccc-2222-3333-4444-dddddddddddd bbbb1111-cc22-3333-44dd-555555eeeeee Device2

此命令获取指定用户拥有的已注册设备。

示例 2：获取用户拥有的所有设备

Connect-Entra -Scopes 'User.Read.All'
Get-EntraUserOwnedDevice -UserId 'SawyerM@contoso.com' -All

ObjectId                             DeviceId                             DisplayName
--------                             --------                             -----------
bbbbbbbb-1111-2222-3333-cccccccccccc aaaa0000-bb11-2222-33cc-444444dddddd Device1
cccccccc-2222-3333-4444-dddddddddddd bbbb1111-cc22-3333-44dd-555555eeeeee Device2

此命令获取指定用户拥有的所有已注册设备。

示例 3：获取用户拥有的前一台设备

Connect-Entra -Scopes 'User.Read.All'
Get-EntraUserOwnedDevice -UserId 'SawyerM@contoso.com' -Top 1

ObjectId                             DeviceId                             DisplayName
--------                             --------                             -----------
bbbbbbbb-1111-2222-3333-cccccccccccc aaaa0000-bb11-2222-33cc-444444dddddd Device1

此命令获取指定用户拥有的前一个已注册设备。 您可以将 -Limit 用作 -Top 的别名。

参数

-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中用户（作为用户主体名称或 UserId）的 ID。

参数属性

类型: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。