Share via

Get-MsolDevice

  • Referência
Módulo:
MSOnline

Obtém um dispositivo individual ou uma 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

O cmdlet Get-MsolDevice obtém um dispositivo individual ou uma lista de dispositivos.

Exemplos

Exemplo 1: Obter um objeto de dispositivo

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

Esse comando obtém um objeto de dispositivo chamado NIC0123.

Exemplo 2: Obter uma lista de objetos de dispositivo

PS C:\>Get-MsolDevice -All

Esse comando obtém uma lista de objetos de dispositivo. Como o parâmetro ReturnRegisteredOwners não é usado, o objeto do dispositivo não contém a propriedade registeredOwners .

Exemplo 3: obter uma lista de objetos de dispositivo que contém a propriedade registeredOwners

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

Esse comando obtém uma lista de objetos de dispositivo. Como o parâmetro ReturnRegisteredOwners é usado, o objeto do dispositivo contém a propriedade registeredOwners .

Exemplo 4: Obter um dispositivo por ID do dispositivo

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

Esse comando obtém um dispositivo com a ID do dispositivo correspondente.

Exemplo 5: Obter um objeto de dispositivo por ID de objeto

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

Esse comando obtém um dispositivo com a ID do objeto correspondente.

Exemplo 6: Obter dispositivos registrados pelo UPN

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

Esse comando obtém todos os dispositivos registrados pelo usuário com o UPN nomeado pattifuller@contoso.com.

Exemplo 7: obter o carimbo de data/hora do dispositivo por atividade (logon)

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

O comando Ths obtém todos os dispositivos com o ApproximateLastLogonTimestamp antes de 1º de janeiro de 2017

Exemplo 8: Obter dispositivos e incluir dispositivos gerenciados pelo sistema

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

Esse comando obtém todos os dispositivos e inclui dispositivos piloto automático e outros dispositivos que são usados com Intune (por exemplo, EAS)

Parâmetros

-All

Indica que esse cmdlet retorna todos os resultados.

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

-DeviceId

Especifica a ID do dispositivo que esse cmdlet obtém.

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

-IncludeSystemManagedDevices

Indica que esse cmdlet inclui dispositivos gerenciados pelo sistema, como piloto automático.

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

-LogonTimeBefore

Especificou a data (UTC) usada para filtrar a lista de dispositivos.

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

-Name

Especifica o nome de exibição do dispositivo que esse cmdlet obtém.

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

-ObjectId

Especifica a ID de objeto exclusivo do dispositivo que esse cmdlet obtém.

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

-RegisteredOwnerUpn

Especifica o objeto de usuário que é o proprietário registrado do dispositivo. Você precisa fornecer o nome da entidade de usuário (UPN) ou ObjectId ou passar uma instância de um objeto Microsoft.Online.Administration.User que contém o UPN ou ObjectId do usuário.

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

-ReturnRegisteredOwners

Indica que esse cmdlet retorna a propriedade registeredOwners do dispositivo.

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

Saídas

Microsoft.Online.Administration.Device

Esse cmdlet retorna objetos do dispositivo, que incluem as seguintes informações:

  • AccountEnabled: o status do dispositivo: habilitado ou desabilitado.
  • ObjectId: A ID exclusiva do dispositivo.
  • DeviceId: A ID do dispositivo.
  • DisplayName: o nome de exibição do dispositivo.
  • DeviceObjectVersion: o número da versão do objeto do dispositivo.
  • DeviceOSType: o tipo de sistema operacional do dispositivo.
  • DeviceOSVersion: o número da versão do sistema operacional do dispositivo.
  • DeviceTrustType: o tipo de confiança do dispositivo. O valor pode ser um dos seguintes: Ingressado no Local de Trabalho, Ingressado no AzureAD, Ingressado no Domínio.
  • DeviceTrustLevel: o nível de confiança do dispositivo. O valor pode ser um dos seguintes: Autenticado, Compatível, Gerenciado.
  • DevicePhysicalIds: as IDs físicas do dispositivo.
  • ApproximateLastLogonTimestamp: o último carimbo de data/hora de logon usando este dispositivo.
  • AlternativeSecurityIds: as IDs de segurança alternativas do dispositivo.
  • DirSyncEnabled: se o dispositivo estiver habilitado com DirSync.
  • LastDirSyncTime: o último carimbo de data/hora em que o dispositivo foi sincronizado pelo DirSync.
  • RegisteredOwners: o proprietário registrado do dispositivo.
  • GraphDeviceObject: o objeto do dispositivo retornado da API de grafo.