你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Get-AzureADDevice

从 Active Directory 获取设备。

语法

Get-AzureADDevice
   [-All <Boolean>]
   [-Top <Int32>]
   [-Filter <String>]
   [<CommonParameters>]
Get-AzureADDevice
   [-SearchString <String>]
   [-All <Boolean>]
   [<CommonParameters>]
Get-AzureADDevice
   -ObjectId <String>
   [-All <Boolean>]
   [<CommonParameters>]

说明

Get-AzureADDevice cmdlet 从 Azure Active Directory (AD) 获取设备。

示例

示例 1:按 ID 获取设备

PS C:\>Get-AzureADDevice -ObjectId "3cb87a8f-0a41-4ca8-8910-e56cc00114a3"

ObjectId                             DeviceId                             DisplayName
--------                             --------                             -----------
3cb87a8f-0a41-4ca8-8910-e56cc00114a3 48445467-033c-42ca-8e38-8d181db1d49c bastias_WindowsPhone_5/1/2016_12:53 PM

此命令获取指定的设备。

示例 2:获取所有设备

PS C:\>Get-AzureADDevice

ObjectId                             DeviceId                             DisplayName
--------                             --------                             -----------
3cb87a8f-0a41-4ca8-8910-e56cc00114a3 48445467-033c-42ca-8e38-8d181db1d49c bastias_WindowsPhone_5/1/2016_12:53 PM
62aae804-8b1a-4ab7-8fda-5068aed1a1f7 3cb87a8f-0a41-4ca8-8910-e56cc00114a3 New Device
d4fe7726-5966-431c-b3b8-cddc8fdb717d 293872f6-c006-4e6a-8629-07847c5ab078 New Device

此命令获取所有可用的设备。

示例 3:使用筛选条件获取设备

PS C:\>Get-AzureADDevice -Filter "startswith(DeviceOSType,'Windows')"

ObjectId                             DeviceId                             DisplayName
--------                             --------                             -----------
3cb87a8f-0a41-4ca8-8910-e56cc00114a3 48445467-033c-42ca-8e38-8d181db1d49c DESKTOP-ABC123YN
62aae804-8b1a-4ab7-8fda-5068aed1a1f7 3cb87a8f-0a41-4ca8-8910-e56cc00114a3 DESKTOP-DJF4463Y
d4fe7726-5966-431c-b3b8-cddc8fdb717d 293872f6-c006-4e6a-8629-07847c5ab078 DESKTOP-HXB4327H

示例 4:按名称获取特定设备

PS C:\>Get-AzureADDevice -SearchString "DESKTOP-DJF4463Y"

ObjectId                             DeviceId                             DisplayName
--------                             --------                             -----------
62aae804-8b1a-4ab7-8fda-5068aed1a1f7 3cb87a8f-0a41-4ca8-8910-e56cc00114a3 DESKTOP-DJF4463Y

参数

-All

如果为 true,则返回所有设备。 如果为 false,则返回 Top 参数指定的对象数

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Filter

指定 oData v3.0 筛选器语句。 此参数控制返回的对象。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-ObjectId

指定 Azure AD 中设备的 ID。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-SearchString

指定搜索字符串。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Top

指定要返回的最大记录数。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

备注

请参阅 Get-AzureADDevice 到 Microsoft Graph PowerShell 的迁移指南。