Get-PnpDevice

Get-PnpDevice

Returns information about PnP devices.

Syntaxe

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>]

Description détaillée

The Get-PnpDevice cmdlet returns basic information about Plug and Play (PnP) devices. The values returned are common to all devices.

Paramètres

-CimSession<CimSession[]>

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tels que le résultat d'une applet de commande New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

-Class<String[]>

Specifies an array of PnP classes for devices. Some example values for this parameter are Monitor, DiskDrive, and Processor.

-FriendlyName<String[]>

Specifies an array of friendly names for devices.

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

Specifies how this cmdlet responds to an information event. Les valeurs acceptables pour ce paramètre sont les suivantes : 

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

-InformationVariable<System.String]>

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

-InstanceId<String[]>

Specifies an array of unique instance ID of devices.

-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.

-Status<String[]>

Specifies an array of current status values of devices. Les valeurs acceptables pour ce paramètre sont les suivantes : 

-- OK
-- ERROR
-- UNKNOWN
-- DEGRADED

-ThrottleLimit<Int32>

Spécifie le nombre maximal d'opérations simultanées qui peuvent être établies pour exécuter l'applet de commande. Si ce paramètre est omis ou si la valeur 0 est entrée, Windows PowerShell® calcule un seuil de limitation optimal pour l'applet de commande en fonction du nombre d'applets de commande CIM exécutées sur l'ordinateur. Le seuil de limitation s'applique uniquement à l'applet de commande en cours, non pas à la session ou à l'ordinateur.

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez  . about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

<WorkflowParameters>

Entrées

Le type d'entrée correspond au type des objets que vous pouvez adresser à l'applet de commande.

Sorties

Le type de sortie correspond au type des objets que l'applet de commande émet.

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

  L'objet Microsoft.Management.Infrastructure.CimInstance est une classe de wrapper qui affiche les objets WMI (Windows Management Instrumentation). Le chemin après le symbole # fournit l'espace de noms et le nom de classe de l'objet WMI sous-jacent.

Exemples

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'

Rubriques connexes

Disable-PnpDevice

Enable-PnpDevice