Поделиться через

Get-Verb

  • Ссылка
Модуль:
Microsoft.PowerShell.Core

Возвращает утвержденные команды PowerShell.

Синтаксис

Get-Verb
   [[-verb] <String[]>]

Описание

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

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

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

Заметка

Список команд, который Get-Verb возвращается, может быть не завершен. Обновленный список утвержденных команд PowerShell с описанием см. в утвержденных команд в документации Майкрософт.

Примеры

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

Get-Verb

Пример 2. Получение списка утвержденных команд, начинающихся с "un"

Get-Verb un*

Verb                 Group
----                 -----
Undo                 Common
Unlock               Common
Unpublish            Data
Uninstall            Lifecycle
Unregister           Lifecycle
Unblock              Security
Unprotect            Security

Пример 3. Получение всех утвержденных команд в группе безопасности

Get-Verb | Where-Object Group -EQ Security

Verb      Group
----      -----
Block     Security
Grant     Security
Protect   Security
Revoke    Security
Unblock   Security
Unprotect Security

Пример 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

Параметры

-verb

Возвращает только указанные команды. Введите имя команды или шаблона имени. Допустимы подстановочные знаки.

Тип:String[]
Position:1
Default value:All verbs
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:True

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

None

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

Selected.Microsoft.PowerShell.Commands.MemberDefinition

Примечания

Get-Verb возвращает измененную версию объекта Microsoft.PowerShell.Commands.MemberDefinition. Объект не имеет стандартных свойств объекта MemberDefinition. Вместо этого он имеет свойства Verb и Group. Свойство Verb содержит строку с именем команды. Свойство Group содержит строку с группой команд.

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

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

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

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