Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Fix #4172 - name of firewall cpl changed #4196

Merged
merged 2 commits into from
Apr 22, 2019
Merged

Fix #4172 - name of firewall cpl changed #4196

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
418caf5
Fix #4172 - name of firewall cpl changed
Apr 22, 2019
1d6776d
fix typo
Apr 22, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
117 changes: 75 additions & 42 deletions reference/3.0/Microsoft.PowerShell.Management/Show-ControlPanelItem.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,74 +1,96 @@
---
ms.date: 06/09/2017
schema: 2.0.0
locale: en-us
keywords: powershell,cmdlet
online version: http://go.microsoft.com/fwlink/?LinkID=219983
external help file: Microsoft.PowerShell.Commands.Management.dll-Help.xml
title: Show-ControlPanelItem
external help file: Microsoft.PowerShell.Commands.Management.dll-Help.xml
keywords: powershell,cmdlet
locale: en-us
Module Name: Microsoft.PowerShell.Management
ms.date: 04/22/2019
online version: http://go.microsoft.com/fwlink/?LinkID=219983
schema: 2.0.0
title: Show-ControlPanelItem
---

# Show-ControlPanelItem

## SYNOPSIS
Opens control panel items.

## SYNTAX

### RegularName (Default)

```
Show-ControlPanelItem [-Name] <String[]> [<CommonParameters>]
```

### CanonicalName

```
Show-ControlPanelItem -CanonicalName <String[]> [<CommonParameters>]
```

### ControlPanelItem

```
Show-ControlPanelItem [[-InputObject] <ControlPanelItem[]>] [<CommonParameters>]
```

## 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, and you can pipe control panel items from Get-ControlPanelItem to **Show-ControlPanelItem**.

**Show-ControlPanelItem** searches only the 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.
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 and works on Windows 8, Windows Server 2012,
and higher versions.

This cmdlet is 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.
## EXAMPLES

### Example 1: Open a Control Panel Item
```
PS C:\> Show-ControlPanelItem -Name AutoPlay
```
### Example 1: Show a control panel item

This example launches the **AutoPlay** control panel item.

### Example 2: Pipe a control panel item to Show-ControlPanelItem
```powershell
Show-ControlPanelItem -Name "AutoPlay"
```
PS C:\> Get-ControlPanelItem -Name "Windows Firewall" | Show-ControlPanelItem

### Example 2: Pipe a control panel item to this cmdlet

This example opens the **Windows Defender Firewall** control panel item on the local computer.
The name of the Windows Firewall control panel item has changed over the versions of Windows. This
example uses a wildcard pattern to find the control panel item.

```powershell
Get-ControlPanelItem -Name "*Firewall" | Show-ControlPanelItem
```

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.
`Get-ControlPanelItem` gets the control panel item and the `Show-ControlPanelItem` cmdlet opens
it.

### Example 3: Use a file name to open a control panel item
```
PS C:\> appwiz

This example opens the **Programs and Features** control panel item by using its application name.

```powershell
appwiz.cpl
```

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.

This method is an alternative to using a **Show-ControlPanelItem** command.
> [!NOTE]
> In PowerShell, you can omit the .cpl file extension for control panel files because it's included
> in the value of the `$env:PathExt` environment variable.

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

### -CanonicalName
Opens control panel items with the specified canonical names or name patterns.
Wildcards are permitted.
If you enter multiple names, Get-ControlPanelItem opens the control panel items that match any of the names, as though the items in the name list were separated by an "or" operator.

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.

```yaml
Type: String[]
Expand All @@ -83,48 +105,59 @@ Accept wildcard characters: True
```

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

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

```yaml
Type: ControlPanelItem[]
Parameter Sets: ControlPanelItem
Aliases:

Required: False
Position: 1
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
```

### -Name
Opens control panel items with the specified names or name patterns.
Wildcards are permitted.
If you enter multiple names, Get-ControlPanelItem opens the control panel items that match any of the names, as though the items in the name list were separated by an "or" operator.

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.

```yaml
Type: String[]
Parameter Sets: RegularName
Aliases:

