Get-MsolDevice

  • Referencia
Módulo:
MSOnline

Obtiene un dispositivo individual o una lista de dispositivos.

Syntax

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>]

Description

El cmdlet Get-MsolDevice obtiene un dispositivo individual o una lista de dispositivos.

Ejemplos

Ejemplo 1: Obtener un objeto de dispositivo

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

Este comando obtiene un objeto de dispositivo denominado NIC0123.

Ejemplo 2: Obtener una lista de objetos de dispositivo

PS C:\>Get-MsolDevice -All

Este comando obtiene una lista de objetos de dispositivo. Puesto que no se usa el parámetro ReturnRegisteredOwners , el objeto device no contiene la propiedad registeredOwners .

Ejemplo 3: Obtener una lista de objetos de dispositivo que contiene la propiedad registeredOwners

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

Este comando obtiene una lista de objetos de dispositivo. Puesto que se usa el parámetro ReturnRegisteredOwners , el objeto device contiene la propiedad registeredOwners .

Ejemplo 4: Obtención de un dispositivo por identificador de dispositivo

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

Este comando obtiene un dispositivo con el identificador de dispositivo correspondiente.

Ejemplo 5: Obtener un objeto de dispositivo por identificador de objeto

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

Este comando obtiene un dispositivo con el identificador de objeto correspondiente.

Ejemplo 6: Obtener dispositivos registrados por UPN

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

Este comando obtiene todos los dispositivos registrados por el usuario con el UPN denominado pattifuller@contoso.com.

Ejemplo 7: Obtener la marca de tiempo del dispositivo por actividad (inicio de sesión)

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

El comando Ths obtiene todos los dispositivos con ApproximateLastLogonTimestamp antes del 1 de enero de 2017

Ejemplo 8: Obtener dispositivos e incluir dispositivos administrados por el sistema

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

Este comando obtiene todos los dispositivos e incluye dispositivos piloto automáticos y otros dispositivos que se usan con Intune (por ejemplo, EAS).

Parámetros

-All

Indica que este cmdlet devuelve todos los resultados.

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

-DeviceId

Especifica el identificador de dispositivo del dispositivo que obtiene este cmdlet.

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

-IncludeSystemManagedDevices

Indica que este cmdlet incluye dispositivos administrados por el sistema, como piloto automático.

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

-LogonTimeBefore

Se especificó la fecha (UTC) usada para filtrar la lista de dispositivos por.

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

-Name

Especifica el nombre para mostrar del dispositivo que obtiene este cmdlet.

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

-ObjectId

Especifica el identificador de objeto único del dispositivo que obtiene este cmdlet.

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

-RegisteredOwnerUpn

Especifica el objeto de usuario que es el propietario registrado del dispositivo. Debe proporcionar el nombre principal de usuario (UPN) o ObjectId, o pasar una instancia de un objeto Microsoft.Online.Administration.User que contenga el UPN o ObjectId del usuario.

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

-ReturnRegisteredOwners

Indica que este cmdlet devuelve la propiedad registeredOwners del dispositivo.

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

Salidas

Microsoft.Online.Administration.Device

Este cmdlet devuelve objetos de dispositivo, que incluyen la siguiente información:

  • AccountEnabled: estado del dispositivo: habilitado o deshabilitado.
  • ObjectId: identificador único del dispositivo.
  • DeviceId: identificador de dispositivo del dispositivo.
  • DisplayName: nombre para mostrar del dispositivo.
  • DeviceObjectVersion: número de versión del objeto del dispositivo.
  • DeviceOSType: el tipo de sistema operativo del dispositivo.
  • DeviceOSVersion: número de versión del sistema operativo del dispositivo.
  • DeviceTrustType: el tipo de confianza del dispositivo. El valor podría ser uno de los siguientes: Unido al área de trabajo, Unido a AzureAD, Unido a un dominio.
  • DeviceTrustLevel: nivel de confianza del dispositivo. El valor podría ser uno de los siguientes: Autenticado, Compatible, Administrado.
  • DevicePhysicalIds: identificadores físicos del dispositivo.
  • ApproximateLastLogonTimestamp: la última marca de tiempo de inicio de sesión que usa este dispositivo.
  • AlternativeSecurityIds: identificadores de seguridad alternativos del dispositivo.
  • DirSyncEnabled: si el dispositivo está habilitado con DirSync.
  • LastDirSyncTime: la última marca de tiempo que DirSync sincronizó el dispositivo.
  • RegisteredOwners: propietario registrado del dispositivo.
  • GraphDeviceObject: el objeto de dispositivo devuelto desde graph API.