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


Get-Verb

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

Синтаксис

Default (по умолчанию)

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

Описание

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

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

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

Замечание

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

Примеры

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

Default value:All groups
Допустимые значения:Common, Communications, Data, Diagnostic, Lifecycle, Other, Security
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-Verb

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

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

Тип:

String[]

Default value:All verbs
Поддерживаются подстановочные знаки:True
DontShow:False

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

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

CommonParameters

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

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

None

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

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

VerbInfo

Примечания

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

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

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

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