Get-Verb
获取已批准的 PowerShell 谓词。
语法
Get-Verb
[[-verb] <String[]>]
[<CommonParameters>]
说明
Get-Verb
函数获取被批准在 PowerShell 命令中使用的谓词。
PowerShell 建议 cmdlet 和函数名称采用 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 - 获取 Security 组中所有已批准的谓词
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
仅获取指定的谓词。 输入谓词的名称或名称模式。 允许使用通配符。
Type: | String[] |
Position: | 1 |
Default value: | All verbs |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
输入
None
输出
Selected.Microsoft.PowerShell.Commands.MemberDefinition
备注
Get-Verb
返回 Microsoft.PowerShell.Commands.MemberDefinition 对象的修改后版本。 该对象没有 MemberDefinition 对象的标准属性。 而是具有 Verb 和 Group 属性。 Verb 属性包含带有谓词名称的字符串。
Group 属性包含带有谓词组的字符串。
根据 PowerShell 谓词最常见的用途,将它们分配给组。 谓词组旨在简化谓词的查找和比较,而不会限制谓词的使用。 对于任意类型的命令,均可使用任何批准的谓词。
将每个 PowerShell 谓词分配给以下组之一。
- Common:定义可应用于几乎所有的 cmdlet 的通用操作,例如 Add。
- Communications:定义可应用于通信的操作,例如 Connect。
- Data:定义可应用于数据处理的操作,例如 Backup。
- Diagnostic:定义可应用于诊断的操作,例如 Debug。
- Lifecycle:定义可应用于 cmdlet 的生命周期的操作,例如 Complete。
- Security:定义可应用于安全的操作,例如 Revoke。
- Other:定义其他类型的操作。
一些随 PowerShell 一起安装的 cmdlet(例如 Tee-Object
和 Where-Object
)使用未经批准的谓词。 这些 cmdlet 是历史例外,且它们的谓词被归类为 reserved。
相关链接
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