WMI로 Surface Dock 관리

아티클
07/04/2024
적용 대상:

Windows 10, Windows 11

WMI(Windows Management Instrumentation) 지원은 IT 관리자가 Surface Dock 2 및 Surface Thunderbolt 4 Dock 디바이스에 대한 최신 펌웨어, 정책 상태 및 관련 데이터를 원격으로 모니터링하고 관리할 수 있도록 하는 다양한 진단 정보 집합을 제공합니다. Windows PowerShell, System Center Operations Manager 및 기타 도구에서 WMI를 사용할 수 있습니다. WMI에 대한 자세한 내용은 WMI 작업을 참조하세요.

WMI 지원 사용

Surface Thunderbolt 4 Dock

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에 적용됩니다.

모든 도크 구성 요소 인스턴스를 열거하려면 다음을 수행합니다.
```
Get-CimInstance -Namespace "root/Surface" -Class "SurfaceDockComponent" 
```
WMI 클래스 속성 설명에 액세스하려면 명령 프롬프트를 열고 WMI 명령을 입력합니다. 여기서 Property 는 표 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	문자열	Surface Thunderbolt 4 Dock "마이크로 컨트롤러" "Thunderbolt 4 컨트롤러" "USB 허브" "전원 배달 컨트롤러 1" "전원 배달 컨트롤러 2" "오디오 코덱" "이더넷 컨트롤러" "DockSerialNumber" (length: 14 - 예: 0V3379X22463GH) Surface Dock 2 "마이크로 컨트롤러" "USB 허브 1" "USB Hub 2" "포트 허브 표시" "전원 배달 컨트롤러" "오디오 코덱" "이더넷 컨트롤러"	다음 속성은 함께 제공되는 CIM(공용 정보 모델) 클래스 데이터에 해당하는 디바이스 구성 요소의 특정 이름을 나열합니다.
DeviceName	문자열	"Surface Dock 1" "Surface Dock 2" "Microsoft Surface Thunderbolt 4 Dock"	다음 속성에는 특정 디바이스 구성 요소가 속한 도크 디바이스의 이름이 포함됩니다.
DockSerialNumber	문자열	숫자 값만 포함하는 12자리 숫자 일련 번호	다음 속성은 연결된 도크 디바이스의 일련 번호를 기록합니다. 이 일련 번호는 동일한 도크 디바이스에 속하는 모든 구성 요소에 대해 정확히 동일합니다. 참고로 이 일련 번호는 Surface Dock 자체의 아래쪽에서 물리적으로 찾을 수 있습니다.
Id	uint16	0, 1, 2, ..., 65535	다음 속성은 0에서 시작하여 계산되는 고유 ID입니다. 이 변수는 열거된 WMI 인스턴스의 번호를 매기는 데 사용됩니다.
LastUpdateStatus	문자열	"성공" "PendingDockReattach" "실패"	다음 속성은 문제의 디바이스 구성 요소에 대해 마지막으로 시도한 CFU(구성 요소 펌웨어 업데이트) 상태를 자세히 설명합니다. 가능한 값은 Success,Pending Dock Reattach 및Failed입니다. - 성공 은 이전에 적용된 새 펌웨어가 성공적으로 적용되었음을 나타냅니다. - 보류 중인 Dock 다시 연결 은 디바이스 구성 요소에 대해 보류 중인 새 업데이트가 있음을 나타내며 사용자는 새 업데이트를 적용하기 위해 Dock의 Surface 커넥터를 분리하고 다시 연결해야 합니다. - 실패는 CFU 프로세스 중에 가능한 합법적인 오류가 발생했거나 주변 장치가 예상 버전에서 부팅되지 않았음을 나타냅니다. 실패한 경우 디바이스가 작동하지 않는다는 표시가 아니라 디바이스를 업데이트하려고 할 때 잘못된 문제가 발생했습니다. 이 경우 이전 펌웨어가 계속 실행됩니다.
PolicyState	문자열	"사용" "사용 안 함"	다음 속성은 디바이스 구성 요소에 대한 현재 SEMM(Surface Enterprise Management Mode) 정책을 나타냅니다. 가능한 값은 사용 및 사용 안 함입니다. - 사용은 SEMM 시스템에서 호스트 디바이스가 디바이스 구성 요소에 액세스하고 사용하도록 허용했음을 나타냅니다. - 사용 안 함 은 SEMM 시스템이 허용되지 않음을 나타내며 이로 인해 호스트 컴퓨터가 디바이스 구성 요소에 액세스하고 사용하지 못하게 되었습니다.
ProductId	String[]	"0x0000"에서 "0xFFFF"에 이르기까지 다양할 수 있는 16진수 문자열 목록입니다.	다음 속성은 디바이스 구성 요소의 PID(제품 ID)를 분류합니다. 둘 이상의 PID가 나열될 수 있습니다. 예를 들어 USB 허브의 경우 SS(초고속) 및 HS(고속) 디바이스는 모두 단일 "허브"로 일괄 처리됩니다. 따라서 이 배열 내에 두 개의 (2) PID가 나열됩니다.
ProvisionedState	부울	True 또는 False	다음 속성은 Surface Dock 디바이스의 SEMM(Surface Enterprise Management Mode) 프로비전 상태를 설명합니다. 프로비전된 상태는 동일한 도크 디바이스에 속하는 모든 구성 요소에 대해 정확히 동일합니다. 가능한 값은 True 또는 False입니다. 값이 true이면 Surface Dock 디바이스가 현재 관리되므로 포트 기능이 제한될 수 있습니다. 자세한 내용은 "PolicyState" 속성 필드를 참조하세요. false 값은 Surface Dock 디바이스가 현재 관리되지 않으며 기능 제한이 부과되지 않음을 나타냅니다.
Status	문자열	"OK" "연결 끊김" "오류" "누락됨" "DeviceHandleInUse" "사용 안 함" "NotSupportedByWmi"	다음 속성은 호스트 컴퓨터에 대한 Dock 연결 상태를 설명합니다. 가능한 값은 OK,Disconnected,Error,Missing,DeviceHandleInUse,Disabled 및 NotSupportedByWmi입니다. - 확인 은 디바이스가 호스트 머신에 성공적으로 연결되었으며 문제가 없음을 나타내며, 이는 해당 기능을 저해합니다. - 연결 끊김은 모든 디바이스 구성 요소에 대한 연결을 제공하는 Surface 커넥터가 현재 호스트 컴퓨터에 연결되지 않았음을 나타냅니다. - 오류 는 디바이스 인스턴스와 관련된 잠재적인 문제를 나타내며 디바이스 인터페이스에 디바이스 관리자에서 노란색 느낌표로 레이블이 지정되었을 가능성이 더 큽니다. 발생한 오류 유형에 대한 자세한 내용은 StatusCode 속성을 확인하세요. - 누락 은 디바이스가 호스트 머신에 열거될 것으로 예상되었지만 어떤 이유로든 열거되지 않았음을 나타냅니다. StatusCode 속성은 이 잘못된 상황을 나타내기 위해 24 값을 보유합니다. - DeviceHandleInUse 는 다른 프로세스가 현재 디바이스와 통신하고 있음을 나타내며, 이 프로세스는 이 WMI(Windows Management Instrumentation) 인스턴스 공급자의 통신 요청을 금지합니다. WMI 명령을 다시 실행해 보세요! - 사용 안 함 은 현재 SEMM(Surface Enterprise Management Mode) 정책이 허용되지 않음을 나타내며, 이로 인해 호스트 컴퓨터가 디바이스 구성 요소에 액세스하고 사용하지 못하게 되었습니다. 자세한 내용은 PolicyState 속성 필드를 참조하세요. - NotSupportedByWmi 는 연결된 도크가 현재 이 WMI 공급자에서 지원되지 않음을 나타냅니다. 이 상태는 현재 이 WMI 인스턴스 공급자에서 지원되지 않는 Surface Dock 1에 대해 나타납니다.
StatusCode	uint32	CIM_LogicalDevice WMI 클래스에서 가져온 디바이스 관리자 오류 코드(cimwin32.mof 내)	다음 속성은 지정된 도크 구성 요소에 대한 Device Manager 오류 코드를 제공합니다. 값이 0이면 도크 구성 요소가 올바르게 작동하고 있음을 나타냅니다. 0보다 큰 값은 도크 구성 요소의 문제 또는 가능한 오류를 나타냅니다. 도크 구성 요소가 여러 디바이스 인터페이스로 열거될 수 있으므로 다른 디바이스 관리자 오류 코드가 있을 수 있습니다. 이 속성 필드는 여러 코드를 사용할 수 있는 경우에도 단일 오류 코드만 나열합니다. 디바이스 관리자는 특정 오류 코드가 발생한 경우에만 노란색 느낌표로 디바이스에 레이블을 지정합니다.
VendorId	문자열	"0x0000"에서 "0xFFFF"에 이르기까지 다양할 수 있는 16진수 문자열	다음 속성은 디바이스 구성 요소의 특정 VID(공급업체 ID)를 적어 줍니다.
버전	문자열	형식이 "x.y.z"인 버전 문자열입니다. 여기서 x, y 및 z는 숫자 값입니다.	다음 속성은 현재 디바이스 구성 요소에서 실행 중인 펌웨어의 현재 버전을 지정합니다.

다음을 통해 공유