Partilhar via

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"

Este comando obtém um objeto de dispositivo com o nome NIC0123.

Exemplo 2: obter uma lista de objetos de dispositivo

PS C:\>Get-MsolDevice -All

Este comando obtém uma lista de objetos de dispositivo. Uma vez que o parâmetro ReturnRegisteredOwners não é utilizado, 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

Este comando obtém uma lista de objetos de dispositivo. Uma vez que o parâmetro ReturnRegisteredOwners é utilizado, o objeto do dispositivo contém a propriedade registeredOwners .

Exemplo 4: Obter um dispositivo por ID de dispositivo

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

Este comando obtém um dispositivo com o ID de dispositivo correspondente.

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

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

Este comando obtém um dispositivo com o ID de objeto correspondente.

Exemplo 6: Obter dispositivos registados pelo UPN

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

Este comando obtém todos os dispositivos registados pelo utilizador com o UPN denominado pattifuller@contoso.com.

Exemplo 7: Obter o carimbo de data/hora do dispositivo por atividade (início de sessão)

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 geridos pelo sistema

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

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

Parâmetros

-All

Indica que este cmdlet devolve todos os resultados.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DeviceId

Especifica o ID do dispositivo que este cmdlet obtém.

Tipo:Guid
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-IncludeSystemManagedDevices

Indica que este cmdlet inclui dispositivos geridos pelo sistema, como o piloto automático.

Tipo:SwitchParamater
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-LogonTimeBefore

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

Tipo:DateTime
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Name

Especifica o nome a apresentar do dispositivo que este cmdlet obtém.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ObjectId

Especifica o ID de objeto exclusivo do dispositivo que este cmdlet obtém.

Tipo:Guid
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-RegisteredOwnerUpn

Especifica o objeto de utilizador que é o proprietário registado do dispositivo. Tem de fornecer o nome principal de utilizador (UPN) ou ObjectId ou transmitir uma instância de um objeto Microsoft.Online.Administration.User que contém o UPN ou o ObjectId do utilizador.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ReturnRegisteredOwners

Indica que este cmdlet devolve a propriedade registeredOwners do dispositivo.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Saídas

Microsoft.Online.Administration.Device

Este cmdlet devolve objetos de dispositivo, que incluem as seguintes informações:

  • AccountEnabled: o estado do dispositivo: ativado ou desativado.
  • ObjectId: o ID exclusivo do dispositivo.
  • DeviceId: o ID do dispositivo.
  • DisplayName: o nome a apresentar do dispositivo.
  • DeviceObjectVersion: o número da versão do objeto do dispositivo.
  • DeviceOSType: o tipo de sistema operativo do dispositivo.
  • DeviceOSVersion: o número da versão do sistema operativo do dispositivo.
  • DeviceTrustType: o tipo de confiança do dispositivo. O valor pode ser um dos seguintes: Associado à Área de Trabalho, Associado ao AzureAD, Associado ao Domínio.
  • DeviceTrustLevel: o nível de confiança do dispositivo. O valor pode ser um dos seguintes: Autenticado, Compatível, Gerido.
  • DevicePhysicalIds: os IDs físicos do dispositivo.
  • ApproximateLastLogonTimestamp: o último carimbo de data/hora de início de sessão com este dispositivo.
  • AlternativeSecurityIds: os IDs de segurança alternativos do dispositivo.
  • DirSyncEnabled: se o dispositivo estiver ativado com o DirSync.
  • LastDirSyncTime: o último carimbo de data/hora em que o dispositivo foi sincronizado pelo DirSync.
  • RegisteredOwners: o proprietário registado do dispositivo.
  • GraphDeviceObject: o objeto do dispositivo devolvido a partir da graph API.