Partilhar via


Get-ControlPanelItem

Obtém itens do painel de controle.

Sintaxe

RegularName (Predefinição)

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 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 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 Criptografia de Unidade de Disco 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 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 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 estivessem separados por um operador "ou".

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

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

CanonicalName
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 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.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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. Curingas são permitidos. Você também pode canalizar um nome ou padrão de nome para esse cmdlet.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

RegularName
Position:0
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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 padrão de nome para esse cmdlet.

Saídas

ControlPanelItem

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