Required: True
Position: 1
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: True
```

### 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 (http://go.microsoft.com/fwlink/?LinkID=113216).

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose,
-WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).

## INPUTS

### System.String, Microsoft.PowerShell.Commands.ControlPanelItem
You can pipe a name or control panel item object to Show-ControlPanelItem.
### System.String, Microsoft.PowerShell.Commands.ControlPanelItem

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

## OUTPUTS

### None

This cmdlet does not return any output.

## NOTES

## RELATED LINKS
Expand Down
111 changes: 68 additions & 43 deletions reference/4.0/Microsoft.PowerShell.Management/Show-ControlPanelItem.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
---
ms.date: 06/09/2017
schema: 2.0.0
locale: en-us
keywords: powershell,cmdlet
online version: http://go.microsoft.com/fwlink/p/?linkid=293915
external help file: Microsoft.PowerShell.Commands.Management.dll-Help.xml
title: Show-ControlPanelItem
external help file: Microsoft.PowerShell.Commands.Management.dll-Help.xml
keywords: powershell,cmdlet
locale: en-us
Module Name: Microsoft.PowerShell.Management
ms.date: 04/22/2019
online version: http://go.microsoft.com/fwlink/p/?linkid=293915
schema: 2.0.0
title: Show-ControlPanelItem
---

# Show-ControlPanelItem

## SYNOPSIS
Expand All @@ -16,64 +16,81 @@ Opens control panel items.
## SYNTAX

### RegularName (Default)

```
Show-ControlPanelItem [-Name] <String[]> [<CommonParameters>]
```

### CanonicalName

```
Show-ControlPanelItem -CanonicalName <String[]> [<CommonParameters>]
```

### ControlPanelItem

```
Show-ControlPanelItem [[-InputObject] <ControlPanelItem[]>] [<CommonParameters>]
```

## 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, and you can pipe control panel items from Get-ControlPanelItem to **Show-ControlPanelItem**.

**Show-ControlPanelItem** searches only the 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.
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 is 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.
This cmdlet was introduced in Windows PowerShell 3.0 and works on Windows 8, Windows Server 2012,
and higher versions.

## EXAMPLES

### Example 1: Open a Control Panel Item
```
PS C:\> Show-ControlPanelItem -Name AutoPlay
```
### Example 1: Show a control panel item

This example launches the **AutoPlay** control panel item.

### Example 2: Pipe a control panel item to Show-ControlPanelItem
```powershell
Show-ControlPanelItem -Name "AutoPlay"
```
PS C:\> Get-ControlPanelItem -Name "Windows Firewall" | Show-ControlPanelItem

### Example 2: Pipe a control panel item to this cmdlet

This example opens the **Windows Defender Firewall** control panel item on the local computer.
The name of the Windows Firewall control panel item has changed over the versions of Windows. This
example uses a wildcard pattern to find the control panel item.

```powershell
Get-ControlPanelItem -Name "*Firewall" | Show-ControlPanelItem
```

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.
`Get-ControlPanelItem` gets the control panel item and the `Show-ControlPanelItem` cmdlet opens
it.

### Example 3: Use a file name to open a control panel item
```
PS C:\> appwiz
```

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 example opens the **Programs and Features** control panel item by using its application name.

This method is an alternative to using a **Show-ControlPanelItem** command.
```powershell
appwiz.cpl
```

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.
This method is an alternative to using a `Show-ControlPanelItem` command.

> [!NOTE]
> In PowerShell, you can omit the .cpl file extension for control panel files because it's included
> in the value of the `$env:PathExt` environment variable.

## PARAMETERS

### -CanonicalName
Opens control panel items with the specified canonical names or name patterns.
Wildcards are permitted.
If you enter multiple names, Get-ControlPanelItem opens the control panel items that match any of the names, as though the items in the name list were separated by an "or" operator.

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.

```yaml
Type: String[]
Expand All @@ -88,49 +105,57 @@ Accept wildcard characters: True
```

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

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

```yaml
Type: ControlPanelItem[]
Parameter Sets: ControlPanelItem
Aliases:

Required: False
Position: 1
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
```

### -Name
Opens control panel items with the specified names or name patterns.
Wildcards are permitted.
If you enter multiple names, Get-ControlPanelItem opens the control panel items that match any of the names, as though the items in the name list were separated by an "or" operator.

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.

```yaml
Type: String[]
Parameter Sets: RegularName
Aliases:

Required: True
Position: 1
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: True
```

### 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 (http://go.microsoft.com/fwlink/?LinkID=113216).

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose,
-WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).

## INPUTS

### System.String, Microsoft.PowerShell.Commands.ControlPanelItem
You can pipe a name or control panel item object to Show-ControlPanelItem.
### System.String, Microsoft.PowerShell.Commands.ControlPanelItem

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

## OUTPUTS

### None

This cmdlet does not return any output.

## NOTES
Expand Down
Loading