Gestire Surface Dock con WMI
Il supporto di Strumentazione gestione Windows (WMI) offre un set completo di informazioni di diagnostica che consentono agli amministratori IT di monitorare e gestire in remoto il firmware, lo stato dei criteri e i dati correlati più recenti per i dispositivi Surface Dock 2 e Surface Thunderbolt 4 Dock. È possibile usare WMI con Windows PowerShell, System Center Operations Manager e altri strumenti. Per altre informazioni su WMI, vedere Uso di WMI.
Abilitare il supporto WMI
Surface Thunderbolt 4 Dock
Passare a Surface Thunderbolt 4 Dock Firmware and Drivers e scaricare il pacchetto appropriato:
SurfaceDock_WmiInstanceProvider_Win10_Win11_19041_23.021.21048.0_x64.msi
- Surface Pro (quinta generazione e versioni successive)
- Surface Book (seconda generazione e versioni successive)
- Surface Go (tutte le generazioni)
- Surface Laptop (tutte le generazioni)
- Surface Laptop Go (tutte le generazioni)
SurfaceDock_WmiInstanceProvider_Win10_Win11_19041_23.021.21048.0_arm64.msi
- Surface Pro 9 con 5G
- Surface Pro X
Surface Dock 2
Passare a Firmware e driver di Surface Dock 2 e scaricare il pacchetto appropriato:
SurfaceDock2_WmiInstanceProvider_Win10_17763_20.072.32423.0_x64.msi
- Surface Pro (quinta generazione e versioni successive)
- Surface Book (seconda generazione e versioni successive)
- Surface Go (tutte le generazioni)
- Surface Laptop (tutte le generazioni)
- Surface Laptop Go (tutte le generazioni)
SurfaceDock2_WmiInstanceProvider_Win10_17763_20.072.32491.0_arm64.msi
- Surface Pro 9 con 5G
- Surface Pro X
Uso di WMI con Surface Dock
Le istruzioni seguenti si applicano a Surface Dock 2 e Surface Thunderbolt 4 Dock.
Per enumerare tutte le istanze del componente di ancoraggio:
Get-CimInstance -Namespace "root/Surface" -Class "SurfaceDockComponent"Per accedere alle descrizioni delle proprietà della classe WMI, aprire un prompt dei comandi e immettere i comandi WMI dove Proprietà è una delle proprietà elencate nella tabella 1.
Get-CimClass -Namespace "root/Surface" -Class "SurfaceDockComponent").CimClassProperties["<Property>"]
Esempio: Per accedere alla descrizione per la proprietà CIM ( Version Common Information Model), immettere quanto segue:
(Get-CimClass -Namespace "root/Surface" -Class "SurfaceDockComponent").CimClassProperties["Version"].Qualifiers["Description"].Value
Tabella 1. Informazioni di riferimento su WMI per Surface Dock
| Proprietà | Tipo | Valore o i valori previsti | Descrizione |
|---|---|---|---|
| ComponentName | Stringa |
Surface Thunderbolt 4 Dock "Microcontroller" "Thunderbolt 4 Controller" "Hub USB" "Power Delivery Controller 1" "Power Delivery Controller 2" "Codec audio" "Controller Ethernet" "DockSerialNumber" (lunghezza: 14 - Ad esempio, 0V3379X22463GH) Surface Dock 2 "Microcontroller" "Hub USB 1" "Hub USB 2" "Display Port Hub" "Power Delivery Controller" "Codec audio" "Controller Ethernet" |
La proprietà seguente elenca il nome specifico del componente del dispositivo a cui corrispondono i dati della classe CIM (Common Information Model) corrispondenti. |
| DeviceName | Stringa | "Surface Dock 1" "Surface Dock 2" "Microsoft Surface Thunderbolt 4 Dock" |
La proprietà seguente contiene il nome del dispositivo di ancoraggio a cui appartiene il componente del dispositivo specifico. |
| DockSerialNumber | Stringa | Numero di serie di dodici (12) cifre contenente solo valori numerici | La proprietà seguente registra il numero di serie del dispositivo dock collegato. Questo numero di serie è esattamente lo stesso per ogni componente in quanto appartiene allo stesso dispositivo di ancoraggio. Per riferimento, questo numero di serie può essere trovato fisicamente sul lato inferiore del Surface Dock stesso. |
| Id | uint16 | 0, 1, 2, ..., 65535 | La proprietà seguente è un ID univoco che inizia da zero (0) e conta. Questa variabile viene usata per numerare le istanze WMI enumerate. |
| LastUpdateStatus | Stringa | "Operazione riuscita" "PendingDockReattach" "Non riuscito" |
La proprietà seguente descrive in dettaglio l'ultimo tentativo di aggiornamento del firmware del componente (CFU) per il componente del dispositivo in questione. I valori possibili sono: Success,Pending Dock Reattach e Failed. - Operazione riuscita indica che il nuovo firmware applicato in precedenza è stato applicato correttamente - In attesa di ricollegamento del dock indica che è in sospeso un nuovo aggiornamento per il componente del dispositivo e l'utente deve scollegare e ricollegare il connettore Surface del dock per applicare il nuovo aggiornamento. - Non riuscito indica che si è verificato un possibile errore legittimo durante il processo CFU o che la periferica non si è avviata nella versione prevista. Nel caso Non riuscito , questo non è un'indicazione che il dispositivo non funziona, ma piuttosto si è verificato un errore durante il tentativo di aggiornamento del dispositivo. In questo caso, il firmware precedente continua a essere eseguito. |
| PolicyState | Stringa | "Abilitato" "Disabilitato" |
La proprietà seguente indica i criteri semm (Surface Enterprise Management Mode) correnti per il componente dispositivo. I valori possibili sono: Abilitato e Disabilitato. - Abilitato indica che il sistema SEMM ha consentito al dispositivo host di accedere e usare il componente del dispositivo - Disabilitato indica che il sistema SEMM non è stato consentito e pertanto ha impedito al computer host di accedere e usare il componente del dispositivo. |
| ProductId | String[] | Elenco di stringhe esadecimali, che possono variare da "0x0000" a "0xFFFF" | La proprietà seguente classifica l'ID prodotto (PID) del componente del dispositivo. È possibile che siano elencati più PID. Nel caso di un hub USB, ad esempio, entrambi i dispositivi Super Speed (SS) e High Speed (HS) vengono raggruppati in un singolo "Hub". Pertanto, all'interno di questa matrice verranno elencati due (2) ID. |
| ProvisionedState | boolean | True o False | La proprietà seguente descrive lo stato di provisioning semm (Surface Enterprise Management Mode) del dispositivo Surface Dock. Lo stato sottoposto a provisioning è esattamente lo stesso per ogni componente in quanto appartiene allo stesso dispositivo di ancoraggio. I valori possibili sono: True o False. Il valore true indica che il dispositivo Surface Dock è attualmente gestito e pertanto la funzionalità della porta può essere limitata. Per altre informazioni, vedere il campo della proprietà "PolicyState". Il valore false indica che il dispositivo Surface Dock non è attualmente gestito e non prevede restrizioni di funzionalità. |
| Stato | Stringa | "OK" "Disconnesso" "Errore" "Mancante" "DeviceHandleInUse" "Disabilitato" "NotSupportedByWmi" |
La proprietà seguente descrive lo stato della connessione del dock al computer host. I valori possibili sono: OK,Disconnected,Error,Missing,DeviceHandleInUse,Disabled e NotSupportedByWmi. - OK indica che il dispositivo è connesso correttamente al computer host e che non esistono problemi, il che ne inibisce la funzionalità - Disconnesso indica che il connettore Surface, che fornisce la connessione per tutti i componenti del dispositivo, non è attualmente collegato al computer host. - L'errore indica un potenziale problema con l'istanza del dispositivo e l'interfaccia del dispositivo è stata più che probabilmente etichettata con un punto esclamativo giallo in Gestione dispositivi. Controllare la proprietà StatusCode per informazioni più dettagliate sul tipo di errore che si è verificato. - Mancante indica che il dispositivo avrebbe dovuto essere enumerato nel computer host, ma per qualche motivo non l'ha fatto. La proprietà StatusCode conterrà il valore 24 per indicare questa situazione errata. - DeviceHandleInUse indica che un altro processo sta attualmente comunicando con il dispositivo, il che impedisce a questo provider di istanze di Strumentazione gestione Windows (WMI) di eseguire le relative richieste di comunicazione. Provare a eseguire di nuovo il comando WMI. - Disabilitato indica che il criterio SEMM (Surface Enterprise Management Mode) corrente non è consentito e pertanto ha impedito al computer host di accedere e usare il componente del dispositivo. Per altre informazioni, vedere il campo della proprietà PolicyState . - NotSupportedByWmi indica che il dock connesso non è attualmente supportato da questo provider WMI. Questo stato viene visualizzato per Surface Dock 1, che attualmente non è supportato da questo provider di istanze WMI. |
| StatusCode | uint32 | Codice di errore di Gestione dispositivi ottenuto dalla classe WMI CIM_LogicalDevice (all'interno di cimwin32.mof) | La proprietà seguente fornisce il codice di errore di Gestione dispositivi per il componente di ancoraggio specificato. Il valore zero (0) indica che il componente di ancoraggio funziona correttamente; un valore maggiore di zero (0) indica un problema o un possibile errore con il componente di ancoraggio. Poiché il componente dock può essere enumerato con diverse interfacce del dispositivo, è possibile che siano presenti altri codici di errore di Gestione dispositivi. Questo campo di proprietà elenca solo un singolo codice di errore, anche se sono disponibili più. Gestione dispositivi etichetta il dispositivo con un punto esclamativo giallo solo quando si sono verificati determinati codici di errore. |
| Id fornitore | Stringa | Stringa esadecimale che può variare da "0x0000" a "0xFFFF" | La proprietà seguente prende nota dell'ID fornitore specifico (VID) del componente del dispositivo. |
| Versione | Stringa | Stringa di versione con il formato seguente: "x.y.z", dove x, y e z sono valori numerici. | La proprietà seguente specifica la versione corrente del firmware, attualmente in esecuzione nel componente del dispositivo. |