Поделиться через

Get-MsolDevice

  • Ссылка
Модуль:
MSOnline

Возвращает отдельное устройство или список устройств.

Синтаксис

Get-MsolDevice
   -Name <String>
   [<CommonParameters>]
Get-MsolDevice
   [-All]
   [-ReturnRegisteredOwners]
   [<CommonParameters>]
Get-MsolDevice
   -DeviceId <Guid>
   [<CommonParameters>]
Get-MsolDevice
   -All
   -LogonTimeBefore <DateTime>
   [<CommonParameters>]
Get-MsolDevice
   -ObjectId <Guid>
   [<CommonParameters>]
Get-MsolDevice
   -RegisteredOwnerUpn <String>
   [<CommonParameters>]
Get-MsolDevice
   -All
   -IncludeSystemManagedDevices
   [<CommonParameters>]

Описание

Командлет Get-MsolDevice получает отдельное устройство или список устройств.

Примеры

Пример 1. Получение объекта устройства

PS C:\>Get-MsolDevice -Name "NIC0123"

Эта команда возвращает объект устройства с именем NIC0123.

Пример 2. Получение списка объектов устройств

PS C:\>Get-MsolDevice -All

Эта команда получает список объектов устройства. Так как параметр ReturnRegisteredOwners не используется, объект устройства не содержит свойство registeredOwners .

Пример 3. Получение списка объектов устройств, содержащих свойство registeredOwners

PS C:\>Get-MsolDevice -All -ReturnRegisteredOwners

Эта команда получает список объектов устройства. Так как используется параметр ReturnRegisteredOwners , объект device содержит свойство registeredOwners .

Пример 4. Получение устройства по идентификатору устройства

PS C:\>Get-MsolDevice -DeviceId "1aa200c4-bdfb-42b5-9a1e-5f1bafbe4274"

Эта команда возвращает устройство с соответствующим идентификатором устройства.

Пример 5. Получение объекта устройства по идентификатору объекта

PS C:\>Get-MsolDevice -ObjectId "566F7EA7-7BF1-4F4A-AF23-A1B46DBD46D6"

Эта команда возвращает устройство с соответствующим идентификатором объекта.

Пример 6. Получение устройств, зарегистрированных по имени участника-пользователя

PS C:\>Get-MsolDevice -RegisteredOwnerUpn "pattifuller@contoso.com"

Эта команда получает все устройства, зарегистрированные пользователем с именем участника-пользователя pattifuller@contoso.com.

Пример 7. Получение устройства по метке времени действия (входа)

PS C:\>Get-MsolDevice -All -LogonTimeBefore 'January 1, 2017 12:00:00 AM'

Команда Ths получает все устройства с меткой ApproximateLastLogonTimestamp до 1 января 2017 г.

Пример 8. Получение устройств и включение устройств, управляемых системой

PS C:\>Get-MsolDevice -All -IncludeSystemManagedDevices

Эта команда получает все устройства и включает устройства с автоматическим пилотом и другие устройства, используемые с Intune (например, EAS).

Параметры

-All

Указывает, что этот командлет возвращает все результаты.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DeviceId

Указывает идентификатор устройства, которое получает этот командлет.

Тип:Guid
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-IncludeSystemManagedDevices

Указывает, что этот командлет включает устройства, управляемые системой, такие как автопилот.

Тип:SwitchParamater
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-LogonTimeBefore

Указана дата (UTC), используемая для фильтрации списка устройств.

Тип:DateTime
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Name

Указывает отображаемое имя устройства, которое получает этот командлет.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ObjectId

Указывает уникальный идентификатор объекта устройства, которое получает этот командлет.

Тип:Guid
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-RegisteredOwnerUpn

Указывает объект пользователя, который является зарегистрированным владельцем устройства. Необходимо указать имя участника-пользователя (UPN) или ObjectId или передать экземпляр объекта Microsoft.Online.Administration.User , который содержит имя участника-пользователя или ObjectId пользователя.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ReturnRegisteredOwners

Указывает, что этот командлет возвращает свойство registeredOwners устройства.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Выходные данные

Microsoft.Online.Administration.Device

Этот командлет возвращает объекты устройства, которые содержат следующие сведения:

  • AccountEnabled: состояние устройства: включено или отключено.
  • ObjectId— уникальный идентификатор устройства.
  • DeviceId— идентификатор устройства.
  • DisplayName: отображаемое имя устройства.
  • DeviceObjectVersion: номер версии объекта устройства.
  • DeviceOSType: тип операционной системы устройства.
  • DeviceOSVersion: номер версии операционной системы устройства.
  • DeviceTrustType— тип доверия устройства. Это может быть одно из следующих значений: Присоединено к рабочему месту, Присоединено к AzureAD, Присоединено к домену.
  • DeviceTrustLevel: уровень доверия устройства. Значение может иметь одно из следующих значений: Прошедший проверку подлинности, Соответствие, Управляемое.
  • DevicePhysicalIds: физические идентификаторы устройства.
  • ApproximateLastLogonTimestamp: метка времени последнего входа на этом устройстве.
  • AlternativeSecurityIds: альтернативные идентификаторы безопасности устройства.
  • DirSyncEnabled. Если устройство включено с DirSync.
  • LastDirSyncTime: последняя метка времени, которую устройство синхронизировало с помощью DirSync.
  • RegisteredOwnowners— зарегистрированный владелец устройства.
  • GraphDeviceObject: объект устройства, возвращаемый из API graph.