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"

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

Exemplo 2: Obtenha uma lista de objetos do dispositivo

PS C:\>Get-MsolDevice -All

Este comando obtém uma lista de objetos do dispositivo. Uma vez que o parâmetro ReturnRegisteredOwners não é utilizado, o objeto do dispositivo não contém a propriedade de Proprietário registado .

Exemplo 3: Obtenha uma lista de objetos do dispositivo que contenham a propriedade registada

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

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

Exemplo 4: Obter um dispositivo por ID do dispositivo

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

Este comando obtém um dispositivo com o iD do dispositivo correspondente.

Exemplo 5: Obtenha 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 do objeto correspondente.

Exemplo 6: Obter dispositivos registados pela UPN

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

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

Exemplo 7: Obter dispositivo por tempotê-horário de 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 aproximadaLastLogonTimestamp 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 recebe todos os dispositivos e inclui dispositivos piloto automáticos e outros dispositivos que são utilizados com Intune (por exemplo, EAS)

Parâmetros

-All

Indica que este cmdlet devolve todos os resultados.

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

-DeviceId

Especifica a identificação do dispositivo do dispositivo que este cmdlet obtém.

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

-IncludeSystemManagedDevices

Indica que este cmdlet inclui dispositivos que são geridos pelo sistema, tais 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) utilizada para filtrar a lista de dispositivos por.

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

-Name

Especifica o nome de visualização do dispositivo que este cmdlet obtém.

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

-ObjectId

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

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

-RegisteredOwnerUpn

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

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

-ReturnRegisteredOwners

Indica que este cmdlet devolve a propriedade registada 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

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

  • AccountEnabled: O estado do dispositivo: ativado ou desativado.
  • ObjectId: O ID único do dispositivo.
  • DeviceId: O ID do dispositivo.
  • Nome do Visor: O nome de visualização 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: Workplace Joined, AzureAD Joined, Domain Joined.
  • DeviceTrustLevel: O nível de confiança do dispositivo. O valor pode ser um dos seguintes: Autenticado, Compatível, Gerido.
  • DispositivoSFísicos: Os identificações físicas do dispositivo.
  • AproximadaLastLogonTimestamp: O último semanu máximo de tempo com este dispositivo.
  • AlternativeSecurityIds: O dispositivo identifica a segurança alternativa.
  • DirSyncEnabled: Se o dispositivo estiver ativado com o DirSync.
  • LastDirSyncTime: O último tempo de tempo estempou o dispositivo foi sincronizado pela DirSync.
  • Proprietário registado: o proprietário registado do dispositivo.
  • GrafDeviceObject: O objeto do dispositivo foi devolvido a partir da API do gráfico.