Partilhar via

Get-ControlPanelItem

  • Referência
Módulo:
Microsoft.PowerShell.Management

Obtém itens do painel de controle.

Syntax

Get-ControlPanelItem
   [[-Name] <String[]>]
   [-Category <String[]>]
   [<CommonParameters>]
Get-ControlPanelItem
   -CanonicalName <String[]>
   [-Category <String[]>]
   [<CommonParameters>]

Description

O Get-ControlPanelItem cmdlet obtém itens do painel de controle no computador local. Você pode usá-lo para encontrar itens do painel de controle por nome, categoria ou descrição, mesmo em sistemas que não têm uma interface de usuário.

Este cmdlet obtém apenas os itens do painel de controle que podem ser abertos no sistema. Em computadores que não têm Painel de Controle ou Explorador de Arquivos, esse cmdlet obtém apenas itens do painel de controle que podem ser abertos sem esses componentes.

Este cmdlet foi introduzido no Windows PowerShell 3.0. Ele funciona apenas no Windows 8 e Windows Server 2012 e mais recentes.

Exemplos

Exemplo 1: Obter todos os itens do painel de controle

Este comando obtém todos os itens do painel de controle no computador local.

Get-ControlPanelItem

Name                          CanonicalName                 Category                      Description
----                          -------------                 --------                      -----------
Action Center                 Microsoft.ActionCenter        {System and Security}         Review recent messages and...
Administrative Tools          Microsoft.AdministrativeTools {System and Security}         Configure administrative s...
AutoPlay                      Microsoft.AutoPlay            {Hardware}                    Change default settings fo...
BitLocker Drive Encryption    Microsoft.BitLockerDriveEn... {System and Security}         Protect your computer usin...
Color Management              Microsoft.ColorManagement     {All Control Panel Items}     Change advanced color mana...
Credential Manager            Microsoft.CredentialManager   {User Accounts}               Manage your Windows Creden...
Date and Time                 Microsoft.DateAndTime         {Clock, Language, and Region} Set the date, time, and ti...
...

Exemplo 2: Obter itens do painel de controle por nome

Este exemplo obtém itens do painel de controle que têm Programa ou Aplicativo em seus nomes.

Get-ControlPanelItem -Name "*Program*", "*App*"

Exemplo 3: Obter itens do painel de controle por categoria

Este comando obtém todos os itens do painel de controle em categorias que têm Segurança em seus nomes.

Get-ControlPanelItem -Category "*Security*"

Exemplo 4: Abrir um item do painel de controle

Este exemplo abre o item do painel de controle do Firewall do Windows no computador local.

Get-ControlPanelItem -Name "Windows Firewall" | Show-ControlPanelItem

O Get-ControlPanelItem cmdlet obtém o item do painel de controle. O Show-ControlPanelItem cmdlet o abre.

Exemplo 5: Obter itens do painel de controle em um computador remoto

Este exemplo obtém o item do painel de controle Criptografia de Unidade de Disco BitLocker no computador remoto Server01. O Invoke-Command cmdlet executa o Get-ControlPanelItem cmdlet remotamente.

Invoke-Command -ComputerName "Server01" {Get-ControlPanelItem -Name "BitLocker*" }

Exemplo 6: Pesquisar as descrições dos itens do painel de controle

Este exemplo pesquisa a propriedade Description dos itens do painel de controle para obter apenas aqueles que contêm o nome Device.

Get-ControlPanelItem | Where-Object {$_.Description -like "*Device*"}

Name                    CanonicalName                 Category    Description
----                    -------------                 --------    -----------
AutoPlay                Microsoft.AutoPlay            {Hardware}  Change default settings fo...
Devices and Printers    Microsoft.DevicesAndPrinters  {Hardware}  View and manage devices, p...
Sound                   Microsoft.Sound               {Hardware}  Configure your audio devic...

O Get-ControlPanelItem cmdlet obtém todos os itens do painel de controle. O Where-Object cmdlet filtra os itens pelo valor da propriedade Description .

Parâmetros

-CanonicalName

Especifica, como uma matriz de cadeia de caracteres, os itens do painel de controle por seus nomes canônicos ou padrões de nome que esse cmdlet obtém. Curingas são permitidos. Se você inserir vários nomes, esse cmdlet obterá itens do painel de controle que correspondem a qualquer um dos nomes, como se os itens na lista de nomes estivessem separados por um operador "ou".

Por padrão, esse cmdlet obtém todos os itens do painel de controle no sistema.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-Category

Especifica, como uma matriz de cadeia de caracteres, as categorias dos itens do painel de controle nas categorias especificadas que esse cmdlet obtém. Insira um nome de categoria ou padrão de nome. Curingas são permitidos. Se você inserir vários nomes, esse cmdlet obterá itens do painel de controle que correspondem a qualquer um dos nomes, como se os itens na lista de nomes estivessem separados por um operador "ou". Por padrão, esse cmdlet obtém todos os itens do painel de controle no sistema.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Name

Especifica, como uma matriz de cadeia de caracteres, os nomes ou padrões de nome do painel de controle que esse cmdlet obtém. Curingas são permitidos. Você também pode canalizar um nome ou padrão de nome para esse cmdlet.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

Entradas

String

Você pode canalizar um nome ou padrão de nome para esse cmdlet.

Saídas

ControlPanelItem

Este cmdlet obtém itens do painel de controle no computador local.