Get-MsolDevice

  • Riferimento
Modulo:
MSOnline

Ottiene un singolo dispositivo o un elenco di dispositivi.

Sintassi

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

Descrizione

Il cmdlet Get-MsolDevice ottiene un singolo dispositivo o un elenco di dispositivi.

Esempio

Esempio 1: Ottenere un oggetto dispositivo

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

Questo comando ottiene un oggetto dispositivo denominato NIC0123.

Esempio 2: Ottenere un elenco di oggetti dispositivo

PS C:\>Get-MsolDevice -All

Questo comando ottiene un elenco di oggetti dispositivo. Poiché il parametro ReturnRegisteredOwners non viene utilizzato, l'oggetto dispositivo non contiene la proprietà registeredOwners .

Esempio 3: Ottenere un elenco di oggetti dispositivo che contiene la proprietà registeredOwners

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

Questo comando ottiene un elenco di oggetti dispositivo. Poiché viene utilizzato il parametro ReturnRegisteredOwners , l'oggetto dispositivo contiene la proprietà registeredOwners .

Esempio 4: Ottenere un dispositivo in base all'ID dispositivo

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

Questo comando ottiene un dispositivo con l'ID dispositivo corrispondente.

Esempio 5: Ottenere un oggetto dispositivo in base all'ID oggetto

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

Questo comando ottiene un dispositivo con l'ID oggetto corrispondente.

Esempio 6: Ottenere i dispositivi registrati dall'UPN

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

Questo comando ottiene tutti i dispositivi registrati dall'utente con l'UPN denominato pattifuller@contoso.com.

Esempio 7: Ottenere il timestamp del dispositivo per attività (accesso)

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

Il comando Ths ottiene tutti i dispositivi con approssimazioneLastLogonTimestamp prima del 1° gennaio 2017

Esempio 8: Ottenere i dispositivi e includere dispositivi gestiti dal sistema

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

Questo comando ottiene tutti i dispositivi e include dispositivi pilota automatici e altri dispositivi usati con Intune (ad esempio EAS)

Parametri

-All

Indica che questo cmdlet restituisce tutti i risultati.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeviceId

Specifica l'ID dispositivo del dispositivo che ottiene questo cmdlet.

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-IncludeSystemManagedDevices

Indica che questo cmdlet include dispositivi gestiti dal sistema, ad esempio auto-pilota.

Tipo:SwitchParamater
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-LogonTimeBefore

Specifica la data (UTC) usata per filtrare l'elenco dei dispositivi.

Tipo:DateTime
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica il nome visualizzato del dispositivo che ottiene questo cmdlet.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ObjectId

Specifica l'ID oggetto univoco del dispositivo che ottiene questo cmdlet.

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-RegisteredOwnerUpn

Specifica l'oggetto utente che è il proprietario registrato del dispositivo. È necessario specificare il nome dell'entità utente (UPN) o ObjectId oppure passare un'istanza di un oggetto Microsoft.Online.Administration.User che contiene l'UPN o ObjectId dell'utente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ReturnRegisteredOwners

Indica che questo cmdlet restituisce la proprietà registeredOwners del dispositivo.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Output

Microsoft.Online.Administration.Device

Questo cmdlet restituisce oggetti dispositivo, che includono le informazioni seguenti:

  • AccountEnabled: stato del dispositivo: abilitato o disabilitato.
  • ObjectId: ID univoco del dispositivo.
  • DeviceId: ID dispositivo del dispositivo.
  • DisplayName: nome visualizzato del dispositivo.
  • DeviceObjectVersion: numero di versione dell'oggetto del dispositivo.
  • DeviceOSType: tipo di sistema operativo del dispositivo.
  • DeviceOSVersion: numero di versione del sistema operativo del dispositivo.
  • DeviceTrustType: tipo di attendibilità del dispositivo. Il valore può essere uno dei seguenti: Aggiunta all'area di lavoro, Aggiunto ad AzureAD, Aggiunto a un dominio.
  • DeviceTrustLevel: livello di attendibilità del dispositivo. Il valore può essere uno dei seguenti: Authenticated, Compliant, Managed.
  • DevicePhysicalIds: ID fisici del dispositivo.
  • ApprossimazioneLastLogonTimestamp: timestamp dell'ultimo accesso con questo dispositivo.
  • AlternativeSecurityIds: ID di sicurezza alternativi del dispositivo.
  • DirSyncEnabled: se il dispositivo è abilitato con DirSync.
  • LastDirSyncTime: l'ultimo timestamp del dispositivo è stato sincronizzato da DirSync.
  • RegisteredOwners: proprietario registrato del dispositivo.
  • GraphDeviceObject: l'oggetto dispositivo restituito dall'API graph.