Get-Verb

获取批准的 PowerShell 谓词。

语法

Get-Verb
   [[-verb] <String[]>]

说明

函数 Get-Verb 获取批准在 PowerShell 命令中使用的谓词。

PowerShell 建议 cmdlet 和函数名称采用 Verb-Noun 格式,并包含已批准的谓词。 这种做法使命令名称更加一致、可预测且更易于使用。

使用未经批准的谓词的命令在 PowerShell 中运行。 但是,在导入包含名称中包含未批准的谓词的命令的模块时,该 Import-Module 命令会显示一条警告消息。

注意

返回 的 Get-Verb 谓词列表可能不完整。 有关包含说明的已批准 PowerShell 谓词的更新列表,请参阅Microsoft Docs中的已批准谓词

示例

示例 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

仅获取指定的谓词。 输入谓词的名称或名称模式。 允许使用通配符。

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 谓词都分配给以下组之一。

  • 常见:定义几乎可以应用于任何 cmdlet 的泛型操作,例如 Add。
  • 通信:定义适用于通信的操作,例如“连接”。
  • 数据:定义适用于数据处理的操作,例如备份。
  • 诊断:定义应用于诊断的操作,例如调试。
  • 生命周期:定义应用于 cmdlet 生命周期的操作,例如 Complete。
  • 安全性:定义适用于安全性的操作,例如撤销。
  • 其他:定义其他类型的操作。

与 PowerShell 一起安装的一些 cmdlet(如 Tee-ObjectWhere-Object)使用未经批准的谓词。 这些 cmdlet 是历史例外,其谓词被归类为 保留