Get-Verb

Ссылка

Модуль:: Microsoft.PowerShell.Utility

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

Синтаксис

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.

Type:	String[]
Position:	0
Default value:	All verbs
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Verb

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

Type:	String[]
Accepted values:	Common, Communications, Data, Diagnostic, Lifecycle, Other, Security
Position:	1
Default value:	All groups
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	True

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

None

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

VerbInfo

Примечания

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

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

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

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

Import-Module