Get-Verb (Microsoft.PowerShell.Utility)

Get-Verb

Модуль:

Microsoft.PowerShell.Utility

Получает утвержденные команды PowerShell.

Синтаксис

Get-Verb
   [[-Verb] <String[]>]
   [[-Group] <String[]>]
   [<CommonParameters>]

Описание

Функция Get-Verb получает команды, разрешенные для использования в командах PowerShell.

Рекомендуется, чтобы имена командлетов и функций PowerShell имели формат Verb-Noun и включали утвержденный глагол. Такая практика делает имена команд более единообразными, предсказуемыми и простыми в использовании.

Команды, в которых используются неутвержденные глаголы, по-прежнему выполняются в PowerShell. Однако при импорте модуля, содержащего команду с неутвержденным глаголом в имени, команда Import-Module отображает предупреждающее сообщение.

Примеры

Пример 1. Получите список всех глаголов.

Get-Verb

Пример 2. Получите список разрешенных глаголов, которые начинаются с «un».

Get-Verb un*

Verb       AliasPrefix Group     Description
----       ----------- -----     -----------
Undo       un          Common    Sets a resource to its previous state
Unlock     uk          Common    Releases a resource that was locked
Unpublish  ub          Data      Makes a resource unavailable to others
Uninstall  us          Lifecycle Removes a resource from an indicated location
Unregister ur          Lifecycle Removes the entry for a resource from a repository
Unblock    ul          Security  Removes restrictions to a resource
Unprotect  up          Security  Removes safeguards from a resource that were added to prevent it from attack or loss

Пример 3. Получение всех утвержденных глаголов в группе «Безопасность».

Get-Verb -Group Security

Verb      AliasPrefix Group    Description
----      ----------- -----    -----------
Block     bl          Security Restricts access to a resource
Grant     gr          Security Allows access to a resource
Protect   pt          Security Safeguards a resource from attack or loss
Revoke    rk          Security Specifies an action that does not allow access to a resource
Unblock   ul          Security Removes restrictions to a resource
Unprotect up          Security Removes safeguards from a resource that were added to prevent it from attack or loss

Пример 4. Находит все команды в модуле, содержащие неодобренные глаголы.

Get-Command -Module Microsoft.PowerShell.Utility | Where-Object Verb -NotIn (Get-Verb).Verb

CommandType     Name            Version    Source
-----------     ----            -------    ------
Cmdlet          Sort-Object     3.1.0.0    Microsoft.PowerShell.Utility
Cmdlet          Tee-Object      3.1.0.0    Microsoft.PowerShell.Utility

Параметры

-Group

Получает только указанные группы. Введите название группы. Подстановочные знаки не допускаются.

Этот параметр был введен в PowerShell 6.0.

Тип :

String[]

Принятые значения:

Общие, коммуникации, данные, диагностика, жизненный цикл, другое, безопасность

Позиция:

1

Значение по умолчанию:

Все группы

Необходимый:

False

Примите ввод конвейера:

True

Принимайте подстановочные знаки:

False

-Verb

Получает только указанные глаголы. Введите название глагола или образец имени. Подстановочные знаки разрешены.

Тип :

String[]

Позиция:

0

Значение по умолчанию:

Все глаголы

Необходимый:

False

Примите ввод конвейера:

True

Принимайте подстановочные знаки:

True

Входы

Нет

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

Выходы

VerbInfo

Примечания

Глаголы PowerShell отнесены к группе в зависимости от их наиболее частого использования. Группы созданы для того, чтобы глаголы было легко находить и сравнивать, а не ограничивать их использование. Вы можете использовать любой утвержденный глагол для любого типа команды.

Каждая команда PowerShell отнесена к одной из следующих групп.

• Общее: определение общих действий, которые можно применить практически к любому командлету, например «Добавить».
• Связь. Определите действия, применимые к связи, например «Подключиться».
• Данные. Определите действия, применимые к обработке данных, например резервное копирование.
• Диагностика. Определите действия, применимые к диагностике, например «Отладка».
• Жизненный цикл. Определите действия, применимые к жизненному циклу командлета, например «Завершить».
• Безопасность. Определите действия, применимые к безопасности, например отзыв.
• Другое: Определите другие типы действий.

Некоторые командлеты, установленные с помощью PowerShell, например Tee-Object и Where-Object, используют неутвержденные команды. Эти командлеты являются историческими исключениями, и их команды классифицируются как зарезервированные.