about_Comparison_Operators

简短说明

PowerShell 中的比较运算符可以比较两个值,也可以根据输入值筛选集合的元素。

长说明

使用比较运算符可以比较值或查找与指定模式匹配的值。 PowerShell 包括以下比较运算符:

类型 运算符 比较测试
相等 -eq equals
-ne 不等于
-gt 大于
-ge 大于或等于
-lt 小于
-le 小于或等于
Matching -like 字符串匹配通配符模式
-notlike 字符串与通配符模式不匹配
-match 字符串匹配正则表达式模式
-notmatch 字符串与正则表达式模式不匹配
Replacement -replace 替换与正则表达式模式匹配的字符串
Containment -contains 集合包含值
-notcontains 集合不包含值
-in 值在集合中
-notin 值不在集合中
类型 -is 两个对象都是同一类型
-isnot 对象不是同一类型

常用功能

默认情况下,字符串比较不区分大小写。 相等运算符具有显式区分大小写和不区分大小写的形式。 若要使比较运算符区分大小写,在 c 之后添加 - 。 例如, -ceq 是 的区分大小写的版本 -eq 。 若要显式显示不区分大小写,在 之后 i 添加 - 。 例如, -ieq 是 的显式不区分大小写的版本 -eq

当运算符的输入是标量值时,运算符返回 布尔 值。 当输入是集合时,运算符返回集合中与表达式右侧值匹配的元素。 如果集合中没有任何匹配项,比较运算符将返回空数组。 例如:

$a = (1, 2 -eq 3)
$a.GetType().Name
$a.Count
Object[]
0

有几个例外情况:

  • 包含运算符和类型运算符始终返回 布尔
  • 运算符 -replace 返回替换结果
  • -match -notmatch 运算符还会填充 $Matches 自动变量,除非表达式的左侧是集合。

相等运算符

-eq 和 -ne

当左侧为标量时,如果右侧完全匹配,则返回 -eq -eq True; 否则返回 False 。 -ne 则相反;如果两 侧匹配 ,则返回 False;否则, -ne 返回 True

示例:

2 -eq 2                 # Output: True
2 -eq 3                 # Output: False
"abc" -eq "abc"         # Output: True
"abc" -eq "abc", "def"  # Output: False
"abc" -ne "def"         # Output: True
"abc" -ne "abc"         # Output: False
"abc" -ne "abc", "def"  # Output: True

如果左侧是集合,则 返回与右侧匹配的成员, -eq 同时 -ne 筛选出它们。

示例:

1,2,3 -eq 2             # Output: 2
"abc", "def" -eq "abc"  # Output: abc
"abc", "def" -ne "abc"  # Output: def

这些运算符处理集合的所有元素。 示例:

"zzz", "def", "zzz" -eq "zzz"
zzz
zzz

相等运算符接受任意两个对象,而不只是标量或集合。 但不能保证比较结果对最终用户有意义。 下面的示例演示了此问题。

class MyFileInfoSet {
    [String]$File
    [Int64]$Size
}
$a = [MyFileInfoSet]@{File = "C:\Windows\explorer.exe"; Size = 4651032}
$b = [MyFileInfoSet]@{File = "C:\Windows\explorer.exe"; Size = 4651032}
$a -eq $b
False

本示例创建了两个具有相同属性的对象。 但是,相等性测试结果为 False, 因为它们是不同的对象。 若要创建类似的类,需要在类中实现System.IEquatable。 <T> 下面的示例演示 MyFileInfoSet 类的部分实现,该类实现 System.IEquatable, <T>并且具有两个属性 ,即"文件"和"大小"。 如果 Equals() 两个 MyFileInfoSet 对象的"文件"和"大小"属性相同,则方法返回 True。

class MyFileInfoSet : System.IEquatable[Object] {
    [String]$File
    [Int64]$Size

    [bool] Equals([Object] $obj) {
        return ($this.File -eq $obj.File) -and ($this.Size -eq $obj.Size)
    }
}
$a = [MyFileInfoSet]@{File = "C:\Windows\explorer.exe"; Size = 4651032}
$b = [MyFileInfoSet]@{File = "C:\Windows\explorer.exe"; Size = 4651032}
$a -eq $b
True

比较任意对象的一个突出示例是找出它们是否为 null。 但是,如果需要确定变量是否是 ,则必须放在相等运算符的 $null $null 左侧。 放在右侧不会执行预期。

