Get-MsolDevice
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.
Liens associés
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour