WMI を使用して Surface Dock を管理する

  • [アーティクル]
  • 適用対象:
    Windows 10, Windows 11

Windows Management Instrumentation (WMI) のサポートでは、IT 管理者が Surface Dock 2 および Surface Thunderbolt 4 Dock デバイスの最新のファームウェア、ポリシー状態、および関連データをリモートで監視および管理できる豊富な診断情報が提供されます。 WMI は、Windows PowerShell、System Center Operations Manager、およびその他のツールで使用できます。 WMI の詳細については、「WMI の 操作」を参照してください。

WMI サポートを有効にする

Surface Thunderbolt 4 ドック

Surface Thunderbolt 4 Dock ファームウェアとドライバーに移動し、適切なパッケージをダウンロードします。

SurfaceDock_WmiInstanceProvider_Win10_Win11_19041_23.021.21048.0_x64.msi

  • Surface Pro (第 5 世代以降)
  • Surface Book (第 2 世代以降)
  • Surface Go (すべての世代)
  • Surface Laptop (すべての世代)
  • Surface Laptop Go (すべての世代)

SurfaceDock_WmiInstanceProvider_Win10_Win11_19041_23.021.21048.0_arm64.msi

  • Surface Pro 9 と 5G
  • Surface Pro X

Surface Dock 2

Surface Dock 2 ファームウェアとドライバーに移動し、適切なパッケージをダウンロードします。

SurfaceDock2_WmiInstanceProvider_Win10_17763_20.072.32423.0_x64.msi

  • Surface Pro (第 5 世代以降)
  • Surface Book (第 2 世代以降)
  • Surface Go (すべての世代)
  • Surface Laptop (すべての世代)
  • Surface Laptop Go (すべての世代)

SurfaceDock2_WmiInstanceProvider_Win10_17763_20.072.32491.0_arm64.msi

  • Surface Pro 9 と 5G
  • Surface Pro X

Surface Dock での WMI の使用

次の手順は、Surface Dock 2 と Surface Thunderbolt 4 Dock に適用されます。

  1. すべてのドック コンポーネント インスタンスを列挙するには:

    Get-CimInstance -Namespace "root/Surface" -Class "SurfaceDockComponent"

  2. WMI クラス プロパティの説明にアクセスするには、コマンド プロンプトを開き、WMI コマンドを入力します。 ここで、Property は表 1 に記載されているプロパティの 1 つです。

     Get-CimClass -Namespace "root/Surface" -Class "SurfaceDockComponent").CimClassProperties["<Property>"]

  • 例：バージョン共通情報モデル (CIM) プロパティの説明にアクセスするには、次のように入力します。

    (Get-CimClass -Namespace "root/Surface" -Class "SurfaceDockComponent").CimClassProperties["Version"].Qualifiers["Description"].Value

表 1. Surface Dock WMI リファレンス

プロパティ 型 予期される値 説明
ComponentName String Surface Thunderbolt 4 ドック

"マイクロコントローラー"
"Thunderbolt 4 Controller"
"USB Hub"
"Power Delivery Controller 1"
"Power Delivery Controller 2"
"Audio Codec"
"イーサネット コントローラー"

"DockSerialNumber"
(長さ: 14 - 0V3379X22463GH など)

Surface Dock 2
"マイクロコントローラー"
"USB Hub 1"
"USB Hub 2"
"Display Port Hub"
"Power Delivery Controller"
"Audio Codec"
"イーサネット コントローラー"		 次のプロパティは、付属の共通情報モデル (CIM) クラス データが対応するデバイス コンポーネントの特定の名前の一覧です。
DeviceName String "Surface Dock 1"
"Surface Dock 2"
"Microsoft Surface Thunderbolt 4 Dock"		 次のプロパティには、特定のデバイス コンポーネントが属しているドック デバイスの名前が含まれています。
DockSerialNumber String 数値のみを含む 12 桁 (12) 桁のシリアル番号 次のプロパティは、接続されているドック デバイスのシリアル番号を記録します。 このシリアル番号は、同じドック デバイスに属するすべてのコンポーネントでまったく同じです。 参考までに、このシリアル番号は Surface ドック自体の下側に物理的に見つけることができます。
Id Uint16 0, 1, 2, ..., 65535 次のプロパティは、0 (0) から始まり、カウントアップされる一意の ID です。 この変数は、列挙された WMI インスタンスの番号付けに使用されます。
LastUpdateStatus String "Success"
"PendingDockReattach"
"Failed"		 次のプロパティは、問題のデバイス コンポーネントに対して最後に試行されたコンポーネント ファームウェア更新 (CFU) 状態の詳細を示しています。 使用可能な値は、成功、保留中の Dock 再アタッチ、失敗です。


- 成功 は、以前に適用された新しいファームウェアが正常に適用されたことを示します
- Pending Dock Reattach は、デバイス コンポーネントに対して新しい更新プログラムが保留中であることを示し、ユーザーは新しい更新プログラムを適用するために Dock の Surface コネクタをデタッチして再アタッチする必要があります。
- 失敗は 、CFU プロセス中に正当なエラーが発生した可能性がある、または周辺機器が予期されるバージョンで起動しなかったことを示します。 失敗した場合、これはデバイスが動作していないことを示すものではなく、デバイスを更新しようとしたときにエラーが発生しました。 このような場合、以前のファームウェアは引き続き実行されます。
PolicyState String "有効"
"無効"		 次のプロパティは、デバイス コンポーネントの現在の Surface Enterprise Management Mode (SEMM) ポリシーを示します。 使用可能な値は、 有効 と 無効です。


- [有効] は、SEMM システムがホスト デバイスにデバイス コンポーネントへのアクセスと使用を許可したことを示します
- 無効 は、SEMM システムが許可されていないことを示し、それによってホスト マシンがデバイス コンポーネントにアクセスして使用することを妨げていることを示します。
ProductId String[] 各範囲が "0x0000" から "0xFFFF" になる 16 進文字列の一覧。 次のプロパティは、デバイス コンポーネントの製品 ID (PID) を分類します。 複数の PID が一覧表示される可能性があります。 たとえば、USB ハブの場合、Super Speed (SS) デバイスと高速 (HS) デバイスの両方が単一の "ハブ" に集中しています。したがって、2 つの (2) PID がこの配列内に一覧表示されます。
ProvisionedState ブール値 True または False 次のプロパティでは、Surface ドック デバイスの Surface Enterprise 管理モード (SEMM) プロビジョニング状態について説明します。 プロビジョニングされた状態は、同じドック デバイスに属するすべてのコンポーネントでまったく同じです。 使用可能な値は True または False です。 値が true の場合は、Surface Dock デバイスが現在管理されているため、ポート機能が制限される可能性があることを示します。 詳細については、「PolicyState」プロパティ フィールドを参照してください。 false の値は、Surface Dock デバイスが現在管理されておらず、機能制限が課されていないことを示します。
状態 String "OK"
"切断済み"
"エラー"
"Missing"
"DeviceHandleInUse"
"無効"
"NotSupportedByWmi"		 次のプロパティでは、ホスト コンピューターへの Dock の接続の状態について説明します。 使用可能な値は、OK、Disconnected、Error、Missing、DeviceHandleInUse、Disabled、NotSupportedByWmi です。
- [OK] は、デバイスがホスト コンピューターに正常に接続され、問題が存在しないことを示します。これにより、その機能が阻害されます
- [切断] は、すべてのデバイス コンポーネントの接続を提供する Surface コネクタが現在ホスト コンピューターに接続されていないことを示します。
- エラーは、デバイス インスタンスの潜在的な問題を示し、デバイス インターフェイスには、発生したエラーの種類に関する詳細な情報を得るための StatusCode プロパティチェック、デバイス マネージャーに黄色の感嘆符が付いている可能性が高くなります。
- 見つからない 場合は、デバイスがホスト コンピューターで列挙されると予想されていたが、何らかの理由で列挙されなかったことを示します。 StatusCode プロパティは、この誤った状況を示すために 24 の値を保持します。
- DeviceHandleInUse は、別のプロセスが現在デバイスと通信していることを示します。これにより、この Windows Management Instrumentation (WMI) インスタンス プロバイダーの通信要求が禁止されます。 WMI コマンドをもう一度実行してみてください。
- 無効は 、現在の Surface Enterprise Management Mode (SEMM) ポリシーが許可されていないことを示し、それによってホスト マシンがデバイス コンポーネントにアクセスして使用することを妨げてきたことを示します。 詳細については、 PolicyState プロパティ フィールドを参照してください。
- NotSupportedByWmi は、接続されたドックがこの WMI プロバイダーで現在サポートされていないことを示します。 この状態は、現在この WMI インスタンス プロバイダーではサポートされていない Surface Dock 1 に対して表示されます。
StatusCode Uint32 CIM_LogicalDevice WMI クラスから取得したデバイス マネージャーエラー コード (cimwin32.mof 内) 次のプロパティは、指定されたドック コンポーネントのデバイス マネージャーエラー コードを提供します。 値 0 (0) は、ドック コンポーネントが正しく動作していることを示します。0 より大きい値 (0) は、問題またはドック コンポーネントで発生する可能性のあるエラーを示します。 ドック コンポーネントは複数のデバイス インターフェイスで列挙できるため、他のデバイス マネージャーエラー コードがある可能性があります。 このプロパティ フィールドには、複数のエラー コードが使用可能な場合でも、1 つのエラー コードのみが一覧表示されます。 デバイス マネージャーは、特定のエラー コードが発生した場合にのみ、黄色の感嘆符でデバイスにラベルを付けます。
VendorId String "0x0000" から "0xFFFF" の範囲を指定できる 16 進文字列 次のプロパティは、デバイス コンポーネントの特定のベンダー ID (VID) を示しています。
バージョン String "x.y.z" という形式のバージョン文字列。x、y、z は数値です。 次のプロパティは、デバイス コンポーネントで現在実行されているファームウェアの現在のバージョンを指定します。

詳細情報