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 usato, l'oggetto device non contiene la proprietà registeredOwners .

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

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

Questo comando ottiene un elenco di oggetti dispositivo. Poiché viene usato il parametro ReturnRegisteredOwners , l'oggetto device 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 da 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 Il valore ApproximateLastLogonTimestamp prima del 1° gennaio 2017

Esempio 8: Ottenere i dispositivi e includere i 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.

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

-DeviceId

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

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

-IncludeSystemManagedDevices

Indica che questo cmdlet include dispositivi gestiti dal sistema, ad esempio il pilota automatico.

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

-LogonTimeBefore

Specificato la data (UTC) usata per filtrare l'elenco dei dispositivi in base.

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

-Name

Specifica il nome visualizzato del dispositivo che ottiene questo cmdlet.

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

-ObjectId

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

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 contenente l'UPN o ObjectId dell'utente.

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

-ReturnRegisteredOwners

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 potrebbe essere uno dei seguenti: Workplace Join, AzureAD Join, Domain Join.
  • DeviceTrustLevel: livello di attendibilità del dispositivo. Il valore potrebbe essere uno dei seguenti: Autenticato, Conforme, Gestito.
  • DevicePhysicalIds: ID fisici del dispositivo.
  • ApprossimazioneLastLogonTimestamp: l'ultimo timestamp di accesso usando 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: oggetto dispositivo restituito dall'API graph.