例如,让我们 $a 成为一个包含 null 元素的数组:

$a = 1, 2, $null, 4, $null, 6

以下测试不 $a 为 null。

$null -ne $a
True

但是,以下文件会从 中排除所有 null 元素 $a

$a -ne $null # Output: 1, 2, 4, 6
1
2
4
6

-gt、-ge、-lt 和 -le

-gt、、 -ge -lt-le 的行为非常类似。 当两侧都是标量时,它们返回 TrueFalse, 具体取决于两侧的比较方式:

运算符 当...
-gt 左侧较大
-ge 左侧大于或等于
-lt 左侧较小
-le 左侧较小或相等

在下面的示例中,所有 语句都返回 True

8 -gt 6  # Output: True
8 -ge 8  # Output: True
6 -lt 8  # Output: True
8 -le 8  # Output: True

备注

在大多数编程语言中,大于运算符是 > 。 在 PowerShell 中,此字符用于重定向。 有关详细信息 ,请参阅about_Redirection。

当左侧是集合时,这些运算符将集合的每个成员与右侧进行比较。 根据逻辑,它们保留或放弃成员。

示例:

$a=5, 6, 7, 8, 9

Write-Output "Test collection:"
$a

Write-Output "`nMembers greater than 7"
$a -gt 7

Write-Output "`nMembers greater than or equal to 7"
$a -ge 7

Write-Output "`nMembers smaller than 7"
$a -lt 7

Write-Output "`nMembers smaller than or equal to 7"
$a -le 7
Test collection:
5
6
7
8
9

Members greater than 7
8
9

Members greater than or equal to 7
7
8
9

Members smaller than 7
5
6

Members smaller than or equal to 7
5
6
7

这些运算符与实现 System.IComparable 的任何类一起工作

示例:

# Date comparison
[DateTime]'2001-11-12' -lt [DateTime]'2020-08-01' # True

# Sorting order comparison
'a' -lt 'z'           # True; 'a' comes before 'z'
'macOS' -ilt 'MacOS'  # False
'MacOS' -ilt 'macOS'  # False
'macOS' -clt 'MacOS'  # True; 'm' comes before 'M'

下面的示例演示美国 QWERTY 键盘上没有符号,该符号在"a"之后排序。 它将包含所有此类符号的集馈送给 -gt 运算符,以将其与"a"进行比较。 输出为空数组。

$a=' ','`','~','!','@','#','$','%','^','&','*','(',')','_','+','-','=',
   '{','}','[',']',':',';','"','''','\','|','/','?','.','>',',','<'
$a -gt 'a'
# Output: Nothing

如果运算符的两端无法合理比较,这些运算符将引发非终止错误。

匹配运算符

匹配运算符 (、、 和) 查找与指定模式匹配 -like -notlike -match -notmatch 或不匹配的元素。 和 的模式是包含 、 和 () 的通配符表达式,而 和 接受正则表达式 (-like -notlike * ? [ ] -match -notmatch 正则表达式) 。

语法为:

<string[]> -like    <wildcard-expression>
<string[]> -notlike <wildcard-expression>
<string[]> -match    <regular-expression>
<string[]> -notmatch <regular-expression>

当这些运算符的输入是标量值时,它们返回 布尔 值。 当输入是值的集合时,运算符将返回任何匹配的成员。 如果集合中没有任何匹配项,则运算符返回空数组。

-like 和 -notlike

-like``-notlike和 的行为类似于 和 ,但右侧 -eq -ne 可以是包含通配符的字符串

示例:

"PowerShell" -like    "*shell"           # Output: True
"PowerShell" -notlike "*shell"           # Output: False
"PowerShell" -like    "Power?hell"       # Output: True
"PowerShell" -notlike "Power?hell"       # Output: False
"PowerShell" -like    "Power[p-w]hell"   # Output: True
"PowerShell" -notlike "Power[p-w]hell"   # Output: False

"PowerShell", "Server" -like "*shell"    # Output: PowerShell
"PowerShell", "Server" -notlike "*shell" # Output: Server

-match 和 -notmatch

-match``-notmatch和 使用正则表达式在左侧值中搜索模式。 正则表达式可以匹配电子邮件地址、UNC 路径或格式化电话号码等复杂模式。 右侧字符串必须遵循正则表达式规则。

标量示例:

# Partial match test, showing how differently -match and -like behave
"PowerShell" -match 'shell'        # Output: True
"PowerShell" -like  'shell'        # Output: False

# Regex syntax test
"PowerShell" -match    '^Power\w+' # Output: True
'bag'        -notmatch 'b[iou]g'   # Output: True

如果输入是集合,则运算符将返回该集合的匹配成员。

集合示例:

"PowerShell", "Super PowerShell", "Power's hell" -match '^Power\w+'
# Output: PowerShell

"Rhell", "Chell", "Mel", "Smell", "Shell" -match "hell"
# Output: Rhell, Chell, Shell

"Bag", "Beg", "Big", "Bog", "Bug"  -match 'b[iou]g'
#Output: Big, Bog, Bug

"Bag", "Beg", "Big", "Bog", "Bug"  -notmatch 'b[iou]g'
#Output: Bag, Beg

-match-notmatch 支持正则表达式捕获组。 每次在标量输入上运行时,结果为 True 或结果为 False 时 -match -notmatch ,它们将覆盖 $Matches 自动变量。 $Matches始终 具有名为"0"的键的哈希表,用于存储整个匹配项。 如果正则表达式包含捕获组,则 $Matches 包含每个组的其他键。

示例:

$string = 'The last logged on user was CONTOSO\jsmith'
$string -match 'was (?<domain>.+)\\(?<user>.+)'

$Matches

Write-Output "`nDomain name:"
$Matches.domain

Write-Output "`nUser name:"
$Matches.user
True

Name                           Value
----                           -----
domain                         CONTOSO
user                           jsmith
0                              was CONTOSO\jsmith

Domain name:
CONTOSO

User name:
jsmith

-match 结果为 False 或 结果为 True 时,或当输入为集合时,不会覆盖 -notmatch $Matches 自动变量。 因此,它将包含以前设置的值,或者, $null 如果尚未设置变量,则返回 。 调用其中一个运算符后引用时,请考虑使用条件语句验证变量是否已由当前运算符调用 $Matches 设置。

示例:

if ("<version>1.0.0</version>" -match '<version>(.*?)</version>') {
    $Matches
}

有关详细信息,请参阅about_Regular_Expressions 和about_Automatic_Variables。

替换运算符

用正则表达式替换

-match-replace 样, 运算符使用正则表达式查找指定的模式。 但与 -match 不同,它将匹配项替换为另一个指定的值。

语法:

<input> -replace <regular-expression>, <substitute>

运算符使用正则表达式将值的所有或部分替换为指定的值。 可以将 运算符用于许多管理任务,例如重命名文件。 例如,以下命令将所有文件的文件扩展名 .txt 更改为 .log

Get-ChildItem *.txt | Rename-Item -NewName { $_.name -replace '\.txt$','.log' }

默认情况下, -replace 运算符不区分大小写。 若要使其区分大小写,请使用 -creplace 。 若要使其显式不区分大小写,请使用 -ireplace

示例:

"book" -ireplace "B", "C" # Case insensitive
"book" -creplace "B", "C" # Case-sensitive; hence, nothing to replace
Cook
book

正则表达式替换

还可使用正则表达式通过捕获组和替换来动态替换文本。 可以使用美元符号在字符串中引用捕获组 <substitute> () $ 标识符之前的字符。

在下面的示例中, -replace 运算符接受 格式的用户名 DomainName\Username ,并转换为 Username@DomainName 格式:

$SearchExp = '^(?<DomainName>[\w-.]+)\\(?<Username>[\w-.]+)$'
$ReplaceExp = '${Username}@${DomainName}'

'Contoso.local\John.Doe' -replace $SearchExp,$ReplaceExp
John.Doe@Contoso.local

警告

字符 $ 在 PowerShell 和正则表达式中具有 syntatic 角色:

  • 在 PowerShell 中,在双引号之间,它指定变量并充当子表达式运算符。
  • 在正则表达式搜索字符串中,它表示行的结尾
  • 在 Regex 替换字符串中,它表示捕获的组。请确保将正则表达式放在单引号之间,或将反引号 () ` 字符之前。

例如:

$1 = 'Goodbye'

'Hello World' -replace '(\w+) \w+', "$1 Universe"
# Output: Goodbye Universe

'Hello World' -replace '(\w+) \w+', '$1 Universe'
# Output: Hello Universe

$$ 在 Regex 中表示文本 $ 。 这将 $$ 在替换字符串中,以在生成的 $ 替换中包括文本。 例如:

'5.72' -replace '(.+)', '$ $1' # Output: $ 5.72
'5.72' -replace '(.+)', '$$$1' # Output: $5.72
'5.72' -replace '(.+)', '$$1'  # Output: $1

有关详细信息,请参阅正则表达式about_Regular_Expressions和替换。

集合中的子项

<input> 运算符 -replace 为集合时,PowerShell 将替换应用于集合中的每个值。 例如:

"B1","B2","B3","B4","B5" -replace "B", 'a'
a1
a2
a3
a4
a5

使用脚本块替换

在 PowerShell 6 及更高版本中, -replace 运算符还接受执行替换的脚本块。 脚本块针对每个匹配项运行一次。

语法:

<String> -replace <regular-expression>, {<Script-block>}

在脚本块中,使用 $_ 自动变量访问要替换的输入文本和其他有用信息。 此变量的类类型为System.Text.RegularExpressions.Match。

以下示例将三位数字的每个序列替换为等效字符。 脚本块针对每组需要替换的三个数字运行。

"072101108108111" -replace "\d{3}", {return [char][int]$_.Value}
Hello

包含运算符

包含运算符 (、、 和) 类似于相等运算符,只不过它们始终返回布尔值,即使输入是 -contains -notcontains -in -notin 集合。 一旦检测到第一个匹配项,这些运算符就会停止比较,而相等运算符则计算所有输入成员。 在非常大的集合中,这些运算符的返回速度比相等运算符更快。

语法:

<Collection> -contains <Test-object>
<Collection> -notcontains <Test-object>
<Test-object> -in <Collection>
<Test-object> -notin <Collection>

-contains 和 -notcontains

这些运算符指示集是否包含特定元素。 -contains右侧 测试对象 (与) 元素之一匹配时,返回 True。 -notcontains 改为返回 False。 当测试对象是集合时,这些运算符使用引用相等性,即检查集的某个元素是否与测试对象的实例相同。

示例:

"abc", "def" -contains "def"                  # Output: True
"abc", "def" -notcontains "def"               # Output: False
"Windows", "PowerShell" -contains "Shell"     # Output: False
"Windows", "PowerShell" -notcontains "Shell"  # Output: True
"abc", "def", "ghi" -contains "abc", "def"    # Output: False
"abc", "def", "ghi" -notcontains "abc", "def" # Output: True

更复杂的示例:

$DomainServers = "ContosoDC1","ContosoDC2","ContosoFileServer","ContosoDNS",
                 "ContosoDHCP","ContosoWSUS"
$thisComputer  = "ContosoDC2"

$DomainServers -contains $thisComputer
# Output: True

$a = "abc", "def"
"abc", "def", "ghi" -contains $a # Output: False
$a, "ghi" -contains $a           # Output: True

-in 和 -notin

PowerShell 3 中引入了 和 运算符,作为 和 运算符的 -in -notin 语法 -contains -notcontains 反向。 -in 如果 左侧 与集内元素之一匹配,则 <test-object> 返回 True。 -notin改为 返回 False。 当测试对象是一个集时,这些运算符使用引用相等性来检查集的某个元素是否与测试对象的实例相同。

以下示例执行与 和 示例相同的操作,但它们 -contains 是使用 -notcontains-in 编写的 -notin

"def" -in "abc", "def"                  # Output: True
"def" -notin "abc", "def"               # Output: False
"Shell" -in "Windows", "PowerShell"     # Output: False
"Shell" -notin "Windows", "PowerShell"  # Output: True
"abc", "def" -in "abc", "def", "ghi"    # Output: False
"abc", "def" -notin "abc", "def", "ghi" # Output: True

更复杂的示例:

$DomainServers = "ContosoDC1","ContosoDC2","ContosoFileServer","ContosoDNS",
                 "ContosoDHCP","ContosoWSUS"
$thisComputer  = "ContosoDC2"

$thisComputer -in $DomainServers
# Output: True

$a = "abc", "def"
$a -in "abc", "def", "ghi" # Output: False
$a -in $a, "ghi"           # Output: True

类型比较

类型比较 (-is 和) -isnot 运算符用于确定对象是否为特定类型。

语法:

<object> -is <type-reference>
<object> -isnot <type-reference>

例如:

$a = 1
$b = "1"
$a -is [int]           # Output: True
$a -is $b.GetType()    # Output: False
$b -isnot [int]        # Output: True
$a -isnot $b.GetType() # Output: True

另请参阅