Gérer les stations d’accueil Surface avec WMI
La prise en charge de Windows Management Instrumentation (WMI) fournit un ensemble complet d’informations de diagnostic permettant aux administrateurs informatiques de surveiller et de gérer à distance les derniers microprogrammes, l’état de stratégie et les données associées pour les appareils Station d’accueil Surface 2 et Surface Thunderbolt 4. Vous pouvez utiliser WMI avec Windows PowerShell, System Center Operations Manager et d’autres outils. Pour plus d’informations sur WMI, consultez Utilisation de WMI.
Activer la prise en charge de WMI
Station d’accueil Surface Thunderbolt 4
Accédez au microprogramme et aux pilotes du dock Surface Thunderbolt 4 et téléchargez le package approprié :
SurfaceDock_WmiInstanceProvider_Win10_Win11_19041_23.021.21048.0_x64.msi
- Surface Pro (cinquième génération et versions ultérieures)
- Surface Book (deuxième génération et versions ultérieures)
- Surface Go (toutes les générations)
- Surface Laptop (toutes les générations)
- Surface Laptop Go (toutes les générations)
SurfaceDock_WmiInstanceProvider_Win10_Win11_19041_23.021.21048.0_arm64.msi
- Surface Pro 9 avec 5G
- Surface Pro X
Station d’accueil Surface 2
Accédez au microprogramme et aux pilotes de la station d’accueil Surface 2 et téléchargez le package approprié :
SurfaceDock2_WmiInstanceProvider_Win10_17763_20.072.32423.0_x64.msi
- Surface Pro (cinquième génération et versions ultérieures)
- Surface Book (deuxième génération et versions ultérieures)
- Surface Go (toutes les générations)
- Surface Laptop (toutes les générations)
- Surface Laptop Go (toutes les générations)
SurfaceDock2_WmiInstanceProvider_Win10_17763_20.072.32491.0_arm64.msi
- Surface Pro 9 avec 5G
- Surface Pro X
Utilisation de WMI avec la station Surface
Les instructions suivantes s’appliquent à la station Surface Dock 2 et à la station Surface Thunderbolt 4.
Pour énumérer toutes les instances de composant d’ancrage :
Get-CimInstance -Namespace "root/Surface" -Class "SurfaceDockComponent"Pour accéder aux descriptions des propriétés de classe WMI, ouvrez une invite de commandes et entrez les commandes WMI où Property est l’une des propriétés répertoriées dans le tableau 1.
Get-CimClass -Namespace "root/Surface" -Class "SurfaceDockComponent").CimClassProperties["<Property>"]
Exemple: Pour accéder à la description de la propriété CIM ( Version Common Information Model), entrez les éléments suivants :
(Get-CimClass -Namespace "root/Surface" -Class "SurfaceDockComponent").CimClassProperties["Version"].Qualifiers["Description"].Value
Tableau 1. Informations de référence sur WMI de la station Surface
| Propriété | Type | Valeur(s) attendue(s) | Description |
|---|---|---|---|
| ComponentName | Chaîne |
Station d’accueil Surface Thunderbolt 4 « Microcontrôleur » « Contrôleur Thunderbolt 4 » « Hub USB » « Power Delivery Controller 1 » « Power Delivery Controller 2 » « Codec audio » « Contrôleur Ethernet » « DockSerialNumber » (longueur : 14 - Par exemple, 0V3379X22463GH) Station d’accueil Surface 2 « Microcontrôleur » « Hub USB 1 » « Hub USB 2 » « Hub de port d’affichage » « Power Delivery Controller » « Codec audio » « Contrôleur Ethernet » |
La propriété suivante répertorie le nom spécifique du composant d’appareil auquel correspondent les données de classe CIM (Common Information Model) associées. |
| DeviceName | Chaîne | « Station d’accueil Surface 1 » « Station d’accueil Surface 2 » « Station d’accueil Microsoft Surface Thunderbolt 4 » |
La propriété suivante contient le nom de l’appareil d’accueil auquel appartient le composant d’appareil spécifique. |
| DockSerialNumber | Chaîne | Un numéro de série à douze (12) chiffres contenant uniquement des valeurs numériques | La propriété suivante enregistre le numéro de série de l’appareil de station d’accueil attaché. Ce numéro de série est exactement le même pour chaque composant, car il appartient au même appareil d’accueil. Pour référence, ce numéro de série se trouve physiquement sur la face inférieure de la station d’accueil Surface elle-même. |
| ID | uint16 | 0, 1, 2, ..., 65535 | La propriété suivante est un ID unique qui commence à zéro (0) et compte jusqu’à . Cette variable est utilisée pour la numérotation des instances WMI énumérées. |
| LastUpdateStatus | Chaîne | « Réussite » « PendingDockReattach » « Échec » |
La propriété suivante détaille la dernière tentative de mise à jour du microprogramme du composant (CFU) pour le composant d’appareil en question. Les valeurs possibles sont : Success,Pending Dock Reattach et Failed. - La réussite indique que le nouveau microprogramme précédemment appliqué a été appliqué avec succès - Le rattachement de la station d’accueil en attente indique qu’une nouvelle mise à jour est en attente pour le composant de l’appareil et que l’utilisateur doit détacher et rattacher le connecteur Surface de la station d’accueil afin d’appliquer la nouvelle mise à jour. - Échec indique qu’une erreur légitime possible s’est produite pendant le processus CFU ou que le périphérique n’a pas démarré dans la version attendue. Dans le cas d’échec , cela n’indique pas que l’appareil ne fonctionne pas, mais plutôt qu’une erreur s’est produite lors de la tentative de mise à jour de l’appareil. Dans ce cas, le microprogramme précédent continue de s’exécuter. |
| PolicyState | Chaîne | « Activé » « Désactivé » |
La propriété suivante indique la stratégie SEMM (Mode de gestion Entreprise) surface actuelle pour le composant de l’appareil. Les valeurs possibles sont : Activé et Désactivé. - Activé indique que le système SEMM a autorisé l’appareil hôte à accéder au composant d’appareil et à l’utiliser. - Désactivé indique que le système SEMM n’est pas autorisé et a donc empêché l’ordinateur hôte d’accéder au composant de l’appareil et de l’utiliser. |
| ProductId | String[] | Liste de chaînes hexadécimale, qui peuvent aller de « 0x0000 » à « 0xFFFF » | La propriété suivante classifie l’ID de produit (PID) du composant d’appareil. Il est possible qu’il y ait plusieurs PID répertoriés. Dans le cas d’un hub USB, par exemple, les appareils super vitesse (SS) et haute vitesse (HS) sont regroupés dans un « hub » singulier. Par conséquent, deux (2) PID sont répertoriés dans ce tableau. |
| ProvisionedState | booléen | True ou False | La propriété suivante décrit l’état provisionné du mode SEMM (Surface Enterprise Management Mode) de l’appareil Surface Dock. L’état provisionné est exactement le même pour chaque composant, car il appartient au même appareil d’accueil. Les valeurs possibles sont : True ou False. La valeur true indique que l’appareil De station d’accueil Surface est actuellement géré et que la fonctionnalité de port peut donc être limitée. Pour plus d’informations, consultez le champ de propriété « PolicyState ». La valeur false indique que l’appareil De station d’accueil Surface n’est actuellement pas géré et qu’aucune restriction de fonctionnalité n’est imposée. |
| Statut | Chaîne | « OK » « Déconnecté » « Erreur » « Manquant » « DeviceHandleInUse » « Désactivé » « NotSupportedByWmi » |
La propriété suivante décrit l’état de la connexion du Dock à l’ordinateur hôte. Les valeurs possibles sont : OK,Disconnected,Error,Missing,DeviceHandleInUse,Disabled et NotSupportedByWmi. - OK indique que l’appareil est correctement connecté à l’ordinateur hôte et qu’il n’existe aucun problème, ce qui empêcherait ses fonctionnalités - Déconnecté indique que le connecteur Surface, qui fournit la connexion pour tous les composants de l’appareil, n’est actuellement pas attaché à l’ordinateur hôte. - L’erreur indique un problème potentiel avec l’instance de l’appareil et l’interface de l’appareil a plus que probablement été étiquetée avec un point d’exclamation jaune dans le Gestionnaire de périphériques. Vérifiez la propriété StatusCode pour obtenir des informations plus détaillées sur le type d’erreur qui s’est produite. - Manquant indique que l’appareil était censé avoir énuméré sur l’ordinateur hôte, mais pour une raison quelconque, ce n’est pas le cas. La propriété StatusCode contient la valeur 24 pour indiquer cette situation erronée. - DeviceHandleInUse indique qu’un autre processus communique actuellement avec l’appareil, ce qui interdit à ce fournisseur d’instances WMI (Windows Management Instrumentation) de ses demandes de communication. Réessayez d’exécuter votre commande WMI ! - Désactivé indique que la stratégie actuelle du mode de gestion d’entreprise (SEMM) surface n’a pas été autorisée et a donc empêché l’ordinateur hôte d’accéder au composant de l’appareil et de l’utiliser. Pour plus d’informations, consultez le champ de propriété PolicyState . - NotSupportedByWmi indique que la station d’accueil connectée n’est actuellement pas prise en charge par ce fournisseur WMI. Cet état s’affiche pour la station d’accueil Surface 1, qui n’est actuellement pas prise en charge par ce fournisseur d’instances WMI. |
| StatusCode | uint32 | Code d’erreur device Manager obtenu à partir de la classe WMI CIM_LogicalDevice (dans cimwin32.mof) | La propriété suivante fournit le code d’erreur du Gestionnaire de périphériques pour le composant d’ancrage donné. La valeur zéro (0) indique que le composant dock fonctionne correctement ; Une valeur supérieure à zéro (0) indique un problème ou une erreur possible avec le composant dock. Étant donné que le composant dock peut énumérer avec plusieurs interfaces d’appareil, il est possible qu’il y ait d’autres codes d’erreur gestionnaire de périphériques. Ce champ de propriété répertorie uniquement un seul code d’erreur, même si plusieurs sont disponibles. Le Gestionnaire de périphériques étiquette l’appareil avec un point d’exclamation jaune uniquement lorsque certains codes d’erreur se sont produits. |
| VendorId | Chaîne | Chaîne hexadécimale qui peut aller de « 0x0000 » à « 0xFFFF » | La propriété suivante indique l’ID de fournisseur (VID) spécifique du composant d’appareil. |
| Version | Chaîne | Chaîne de version, qui a la forme suivante : « x.y.z », où x, y et z sont des valeurs numériques. | La propriété suivante spécifie la version actuelle du microprogramme, qui est actuellement en cours d’exécution sur le composant de l’appareil. |