Get-PnpDeviceProperty

Windows Server 2016 and Windows 10

Get-PnpDeviceProperty

Gets detailed properties for a PnP device.

구문

Parameter Set: ByInstanceId
Get-PnpDeviceProperty [[-KeyName] <String[]> ] -InstanceId <String[]> [-CimSession <CimSession[]> ] [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}[] ] [-InformationVariable <System.String[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>] [ <WorkflowParameters>]

Parameter Set: InputObject (cdxml)
Get-PnpDeviceProperty [[-KeyName] <String[]> ] [-CimSession <CimSession[]> ] [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}[] ] [-InformationVariable <System.String[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>] [ <WorkflowParameters>]




자세한 설명

The Get-PnpDeviceProperty cmdlet gets detailed properties for a Plug and Play (PnP) device. You can specify a device by instance ID or by using the Get-PnpDevice cmdlet.

A device property is a key-value pair. A property key takes the form {GUID} PID. The property value is one of several types, such as UTF-8, GUID, Uint32, or Boolean. The output object contains the typed data of a value, and the value type. Many properties also have friendly names, in the form of DEVPKEY_XXX.

매개 변수

-CimSession<CimSession[]>

원격 세션이나 원격 컴퓨터에서 cmdlet을 실행합니다. 컴퓨터 이름이나 New-CimSession 또는 Get-CimSession cmdlet의 출력과 같은 세션 개체를 입력하세요. 기본값은 로컬 컴퓨터 상의 현재 세션입니다.


별칭

Session

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-InformationAction<System.Management.Automation.ActionPreference[]>

Specifies how this cmdlet responds to an information event. 이 매개 변수에 허용되는 값은 다음과 같습니다.

-- SilentlyContinue
-- Stop
-- Continue
-- Inquire
-- Ignore
-- Suspend


별칭

infa

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-InformationVariable<System.String[]>

Specifies a variable in which to store an information event message.


별칭

iv

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-InstanceId<String[]>

Specifies an array of unique instance ID of devices.


별칭

DeviceId

필수 여부

true

위치

named

기본값

none

파이프라인 입력 허용 여부

true(ByPropertyName)

와일드카드 문자 허용 여부

false

-KeyName<String[]>

Specifies an array of key names.


별칭

Key

필수 여부

false

위치

1

기본값

none

파이프라인 입력 허용 여부

true(ByPropertyName)

와일드카드 문자 허용 여부

false

-ThrottleLimit<Int32>

Cmdlet을 실행하도록 설정할 수 있는 동시 작업의 최대 수를 지정합니다. 이 매개 변수를 생략하거나 값으로 0 을 입력하면 Windows PowerShell®은 컴퓨터에서 실행 중인 CIM cmdlet의 수에 따라 cmdlet에 대한 최적의 스로틀 제한을 계산합니다. 스로틀 제한은 현재 cmdlet에만 적용되고, 세션이나 컴퓨터에는 적용되지 않습니다.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 TechNet의 about_CommonParameters(http://go.microsoft.com/fwlink/p/?LinkID=113216)

<WorkflowParameters>

입력

입력 형식은 cmdlet으로 파이프할 수 있는 개체의 형식입니다.

  • Microsoft.Management.Infrastructure.CimInstance#ROOT/Cimv2/Win32_PnPEntity[]

    Microsoft.Management.Infrastructure.CimInstance 개체는 WMI(Windows Management Instrumentation) 개체를 표시하는 래퍼 클래스입니다. 파운드 기호(#) 뒤의 경로는 기본 WMI 개체에 대한 네임 스페이스 및 클래스 이름을 제공합니다.


출력

출력 형식은 cmdlet 실행 시 출력되는 개체의 형식입니다.

  • System.Int32, Win32_PnPDeviceProperty[]

    This cmdlet generates an Int32 WMI success or failure code, or an array of Win32_PnPDeviceProperty objects that represent properties for a PnP device. A Win32_PnPDeviceProperty object contains the following fields:

    -- Device. The instance ID for the device with which this property is associated.
    -- KeyName. The friendly name for the property. If no friendly name exists, this matches the Key field.
    -- Key. The unique [GUID]-ID pairing representing the property.
    -- Data. The typed data associated with the key. This value is defined in the classes which inherit from Win32_PnPDeviceProperty. For example, a Win32PnPDevicePropertySint32 object would be returned for an Int32 property. Data would be an Int32 value in this case.
    -- Type. The type of the binary data. This is defined in the PnpDeviceProperty.Type enum.


참고

  • The objects returned by Get-PnpDeviceProperty are all of the (WMI Object) Win32_PnPDeviceProperty type. They are always of a WMI class inherited from Win32_PnPDeviceProperty. For example, a device may contain a String and signed Int32 properties. The cmdlet returns a Win32_PnPDeviceProperty array, where the first object in the array is a Win32_PnPDevicePropertyString object and the second is a Win32_PnPDevicePropertySint32 object. For each object type, there is a Data variable, of the given type, which contains the value of the property.

    The following is a full list of possible WMI classes and the type of the Data variable:

    -- Win32_PnPDevicePropertyUint8. Uint8.
    -- Win32_PnPDevicePropertyUint16. Uint16.
    -- Win32_PnPDevicePropertyUint32. Uint32.
    -- Win32_PnPDevicePropertyUint64. Uint64.
    -- Win32_PnPDevicePropertySint8. Sint8.
    -- Win32_PnPDevicePropertySint16. Sint16.
    -- Win32_PnPDevicePropertySint32. Sint32.
    -- Win32_PnPDevicePropertySint64. Sint64.
    -- Win32_PnPDevicePropertyString. String.
    -- Win32_PnPDevicePropertyBoolean. Boolean.
    -- Win32_PnPDevicePropertyReal32. Real32.
    -- Win32_PnPDevicePropertyReal64. Real64.
    -- Win32_PnPDevicePropertyDateTime. DateTime.
    -- Win32_PnPDevicePropertySecurityDescriptor. Win32_SecurityDescriptor.
    -- Win32_PnPDevicePropertyBinary. Uint8 array.
    -- Win32_PnPDevicePropertyUint16Array. Uint16 array.
    -- Win32_PnPDevicePropertyUint32Array. Uint32 array.
    -- Win32_PnPDevicePropertyUint64Array. Uint64 array.
    -- Win32_PnPDevicePropertySint8Array. Sint8 array.
    -- Win32_PnPDevicePropertySint16Array. Sint16 array.
    -- Win32_PnPDevicePropertySint32Array. Sint32 array.
    -- Win32_PnPDevicePropertySint64Array. Sint64 array.
    -- Win32_PnPDevicePropertyStringArray. String array.
    -- Win32_PnPDevicePropertyBooleanArray. Boolean array.
    -- Win32_PnPDevicePropertyReal32Array. Real32 array.
    -- Win32_PnPDevicePropertyReal64Array. Real64 array.
    -- Win32_PnPDevicePropertyDateTimeArray. DateTime array.
    -- Win32_PnPDevicePropertySecurityDescriptorArray. Win32_SecurityDescriptor array.

Example 1: Get properties for a device by using an ID

This command gets the PnP device properties for the device that has the specified ID.


PS C:\> Get-PnpDeviceProperty -InstanceId 'SWD\PRINTENUM\{E82E5EFD-6616-4E4F-9A96-7D94554A8BF0}'

Example 2: Get properties for a device by using the pipeline

This command uses the Get-PnpDevice cmdlet to get the PnP device that has the specified ID. The command passes that object to the current cmdlet by using the pipeline operator. The current command gets the device properties for that device.


PS C:\> Get-PnpDevice -InstanceId 'SWD\PRINTENUM\{E82E5EFD-6616-4E4F-9A96-7D94554A8BF0}' | Get-PnpDeviceProperty

Example 3: Get properties by using GUID-ID pairs

This command gets some of the properties of the PnP device that has the specified instance ID. The command specifies three key names of properties to get. The command specifies names as GUID-ID pairs.


PS C:\> Get-PnpDeviceProperty -KeyName '{A45C254E-DF1C-4EFD-8020-67D146A850E0} 2', '{A45C254E-DF1C-4EFD-8020-67D146A850E0} 10', '{4340A6C5-93FA-4706-972C-7B648008A5A7} 3' -InstanceId 'SWD\PRINTENUM\{E82E5EFD-6616-4E4F-9A96-7D94554A8BF0}'

Example 4: Get properties by using DEVPKEY names

This command gets some of the properties of the PnP device that has the specified instance ID. The command specifies three key names of properties to get. The command specifies names as DEVPKEY short names.


PS C:\> Get-PnpDeviceProperty -KeyName 'DEVPKEY_Device_DeviceDesc', 'DEVPKEY_Device_ClassGuid', 'DEVPKEY_Device_ProblemCode' -InstanceId 'SWD\PRINTENUM\{E82E5EFD-6616-4E4F-9A96-7D94554A8BF0}'

관련 항목

커뮤니티 추가 항목

추가
표시: