Get-Verb
Возвращает утвержденные команды PowerShell.
Синтаксис
Default (По умолчанию)
Get-Verb
[[-verb] <String[]>]
[<CommonParameters>]
Описание
Функция 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[] |
| Default value: | All verbs |
| Поддерживаются подстановочные знаки: | True |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
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, используют неутвержденные глаголы. Эти командлеты являются историческими исключениями, и их глаголы классифицируются как зарезервированные.
