Compartilhar via

Get-ControlPanelItem

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

Obtém itens do painel de controle.

Sintaxe

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

Description

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

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

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

Exemplos

Exemplo 1: Obter todos os itens do painel de controle

Esse 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

Esse 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 cmdlet Get-ControlPanelItem obtém o item do painel de controle. O cmdlet Show-ControlPanelItem o abre.

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

Este exemplo obtém o item do painel de controle de Criptografia de Unidade do BitLocker no computador remoto Server01. O cmdlet Invoke-Command executa o cmdlet Get-ControlPanelItem 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 somente 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 cmdlet Get-ControlPanelItem obtém todos os itens do painel de controle. O cmdlet Where-Object 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 fossem separados por um operador "ou".

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

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 um 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 fossem separados por um operador "ou". Por padrão, esse cmdlet obtém todos os itens do painel de controle no sistema.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 um padrão de nome para este cmdlet.

Tipo:String[]
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

Entradas

String

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

Saídas

ControlPanelItem

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