PowerShell 数组包含说明

数组允许您在一个变量中存储多个值。这样您就可以轻松地循环每个值并在脚本中对其进行处理。但有时您需要检查 PowerShell 数组是否包含特定值。

要检查数组中是否存在某个值，我们可以在 PowerShell 中使用 -Contains 运算符。如果该值存在，则返回 true。但还有其他选择。

在本文中，我将展示如何检查 PowerShell 数组是否包含特定值，并解释不同的方法。

PowerShell 数组包含

检查数组是否包含特定值的推荐方法是使用 PowerShell 中的 -contains 运算符或 .Contains() 方法。尽管两者看起来很相似，但两者之间还是有一些重要的区别。

首先，让我们快速了解一下如何使用 -contains 运算符。要简单地检查字符串是否在数组中，您可以执行以下操作：

$array = @('apple', 'banana', 'cherry')

if ($array -contains 'banana') {
    Write-Host "Array contains banana"
}else{
    Write-Host "Banana not found in the array"
}

上面的方法将简单地检查数组中是否存在该字符串。比较不区分大小写，当找到结果时运算符将停止。因此，当一个项目（上例中的水果）在数组中多次列出时，它仍然只会返回 True 或 False。

因此，在检查某个值是否在数组中列出时，还有其他一些选项。除了.Contains()方法之外，我们还可以使用：

• -in 运算符 - 检查值是否在数组中，只是另一种编写方式。
• -ccontains 运算符 - 区分大小写的比较
• -eq - 还可以检查数组是否包含特定值
• Where-Object - 允许您进行更复杂的比较

如果您想了解有关不同选项的更多信息，请务必阅读 PowerShell 运算符文章。

包含运算符与包含方法

所以我想首先解释一下 contains 运算符和 contains 方法之间的区别。因为它们看起来非常相似，但还有更多相似之处。

Contains 方法，写作 .contains()，是来自底层 .NET 框架的方法，而运算符是特定于 PowerShell 的。现在，.NET 方法速度更快，因此当您需要在大型数组中查找值时，就会有真正的好处。

两者之间的另一个重要区别是 contains 方法默认区分大小写，而运算符则不区分大小写：

$array = @('apple', 'banana', 'cherry', 'banana')

$array -contains 'Banana' # Returns true
$array.Contains('Banana') # Returns false

区分大小写的包含

如前所述，包含运算符不区分大小写，这通常是完全没问题的。但是，您还可以通过使用 -ccontains 运算符（注意双 c）来进行精确的大小写值匹配。

$array = @('apple', 'banana', 'cherry', 'banana')

# Case sensitive comparison
$array -ccontains 'Banana' # Returns false

数组不包含

除了检查数组是否包含特定值之外，我们还可以检查数组是否不包含指定值。为此，我们可以使用 -notcontains 运算符。如果该值未在数组中列出，则该运算符将返回 True。

例如，我们有一个已完成安全培训的用户列表，我们想要验证特定用户是否尚未完成培训。在这种情况下，-notcontains 是一个更合理的选择：

# List of users
$completedTraining = @('John', 'Alice', 'Robert', 'Sarah')

# Check if the user has not completed the training
if ($completedTraining -notcontains 'Jane'){
    Write-Host "Jane didn't completed the training"
}

使用 -In 运算符

-in 运算符与 contains 运算符相同，只是相反。当值在数组中时它也会返回 true，唯一的区别是您将数组放在运算符的右侧，而不是左侧。

当 -in 运算符对于具体情况更直观、更简洁时，您应该使用它。例如，如果我们想检查用户是否是管理员组的成员，那么检查“Jane”是否在管理员组中比检查管理员组是否包含“Jane”更有意义：

# List of admin users
$adminUsers = @('John', 'Alice', 'Robert')

# Using the -in operator
if ('Alice' -in $adminUsers) {
    Write-Output "Alice is an admin."
}

这里的关键是让你的代码更容易阅读和理解。您还可以使用 -notin 运算符来检查某个值是否不在数组中。

等号运算符

您可能没有想到，我们还可以在 PowerShell 中使用 -eq 运算符来检查数组是否包含特定值。然而，与 -contains 运算符的最大区别是，等于运算符不返回 true 或 false，但它返回值。

而且，更重要的是，当找到该值时，它不会停止搜索该值。这意味着我们还可以计算或检查某个值是否在数组中多次列出：

$array = @('apple', 'banana', 'cherry', 'banana')

$result = $array -eq "banana"

if ($result) {
    Write-Host "Banana is listed $($result.Length) time(s) in the array"
}

# Result
Banana is listed 2 time(s) in the array

使用Where对象

我想向您展示的最后一个选项是 Where-Object 方法，用于检查数组是否包含特定值。此方法主要用于当您有对象数组或需要进行其他复杂比较时。

例如，我们有一个包含用户对象的数组，并且想要检查该数组是否包含特定用户：

$users = @(
    [PSCustomObject]@{ Name = 'John'; Age = 30 },
    [PSCustomObject]@{ Name = 'Jane'; Age = 25 },
    [PSCustomObject]@{ Name = 'Alice'; Age = 28 }
)

$result = $users | Where-Object { $_.Name -contains 'Jane'}

总结

检查数组是否包含特定值的最常见方法是使用 -contains 运算符。但请记住，这是区分大小写的，而 .contains() 方法区分大小写。

尝试根据情况使用适当的运算符，这将使您的代码更易于阅读和理解。

希望您喜欢这篇文章，如果您有任何疑问，请在下面发表评论。