13. cmdlet

编辑说明

重要

Windows PowerShell 语言规范 3.0 于 2012 年 12 月发布,基于 Windows PowerShell 3.0。 此规范不反映 PowerShell 的当前状态。 没有计划更新本文档以反映当前状态。 此处提供了本文档供历史参考。

该规范文档可作为 Microsoft Word 文档从 Microsoft 下载中心下载,链接为:https://www.microsoft.com/download/details.aspx?id=36389。该 Word 文档已在 Microsoft Learn 上转换为演示格式。 转换期间,进行了一些编辑更改,以适应 Docs 平台的格式设置。 已更正某些拼写错误和次要错误。

cmdlet 是一个单功能命令,用于操作 PowerShell 中的对象。 Cmdlet 可以按名称格式进行识别,谓词和名词用短划线(-)分隔,如 Get-HelpGet-ProcessStart-Service谓词模式 是使用通配符表示的谓词,如在 W*中所示。 名词模式 是使用通配符表示的名词,与 事件一样。

Cmdlet 应该简单并且旨在与其他 cmdlet 结合使用。 例如,Get cmdlet 只能检索数据,Set cmdlet 应仅建立或更改数据,Format cmdlet 只能设置数据格式,Out cmdlet 应仅将输出定向到指定目标。

对于每个 cmdlet,请提供一个可通过键入以下内容访问的帮助文件:

Get-Help *cmdlet-name* -Detailed

cmdlet 帮助文件的详细视图应包括 cmdlet 的说明、命令语法、参数说明以及演示如何使用该 cmdlet 的示例。

Cmdlet 的使用方式与操作系统命令和实用程序类似。 PowerShell 命令不区分大小写。

注意

编辑器说明:原始文档包含 cmdlet 列表,其中包含说明、语法关系图、参数定义和示例。 此信息不完整且已过期。 有关 cmdlet 的当前信息,请参阅 PowerShell 文档参考 部分。

13.1 通用参数

通用参数是一套可与任何 cmdlet 配合使用的 cmdlet 参数。 它们由 PowerShell 运行时环境本身实现,而不是由 cmdlet 开发人员实现,并且它们会自动提供给任何使用 Parameter 属性(§12.3.7) 或 CmdletBinding 属性(§12.3.5) 的任何 cmdlet 或函数。

尽管所有 cmdlet 都接受通用参数,但这些参数对于某些 cmdlet 可能并没有实际意义。 例如,如果 cmdlet 不生成任何详细输出,那么使用 Verbose 常用参数就没有效果。

多个常见参数会替代可通过首选项变量设置的系统默认值或首选项(§2.3.2.3)。 与首选项变量不同,通用参数仅影响使用它们的命令。

注意

编辑器说明:原始文档包含通用参数的列表。 此信息不完整且已过期。 有关最新信息,请参阅 about_CommonParameters