Get-MsolDevice

  • Referência
Módulo:
MSOnline

Obtém um dispositivo individual ou uma lista de dispositivos.

Sintaxe

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 de 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 chamado 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 o Intune (por exemplo, EAS)

Parâmetros

-All

Indica que esse cmdlet retorna todos os resultados.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeviceId

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

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-IncludeSystemManagedDevices

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

Tipo:SwitchParamater
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LogonTimeBefore

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

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ObjectId

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

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-RegisteredOwnerUpn

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ReturnRegisteredOwners

Indica que esse cmdlet retorna a propriedade registeredOwners do dispositivo.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Saídas

Microsoft.Online.Administration.Device

Esse cmdlet retorna objetos de 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 de versão do objeto do dispositivo.
  • DeviceOSType: o tipo de sistema operacional do dispositivo.
  • DeviceOSVersion: o número de versão do sistema operacional do dispositivo.
  • DeviceTrustType: o tipo de confiança do dispositivo. O valor pode ser um dos seguintes: Ingresso 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 de dispositivo retornado da API de grafo.