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
, используют неутвержденные глаголы. Эти командлеты являются историческими исключениями, и их глаголы классифицируются как зарезервированные.