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 , объект устройства содержит свойство 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 получает все устройства с помощью ПриблизительнойlastLogonTimestamp до 1 января 2017 г.

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

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

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

Параметры

-All

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DeviceId

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

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-IncludeSystemManagedDevices

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

Type:SwitchParamater
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-LogonTimeBefore

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

Type:DateTime
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ObjectId

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

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RegisteredOwnerUpn

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ReturnRegisteredOwners

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

Microsoft.Online.Administration.Device

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

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