Compartilhar via


Get-ControlPanelItem

Obtém itens do painel de controle.

Sintaxe

RegularName (Default)

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

CanonicalName

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

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

CanonicalName
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

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

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-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. Caracteres curinga são permitidos. Você também pode canalizar um nome ou um padrão de nome para este cmdlet.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

RegularName
Cargo:0
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

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.