Show-ControlPanelItem

Updated: August 9, 2015

Show-ControlPanelItem

Opens control panel items.

Syntax

Parameter Set: RegularName
Show-ControlPanelItem [-Name] <String[]> [ <CommonParameters>]

Parameter Set: CanonicalName
Show-ControlPanelItem -CanonicalName <String[]> [ <CommonParameters>]

Parameter Set: ControlPanelItem
Show-ControlPanelItem [[-InputObject] <ControlPanelItem[]> ] [ <CommonParameters>]




Detailed Description

The Show-ControlPanelItem cmdlet opens control panel items on the local computer. You can use it to open control panel items by name, category, or description, even on systems that do not have a user interface. You can pipe control panel items from the Get-ControlPanelItem cmdlet to Show-ControlPanelItem.

Show-ControlPanelItem searches only control panel items that can be opened on the system. On computers that do not have Control Panel or File Explorer, Show-ControlPanelItem searches only control panel items that can open without these components.

This cmdlet was introduced in Windows PowerShell 3.0. It works only on Windows 8 and Windows Server 2012. Because this cmdlet requires a user interface, it does not work on Server Core installations of Windows Server.

Parameters

-CanonicalName<String[]>

Specifies control panel items by using the specified canonical names or name patterns. Wildcard characters are permitted. If you enter multiple names, this cmdlet opens control panel items that match any of the names, as if the items in the name list were separated by an OR operator.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-InputObject<ControlPanelItem[]>

Specifies control panel items to open by submitting control panel item objects. Enter a variable that contains control panel item objects, or type a command or expression that gets control panel item objects, such as Get-ControlPanelItem.


Aliases

none

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Name<String[]>

Specifies names of control panel items. Wildcard characters are permitted. If you enter multiple names, this cmdlet opens control panel items that match any of the names, as if the items in the name list were separated by an OR operator.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue, ByPropertyName)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see    about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • System.String, Microsoft.PowerShell.Commands.ControlPanelItem

    You can pipe a name or control panel item object to this cmdlet.


Outputs

The output type is the type of the objects that the cmdlet emits.

  • None

    This cmdlet does not return any output.


Examples

Example 1: Show a control panel item

This command shows the AutoPlay item.


PS C:\> Show-ControlPanelItem –Name "AutoPlay"

Example 2: Pipe a control panel item to this cmldet

This command opens the Windows Firewall control panel item on the local computer. It uses the Get-ControlPanelItem cmdlet to get the control panel item and the Show-ControlPanelItem cmdlet to open it.


PS C:\> Get-ControlPanelItem –Name "Windows Firewall" | Show-ControlPanelItem

Example 3: Use a file name to open a control panel item

This command opens the Programs and Features control panel item by using its application name. The .cpl file name extension is not required in the command.

This method is an alternative to using a Show-ControlPanelItem command.

In Windows PowerShell 3.0, you can omit the .cpl file name extension for control panel item files because it is included in the value of the PathExt environment variable.


PS C:\> appwiz

Related topics

Community Additions

ADD
Show: