Get-PnpDevice
Get-PnpDevice
Returns information about PnP devices.
구문
Parameter Set: ByClass
Get-PnpDevice [-CimSession <CimSession[]> ] [-Class <String[]> ] [-InformationAction <System.Management.Automation.ActionPreference]> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String]> ] [-PresentOnly] [-ThrottleLimit <Int32> ] [ <CommonParameters>] [ <WorkflowParameters>]
Parameter Set: ByFriendlyName
Get-PnpDevice [-CimSession <CimSession[]> ] [-Class <String[]> ] [-FriendlyName <String[]> ] [-InformationAction <System.Management.Automation.ActionPreference]> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String]> ] [-PresentOnly] [-Status {OK | ERROR | DEGRADED | UNKNOWN}[] ] [-ThrottleLimit <Int32> ] [ <CommonParameters>] [ <WorkflowParameters>]
Parameter Set: ByInstanceId
Get-PnpDevice [[-InstanceId] <String[]> ] [-CimSession <CimSession[]> ] [-Class <String[]> ] [-InformationAction <System.Management.Automation.ActionPreference]> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String]> ] [-PresentOnly] [-Status {OK | ERROR | DEGRADED | UNKNOWN}[] ] [-ThrottleLimit <Int32> ] [ <CommonParameters>] [ <WorkflowParameters>]
Parameter Set: ByPresence
Get-PnpDevice [-CimSession <CimSession[]> ] [-Class <String[]> ] [-InformationAction <System.Management.Automation.ActionPreference]> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String]> ] [-PresentOnly] [-Status {OK | ERROR | DEGRADED | UNKNOWN}[] ] [-ThrottleLimit <Int32> ] [ <CommonParameters>] [ <WorkflowParameters>]
Parameter Set: ByStatus
Get-PnpDevice [-CimSession <CimSession[]> ] [-InformationAction <System.Management.Automation.ActionPreference]> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String]> ] [-Status {OK | ERROR | DEGRADED | UNKNOWN}[] ] [-ThrottleLimit <Int32> ] [ <CommonParameters>] [ <WorkflowParameters>]
자세한 설명
The Get-PnpDevice cmdlet returns basic information about Plug and Play (PnP) devices. The values returned are common to all devices.
매개 변수
-CimSession<CimSession[]>
원격 세션이나 원격 컴퓨터에서 cmdlet을 실행합니다. 컴퓨터 이름이나 New-CimSession 또는 Get-CimSession cmdlet의 출력과 같은 세션 개체를 입력하세요. 기본값은 로컬 컴퓨터 상의 현재 세션입니다.
별칭 |
Session |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-Class<String[]>
Specifies an array of PnP classes for devices. Some example values for this parameter are Monitor, DiskDrive, and Processor.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-FriendlyName<String[]>
Specifies an array of friendly names for devices.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
true(ByPropertyName) |
와일드카드 문자 허용 여부 |
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 |
필수 여부 |
false |
위치 |
1 |
기본값 |
none |
파이프라인 입력 허용 여부 |
true(ByPropertyName) |
와일드카드 문자 허용 여부 |
false |
-PresentOnly
Indicates that this cmdlet gets only those devices that are present when you issue the command. Present devices are physically in the system or attached to it.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-Status<String[]>
Specifies an array of current status values of devices. 이 매개 변수에 허용되는 값은 다음과 같습니다.
-- OK
-- ERROR
-- UNKNOWN
-- DEGRADED
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
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(https://go.microsoft.com/fwlink/p/?LinkID=113216)
<WorkflowParameters>
입력
입력 형식은 cmdlet으로 파이프할 수 있는 개체의 형식입니다.
출력
출력 형식은 cmdlet 실행 시 출력되는 개체의 형식입니다.
Microsoft.Management.Infrastructure.CimInstance#ROOT/Cimv2/Win32_PnPEntity[]
Microsoft.Management.Infrastructure.CimInstance
개체는 WMI(Windows Management Instrumentation) 개체를 표시하는 래퍼 클래스입니다. 파운드 기호(#
) 뒤의 경로는 기본 WMI 개체에 대한 네임 스페이스 및 클래스 이름을 제공합니다.
예
Example 1: Get all PnP devices
This command gets all devices known to PnP, whether they are present or not.
PS C:\> Get-PnpDevice
Example 2: Get PnP devices by name
This command gets all the devices named Generic USB Hub.
PS C:\> Get-PnpDevice -FriendlyName 'Generic USB Hub'
Example 3: Get PnP devices by ID
This command gets the device that has the specified instance ID.
PS C:\> Get-PnpDevice -InstanceId 'USB\VID_8087&PID_0024\5&3541780&0&1'
Example 4: Get present PnP devices in specified states
This command gets all present devices that report a status of error, degraded, or unknown.
PS C:\> Get-PnpDevice -PresentOnly -Status ERROR,DEGRADED,UNKNOWN
Example 5: Get PnP devices of a class
This command gets all the devices that belong to the specified PnP class.
PS C:\> Get-PnpDevice -Class 'Mouse'