如何在 PowerShell 中使用脚本参数106

PowerShell 中的脚本参数是一种强大的工具，它允许您在运行脚本时向脚本提供输入。这对于自动化任务、提高脚本的可重用性和提供用户友好的界面非常有用。## 语法
脚本参数的语法如下：
```
[Parameter(
Mandatory=$mandatory,
Position=$position,
ValueFromPipeline=$valueFromPipeline,
ValueFromPipelineByPropertyName=$valueFromPipelineByPropertyName,
HelpMessage=$helpMessage
)]
$parameterName
```
其中：
* Mandatory：指定参数是否必需。默认为 false。
* Position：指定参数在脚本参数列表中的位置。默认为 0。
* ValueFromPipeline：指定参数是否可以从管道接收值。默认为 false。
* ValueFromPipelineByPropertyName：指定参数是否可以从管道接收具有指定属性名称的值。默认为 ""。
* HelpMessage：指定参数的帮助消息。
## 创建脚本参数
要创建脚本参数，请使用 [Parameter()] 属性将参数添加到脚本中。例如：
```
[Parameter(
Mandatory=$true,
Position=0,
ValueFromPipeline=$true,
HelpMessage="Specify the input file."
)]
[string]$inputFile
```
此脚本参数名为 $inputFile，它是必需的（Mandatory 为 true），处于脚本参数列表的第一个位置（Position 为 0），它可以从管道接收值（ValueFromPipeline 为 true），并且具有帮助消息（HelpMessage 为 "Specify the input file."）。
## 使用脚本参数
要使用脚本参数，请在运行脚本时将其作为参数传递。例如：
```
.\MyScript.ps1 -inputFile ""
```
此命令将运行 MyScript.ps1 脚本，并向 $inputFile 脚本参数传递 "" 值。
## 默认值
您可以为脚本参数指定默认值。例如：
```
[Parameter(
Mandatory=$false,
Position=1,
DefaultValue="",
HelpMessage="Specify the output file."
)]
[string]$outputFile
```
此脚本参数名为 $outputFile，它不是必需的（Mandatory 为 false），处于脚本参数列表的第二个位置（Position 为 1），具有默认值 ""，并且具有帮助消息（HelpMessage 为 "Specify the output file."）。
如果您在运行脚本时未向 $outputFile 脚本参数传递值，则它将使用默认值 ""。
## 获取脚本参数值
您可以使用 $args 自动变量获取脚本参数值。$args 是一个哈希表，其中键是脚本参数名称，值为对应的值。例如：
```
$inputFile = $args["inputFile"]
$outputFile = $args["outputFile"]
```
此代码将从 $args 哈希表中检索 $inputFile 和 $outputFile 脚本参数的值。
## 参数验证
您可以使用 [ValidateScript()] 属性对脚本参数的值进行验证。例如：
```
[Parameter(
Mandatory=$true,
Position=0,
ValueFromPipeline=$false,
HelpMessage="Specify the input file."
)]
[ValidateScript({
if (!$_ -is []) {
throw "The input file must be a valid file path."
}
})]
[string]$inputFile
```
此脚本参数名为 $inputFile，它是必需的（Mandatory 为 true），处于脚本参数列表的第一个位置（Position 为 0），它不能从管道接收值（ValueFromPipeline 为 false），并且具有帮助消息（HelpMessage 为 "Specify the input file."）。
[ValidateScript()] 属性指定一个脚本块，用于验证输入值。如果输入值不符合脚本块中定义的条件，则会引发异常。
## 帮助消息
您可以使用 [HelpMessage()] 属性为脚本参数指定帮助消息。帮助消息将在 Get-Help 命令中显示。例如：
```
[Parameter(
Mandatory=$true,
Position=0,
ValueFromPipeline=$true,
HelpMessage="Specify the input file. This parameter is mandatory and can accept values from the pipeline."
)]
[string]$inputFile
```
此脚本参数名为 $inputFile，它是必需的（Mandatory 为 true），处于脚本参数列表的第一个位置（Position 为 0），它可以从管道接收值（ValueFromPipeline 为 true），并且具有帮助消息（HelpMessage 为 "Specify the input file. This parameter is mandatory and can accept values from the pipeline."）。
## 结论
脚本参数是 PowerShell 中强大的工具，它允许您向脚本提供输入，提高脚本的可重用性，并创建用户友好的界面。您可以使用 [Parameter()] 属性创建脚本参数，并使用 $args 自动变量获取脚本参数值。