将多个参数传递给 PowerShell 脚本 [4 种方法]

所有代码片段都写在MyScript.ps1文件中；您可以将此文件命名为您选择的任何名称。

使用自动变量 $args

使用自动变量$args将多个参数传递给PowerShell脚本。

在 MyScript.ps1 文件中使用 $args：

foreach ($arg in $args) {
    Write-Host "Argument: $arg"
}

调用MyScript.ps1脚本：

.\MyScript.ps1 "Param1" "Param2" "Param3"

输出 ：

Argument: Param1
Argument: Param2
Argument: Param3

args 变量是一个数组，其中包含调用脚本时传递给脚本的所有参数的值。在上面的示例中，调用 MyScript.ps1 脚本文件时会传递 3 参数 "Param1" "Param2" "Param3"。

空格用作参数之间的分隔符。

还应该注意的是，这些参数是未命名的，仅包含自动存储在 args 数组中的参数值。正如我们所观察到的，在上面的 MyScript.ps1 脚本文件中，foreach 循环用于迭代所有接收到的参数。然后，Write-Host cmdlet 在控制台上显示所有参数。

让我们看下面的另一个例子以加深理解。

在 MyScript.ps1 中使用 $args：

Write-Host "First argument is "$args[0]
Write-Host "Second argument is "$args[1]

调用MyScript.ps1脚本：

.\MyScript.ps1 "Hello" "World"

输出 ：

First argument is  Hello
Second argument is  World

在上面的例子中，args 数组包含两个元素 "Hello" 和 "World"，它们被传递给 MyScript。 ps1 文件。可以通过引用它们在数组中的位置来访问这些值。这就是为什么这些也被称为位置参数。

第一个参数值 "Hello" 分配给数组的第一个元素 ($args[0])，第二个参数值 "World" 被分配给数组的第二个元素 ($args[2])。

当您知道脚本所需参数的确切数量和顺序时，位置参数会很有帮助。

使用 param() 块

使用 param() 块将多个参数传递给 PowerShell 脚本。

在 MyScript.ps1 文件中使用 param() 块：

param(
  [string]$userName,
  [int]$userId,
  [string]$ProductName,
  [int]$ProductPrice
)
write-output "User name is $userName"
write-output "User id is $userId"
write-output "Product name is $ProductName"
write-output "Product Price is $ProductPrice"

调用MyScript.ps1脚本：

.\MyScript.ps1 -userName "Ayesha" -userId 689 -productName mouse -productPrice 200

输出 ：

User name is Ayesha
User id is 689
Product name is mouse
Product Price is 200

在此方法中，MyScript.ps1 脚本中的 param() 块定义了参数的名称和数据类型。可以在脚本中的任何位置访问这些参数的值。调用脚本时，使用 -ParameterName Value 语法传递参数。

在提供的示例中，使用四个命名参数调用脚本。值“Ayesha”已分配给参数“-userName”，值“689”已分配给参数“ -userId"，值"mouse" 已分配给参数"-productName"，值"200"已分配给参数“-productPrice”。然后，write-output cmdlet 在控制台上打印参数及其值。

param() 块应位于脚本的开头。

使用泼溅

使用展开将多个参数传递给 PowerShell 脚本。

在 MyScript.ps1 文件中使用 Splatting：

param (
  [string]$Param1,
  [string]$Param2
)
Write-Host "Param1: $Param1"
Write-Host "Param2: $Param2"

调用MyScript.ps1脚本：

$params = @{
  Param1 = "value1"
  Param2 = "value2"
}
& .\Myscript.ps1 @params

输出 ：

Param1: value1
Param2: value2

在给定的方法中，创建了一个哈希表，其中包含参数名称及其各自的值。然后，将调用运算符 (&) 与 splatting 语法 @params 结合使用，将 hashtable 作为命名参数传递给 PowerShell 脚本。

在MyScript.ps1 脚本内，可以使用哈希表 中指定的参数名称来访问命名参数。当您有大量参数或参数具有运行时未知的动态名称/值时，此方法非常有用。

请注意，hashtable 中的参数名称必须与脚本的 param() 块中定义的名称匹配；否则，值将无法正确传递。

使用 ValueFromRemainingArguments 参数

使用 ValueFromRemainingArguments 参数将多个参数传递给 PowerShell 脚本。

在 MyScript.ps1 文件中使用 ValueFromRemainingArguments：

param(
  [Parameter(ValueFromRemainingArguments=$true)]
  [string[]]$Param1
)
$i = 1
foreach ($value in $Param1) {
  Write-Host "Param${i}: {value}"
  $i++
}

调用MyScript.ps1脚本：

.\myscript.ps1 value1 value2 value3

输出 ：

Param1: value1
Param1: value2
Param1: value3

ValueFromRemainingArguments 参数在脚本的 param() 块中定义，并分配所有剩余参数作为输入。在此示例中，$Param1 参数定义为 ValueFromRemainingArguments 参数，允许其接受所有剩余参数作为输入。

ValueFromRemainingArguments 参数的值设置为 true。默认情况下，其值为 $false。

调用脚本时，将参数数组作为单独的值传递。例如，在上述情况下，Value1、Value2 和 Value3 被传递到 MyScript.ps1 脚本，然后将其作为数组分配给 $Param1 参数。最后，使用 foreach 循环遍历 $Param1 数组的每个元素，并使用 Write-Host cmdlet 将其显示在控制台上。

让我们看另一个例子：

在 MyScript.ps1 文件中使用 ValueFromRemainingArguments：

param(
    [Parameter(Position=0)][String]$Vlan,
    [Parameter(ValueFromRemainingArguments=$true)][String[]]$Hosts
)
Write-Host "Param: ${Vlan}"
foreach ($p in $Hosts) {
  Write-Host "Param: $p"
}

调用MyScript.ps1脚本：

.\MyScript.ps1 VLAN1 Host1 Host2 Host3

输出 ：

Param: VLAN1
Param: Host1
Param: Host2
Param: Host3

上面的 PowerShell 代码演示了脚本中位置参数和 ValueFromRemainingArguments 参数属性的用法。

该脚本的 param() 块定义了两个参数 - $Vlan 和 $Hosts。第一个参数 $Vlan 是位置参数，位置为 0。第二个参数 $Hosts 是一个命名参数，其 ValueFromRemainingArguments 属性设置为 $true。这意味着 $Hosts 接受一个字符串数组，其中包含未分配给位置参数的所有参数。

调用脚本时，会将四个参数值 VLAN1 Host1 Host2 Host3 传递给脚本。第一个值 VLAN1 分配给 $Vlan 变量；其余参数 Host1、Host2 和 Host3 设置为 $Hosts 作为字符串数组这个 PowerShell 脚本。

然后，使用 Write-Host cmdlet 显示位置参数 $Vlan 值。其余参数 Host1、Host2 和 Host3 也分配给 $Hosts 数组。

这就是如何将多个参数传递给 PowerShell 脚本的全部内容。