Gérer les stations d’accueil Surface avec WMI

Article
04/07/2023
S’applique à:

Windows 10, Windows 11

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) status 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 probablement été étiquetée avec un point d’exclamation jaune dans le Gestionnaire de périphériques , case activée 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. Cette status 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 Gestionnaire de périphériques obtenu à partir de la classe WMI CIM_LogicalDevice (dans cimwin32.mof)	La propriété suivante fournit le code d’erreur 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.