Get-MsolDevice

  • Référence
Module:
MSOnline

Obtient un appareil individuel ou une liste d’appareils.

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

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 des appareils pilotes automatiques 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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DeviceId

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

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

-IncludeSystemManagedDevices

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

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

-LogonTimeBefore

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

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

-Name

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

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

-ObjectId

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

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ReturnRegisteredOwners

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 d’appareil. La valeur peut être l’une des suivantes : Joint à l’espace de travail, Joint à AzureAD, Joint au domaine.
  • DeviceTrustLevel : niveau d’approbation de l’appareil. La valeur peut être l’une des suivantes : authentifiée, conforme, gérée.
  • DevicePhysicalIds : ID physiques de l’appareil.
  • ApproximationLastLogonTimestamp : horodatage de la dernière ouverture de session à l’aide de cet appareil.
  • AlternativeSecurityIds : Id de sécurité alternatif de l’appareil.
  • DirSyncEnabled : si l’appareil est activé avec DirSync.
  • LastDirSyncTime : le dernier horodatage de l’appareil a été synchronisé par DirSync.
  • RegisteredOwners : propriétaire inscrit de l’appareil.
  • GraphDeviceObject : objet d’appareil retourné par l’API graph.