Partager via

Get-MsolDevice

  • Référence
Module:
MSOnline

Obtient un appareil individuel ou une liste d’appareils.

Syntaxe

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

L’applet de commande Get-MsolDevice obtient un appareil individuel ou une liste d’appareils.

Exemples

Exemple 1 : Obtenir un objet d’appareil

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

Cette commande obtient un objet d’appareil nommé NIC0123.

Exemple 2 : obtenir une liste d’objets d’appareil

PS C:\>Get-MsolDevice -All

Cette commande obtient une liste d’objets d’appareil. Étant donné que le paramètre ReturnRegisteredOwners n’est pas utilisé, l’objet d’appareil ne contient pas la propriété registeredOwners .

Exemple 3 : obtenir une liste d’objets d’appareil qui contient la propriété registeredOwners

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

Cette commande obtient une liste d’objets d’appareil. Étant donné que le paramètre ReturnRegisteredOwners est utilisé, l’objet d’appareil contient la propriété registeredOwners .

Exemple 4 : Obtenir un appareil par ID d’appareil

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

Cette commande obtient un appareil avec l’ID d’appareil correspondant.

Exemple 5 : Obtenir un objet d’appareil par ID d’objet

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

Cette commande obtient un appareil avec l’ID d’objet correspondant.

Exemple 6 : Obtenir des appareils inscrits par UPN

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

Cette commande obtient tous les appareils inscrits par l’utilisateur avec l’UPN nommé pattifuller@contoso.com.

Exemple 7 : Obtenir l’horodatage de l’appareil par activité (ouverture de session)

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

La commande Ths obtient tous les appareils avec l’élément ApproximateLastLogonTimestamp avant le 1er janvier 2017

Exemple 8 : Obtenir des appareils et inclure des appareils gérés par le système

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

Cette commande obtient tous les appareils et inclut les appareils de pilote automatique et d’autres appareils utilisés avec Intune (par exemple, EAS)

Paramètres

-All

Indique que cette applet de commande retourne tous les résultats.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DeviceId

Spécifie l’ID d’appareil de l’appareil que cette applet de commande obtient.

Type:Guid
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-IncludeSystemManagedDevices

Indique que cette applet de commande inclut les appareils gérés par le système, tels que le pilote automatique.

Type:SwitchParamater
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-LogonTimeBefore

Spécifie la date (UTC) utilisée pour filtrer la liste des appareils par.

Type:DateTime
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifie le nom complet de l’appareil que cette applet de commande obtient.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ObjectId

Spécifie l’ID d’objet unique de l’appareil que cette applet de commande obtient.

Type:Guid
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-RegisteredOwnerUpn

Spécifie l’objet utilisateur qui est le propriétaire inscrit de l’appareil. Vous devez fournir le nom d’utilisateur principal (UPN) ou ObjectId, ou passer une instance d’un objet Microsoft.Online.Administration.User qui contient l’UPN ou ObjectId de l’utilisateur.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ReturnRegisteredOwners

Indique que cette applet de commande renvoie la propriété registeredOwners de l’appareil .

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Sorties

Microsoft.Online.Administration.Device

Cette applet de commande retourne des objets d’appareil, qui incluent les informations suivantes :

  • AccountEnabled : état de l’appareil : activé ou désactivé.
  • ObjectId : ID unique de l’appareil.
  • DeviceId : ID d’appareil de l’appareil.
  • DisplayName : nom d’affichage de l’appareil.
  • DeviceObjectVersion : numéro de version de l’objet de l’appareil.
  • DeviceOSType : type de système d’exploitation de l’appareil.
  • DeviceOSVersion : numéro de version du système d’exploitation de l’appareil.
  • DeviceTrustType : type d’approbation de l’appareil. La valeur peut être l’une des suivantes : Joint à l’espace de travail, Joint à AzureAD, Joint à un domaine.
  • DeviceTrustLevel : niveau de confiance de l’appareil. La valeur peut être l’une des suivantes : Authentifié, Conforme, Géré.
  • DevicePhysicalIds : ID physiques de l’appareil.
  • ApproximateLastLogonTimestamp : dernier horodatage d’ouverture de session utilisant cet appareil.
  • AlternativeSecurityIds : ids de sécurité alternatifs de l’appareil.
  • DirSyncEnabled : si l’appareil est activé avec DirSync.
  • LastDirSyncTime : dernier horodatage de la synchronisation de l’appareil par DirSync.
  • RegisteredOwners : propriétaire inscrit de l’appareil.
  • GraphDeviceObject : objet d’appareil retourné par l’API graph.