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 получает устройство из Azure Active Directory (AD).
Примеры
Пример 1. Получение устройства по идентификатору
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 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-Filter
Указывает инструкцию фильтра oData версии 3.0. Этот параметр управляет возвращаемыми объектами.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-ObjectId
Указывает идентификатор устройства в Azure AD.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-SearchString
Указывает строку поиска.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-Top
Указывает максимальное количество возвращаемых записей.
Тип: | Int32 |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
Примечания
См. руководство по миграции get-AzureADDevice в Microsoft Graph PowerShell.