Get-ControlPanelItem

Модуль:

Microsoft.PowerShell.Management Module

Возвращает элементы панели управления.

Синтаксис

RegularName (По умолчанию)

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

CanonicalName

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

Описание

Командлет Get-ControlPanelItem получает элементы панели управления на локальном компьютере. Его можно использовать для поиска элементов панели управления по имени, категории или описанию, даже в системах, которые не имеют пользовательского интерфейса.

Этот командлет получает только элементы панели управления, которые можно открыть в системе. На компьютерах, не имеющих панели управления или проводника, этот командлет получает только элементы панели управления, которые могут открываться без этих компонентов.

Этот командлет был введён в Windows PowerShell 3.0. Он работает только в Windows 8 и Windows Server 2012 и более поздней версии.

Примеры

Пример 1. Получение всех элементов панели управления

Эта команда получает все элементы панели управления на локальном компьютере.

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

Пример 2. Получение элементов панели управления по имени

В этом примере возвращаются элементы панели управления с программами или приложением в их именах.

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

Пример 3. Получение элементов панели управления по категориям

Эта команда получает все элементы панели управления в категориях с безопасностью в именах.

Get-ControlPanelItem -Category "*Security*"

Пример 4. Открытие элемента панели управления

В этом примере откроется элемент панели управления брандмауэром Windows на локальном компьютере.

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

Командлет Get-ControlPanelItem получает элемент панели управления. Откроется командлет Show-ControlPanelItem.

Пример 5. Получение элементов панели управления на удаленном компьютере

В этом примере возвращается элемент панели управления шифрованием диска BitLocker на удаленном компьютере Server01. Командлет Invoke-Command удаленно выполняет командлет Get-ControlPanelItem.

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

Пример 6. Поиск по описаниям элементов панели управления

В этом примере выполняется поиск свойства описания элементов панели управления, чтобы получить только те, которые содержат имя устройства.

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

Командлет Get-ControlPanelItem получает все элементы панели управления. Командлет Where-Object фильтрует элементы по значению свойства Description.

Параметры

-CanonicalName

Указывает в виде строкового массива элементы панели управления по их каноническим именам или шаблонам имен, которые получает этот командлет. Подстановочные символы разрешены. При вводе нескольких имен этот командлет получает элементы панели управления, соответствующие любому из имен, как если бы элементы в списке имен были разделены оператором "или".

По умолчанию этот командлет получает все элементы панели управления в системе.

Свойства параметров

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	True
DontShow:	False

Наборы параметров

CanonicalName

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Category

Указывает в виде строкового массива категории элементов панели управления в указанных категориях, которые получает этот командлет. Введите имя категории или шаблон имени. Подстановочные символы разрешены. При вводе нескольких имен этот командлет получает элементы панели управления, соответствующие любому из имен, как если бы элементы в списке имен были разделены оператором "или". По умолчанию этот командлет получает все элементы панели управления в системе.

Свойства параметров

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	True
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Name

Указывает в виде строкового массива имена или шаблоны имен панели управления, которую получает этот командлет. Подстановочные символы разрешены. Вы также можете передать имя или шаблон имени в этот командлет.

Свойства параметров

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	True
DontShow:	False

Наборы параметров

RegularName

Position:	0
Обязательно:	False
Значение из конвейера:	True
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

String

Вы можете передать имя или шаблон имени в этот командлет.

Выходные данные

ControlPanelItem

Этот командлет получает элементы панели управления на локальном компьютере.

Связанные ссылки

• Показать элемент панели управления