power up语法
介绍 PowerShell 中使用的语法关系图。
长说明
Get-Help 和 Get-Command cmdlet 显示语法关系图,帮助你正确构造命令。 本主题说明如何解释语法关系图。
语法关系图
命令语法图中的每个段落都表示命令的有效形式。
若要构造命令,请按照语法图从左到右操作。 从可选参数中进行选择,并为占位符提供值。
PowerShell 对语法关系图使用以下表示法。
<mand-name> -<Required Parameter Name> <Required Parameter Value>
[-<Optional Parameter Name> <Optional Parameter Value>]
[-<Optional Switch Parameters>]
[-<Optional Parameter Name>] <Required Parameter Value>
下面是 New-Alias cmdlet 的语法。
New-Alias [-Name] <string> [-Value] <string> [-Description <string>]
[-Force] [-Option {None | ReadOnly | Constant | Private | AllScope}]
[-PassThru] [-Scope <string>] [-Confirm] [-WhatIf] [<CommonParameters>]
语法的大小写是为了提高可读性,但 PowerShell 不区分大小写。
语法关系图具有以下元素。
命令名称
命令始终以命令名称开头,例如 New-Alias。 键入命令名称或其别名,例如 的 Get-Command“gcm”。
参数
命令的参数是确定命令用途的选项。 某些参数采用“值”,该值是用户对命令的输入。
例如, Get-Help 命令具有 Name 参数,可用于指定显示帮助的主题的名称。 主题名称是 Name 参数的值。
在 PowerShell 命令中,参数名称始终以连字符开头。 连字符告知 PowerShell 命令中的项是参数名称。
例如,若要使用 的 New-AliasName 参数,请键入以下内容:
-Name
参数可以是必需参数,也可以是可选的。 在语法图中,可选项括在方括号 中 [ ]。
有关参数的详细信息,请参阅 about_Parameters。
参数值
参数值是参数采用的输入。 由于Windows PowerShell基于 Microsoft .NET Framework,因此参数值在语法图中按其 .NET 类型表示。
例如, 的 Get-Help Name 参数采用一个“String”值,该值是一个文本字符串,例如一个单词或多个用引号括起来的单词。
[-Name] <string>
参数值的 .NET 类型括在尖括号 < > 中,以指示它是值的占位符,而不是在命令中键入的文本。
若要使用 参数,请将 .NET 类型占位符替换为具有指定 .NET 类型的对象。
例如,若要使用 Name 参数,请键入“-Name”,后跟字符串,如下所示:
-Name MyAlias
没有值的参数
某些参数不接受输入,因此它们没有参数值。 不带值的参数称为“开关参数”,因为它们的工作方式类似于开/关开关。 在) (包含它们,或者从命令) (省略它们。
若要使用 switch 参数,只需键入参数名称,前面有连字符。
例如,若要使用 cmdlet 的 New-AliasWhatIf 参数,请键入以下内容:
-WhatIf
参数集
命令的参数列在参数集中。 参数集类似于语法图的段落。
cmdlet New-Alias 有一个参数集,但许多 cmdlet 具有多个参数集。 某些 cmdlet 参数对参数集是唯一的,其他参数显示在多个参数集中。 每个参数集都表示有效命令的格式。 参数集仅包括可在命令中一起使用的参数。 如果参数不能在同一命令中使用,则它们将显示在单独的参数集中。
例如, Get-Random cmdlet 具有以下参数集:
Get-Random [[-Maximum] <Object>] [-Minimum <Object>] [-SetSeed <int>]
[<CommonParameters>]
Get-Random [-InputObject] <Object[]> [-Count <int>] [-SetSeed <int>]
[<CommonParameters>]
返回随机数的第一个参数集具有 Minimum 和 Maximum 参数。 第二个参数集返回一组对象中随机选择的对象,包括 InputObject 和 Count 参数。 这两个参数集都具有 SetSeed 参数和通用参数。
input命令这些参数集指示可以在同一命令中使用 InputObject 和 Count 参数,但不能在同一命令中使用 Maximum 和 Count 参数。
通过使用该参数集中的参数来指示要使用的参数集。
但是,每个 cmdlet 也有一个默认参数集。 如果未指定参数集唯一的参数,则使用默认参数集。 例如,如果使用Get-Random不带参数,Windows PowerShell假定你使用的是 Number
参数集,并且它返回一个随机数。
在每个参数集中,参数按位置顺序显示。 仅当省略可选参数名称时,命令中的参数顺序才重要。 省略参数名称时,PowerShell 会按位置和类型将值分配给参数。 有关参数位置的详细信息,请参阅 about_Parameters。
语法图中的符号
语法关系图列出了命令名称、命令参数和参数值。 它还使用符号来演示如何构造有效的命令。
语法关系图使用以下符号:
∙连字符 - 指示参数名称。 在命令中,在参数名称前面键入紧靠的连字符,不带中间空格,如语法图中所示。
例如,若要使用 的 New-AliasName 参数,请键入:
-Name
∙尖括号 <> 指示占位符文本。 不要在命令中键入尖括号或占位符文本。 而是将其替换为它所描述的项。
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论