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 - 获取安全组中的所有已批准谓词

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[]
Position:1
默认值:All verbs
必需:False
接受管道输入:True
接受通配符:True

输入

None

输出

Selected.Microsoft.PowerShell.Commands.MemberDefinition

备注

Get-Verb 返回已修改版本的 Microsoft.PowerShell.Commands.MemberDefinition 对象。 该对象没有 MemberDefinition 对象的标准属性。 而是 谓词 属性。 Verb 属性包含具有谓词名称的字符串。 Group 属性包含具有谓词组的字符串。

PowerShell 谓词根据最常用的用途分配给组。 这些组旨在使谓词易于查找和比较,而不是限制其使用。 可以对任何类型的命令使用任何批准的谓词。

每个 PowerShell 谓词都分配给以下组之一。

  • 常见:定义可应用于几乎所有 cmdlet 的泛型作,例如 Add。
  • 通信:定义适用于通信的作,例如 Connect。
  • 数据:定义应用于数据处理的作,例如备份。
  • 诊断:定义适用于诊断的作,例如调试。
  • 生命周期:定义应用于 cmdlet 生命周期的作,例如 Complete。
  • 安全性:定义应用于安全性的作,例如 Revoke。
  • 其他:定义其他类型的作。

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