PowerShell 数组参数 [完整指南]

有时，您可能需要将数组作为参数传递给 PowerShell 中的函数。在本教程中，我将解释有关 PowerShell 数组参数的所有内容。我们将通过几个示例探讨如何在 PowerShell 函数中使用数组作为参数。

PowerShell 数组参数

在 PowerShell 中，数组非常灵活，它们可以保存任何类型的项，包括整数、字符串、对象，甚至其他数组。

要在 PowerShell 中声明数组，只需将多个值分配给一个变量，并用逗号分隔：

$myArray = 1, 2, 3, 4, 5

这行代码创建一个包含五个整数元素的数组 $myArray。

将数组传递给 PowerShell 中的函数

当您想要将数组传递给 PowerShell 中的函数时，不需要执行任何特殊操作 - 只需像传递任何其他参数一样传递数组变量即可。以下是接受数组参数的函数示例：

function Show-ArrayContents {
    param([array]$numbers)
    foreach ($number in $numbers) {
        Write-Host $number
    }
}

$myArray = 1, 2, 3, 4, 5
Show-ArrayContents -numbers $myArray

在此示例中，函数 Show-ArrayContents 采用一个参数 $numbers，该参数应为一个数组。然后该函数迭代数组中的每个项目并将其打印到主机。

您可以在下面的屏幕截图中看到我使用 VS code 执行 PowerShell 脚本后的输出。

修改函数内的 PowerShell 数组

重要的是要理解，当您将数组传递给函数时，您正在传递对原始数组的引用。这意味着如果您在函数内修改数组，这些更改也将反映在函数外部。这是一个例子：

function Add-Element {
    param([array]$numbers)
    $numbers += 6
}

$myArray = 1, 2, 3, 4, 5
Add-Element -numbers $myArray
Write-Host $myArray

这将输出 1 2 3 4 5 6，因为函数 Add-Element 将一个元素添加到原始数组中。

从 PowerShell 函数返回数组

PowerShell 中的函数也可以返回数组。当您需要基于某种逻辑生成项目列表，然后在函数外部使用该列表时，这非常有用。这是一个例子：

function Get-MultiplesOfTwo {
    param([int]$maxNumber)
    $multiples = @()
    for ($i = 2; $i -le $maxNumber; $i += 2) {
        $multiples += $i
    }
    return $multiples
}

$multiplesOfTwo = Get-MultiplesOfTwo -maxNumber 10
Write-Host $multiplesOfTwo

此函数返回一个由 2 的倍数组成的数组，最多可达指定的最大数。

高级阵列参数

PowerShell 还允许您定义可接受单个值或值数组的参数。这是使用参数的[object[]] 类型来完成的。这是一个例子：

function Display-Messages {
    param([object[]]$messages)
    foreach ($message in $messages) {
        Write-Host $message
    }
}

Display-Messages -messages "Single message"
Display-Messages -messages "First message", "Second message"

在这种情况下，可以使用单个对象或对象数组来调用 Display-Messages。

结论

在本 PowerShell 教程中，我通过示例详细解释了有关 PowerShell 数组参数的所有内容。