about_Operators

项目
2025/02/05

简短说明

介绍 PowerShell 支持的运算符。

长说明

运算符是在命令或表达式中使用的语言元素。 PowerShell 支持多种类型的运算符来帮助作值。

算术运算符

使用算术运算符（+、-、*、/、%）计算命令或表达式中的值。使用这些运算符，可以添加、减去、乘法或除法值，并计算除法运算的余数（模数）。

加法运算符连接元素。乘法运算符返回每个元素的指定副本数。可以在任何实现它们的 .NET 类型上使用算术运算符，例如：Int、String、DateTime、Hashtable和数组。

位运算符（-band、-bor、-bxor、-bnot、-shl、-shr）作值中的位模式。

有关详细信息，请参阅 about_Arithmetic_Operators。

赋值运算符

使用赋值运算符（=、+=、-=、*=、/=、%=）将值分配给变量、更改或追加值。可以将算术运算符与赋值组合在一起，将算术运算的结果分配给变量。

有关详细信息，请参阅 about_Assignment_Operators。

比较运算符

使用比较运算符（-eq、-ne、-gt、-lt、-le、-ge）来比较值和测试条件。例如，可以比较两个字符串值，以确定它们是否相等。

比较运算符还包括在文本中查找或替换模式的运算符。运算符使用正则表达式（-match、-notmatch、-replace）和（-like、-notlike）使用通配符 *。

包含比较运算符确定测试值是否出现在引用集中（-in、-notin、-contains、-notcontains）。

类型比较运算符（-is，-isnot）确定对象是否为给定类型。

有关详细信息，请参阅 about_Comparison_Operators。

逻辑运算符

使用逻辑运算符（-and、-or、-xor、-not、!）将条件语句连接到单个复杂条件中。例如，可以使用逻辑 -and 运算符创建具有两个不同的条件的对象筛选器。

有关详细信息，请参阅 about_Logical_Operators。

重定向运算符

使用重定向运算符（>、>>、2>、2>>和 2>&1）将命令或表达式的输出发送到文本文件。重定向运算符的工作方式类似于 Out-File cmdlet（不带参数），但它们还允许将错误输出重定向到指定的文件。还可以使用 Tee-Object cmdlet 重定向输出。

有关详细信息，请参阅 about_Redirection

拆分和联接运算符

-split 和 -join 运算符划分和合并子字符串。 -split 运算符将字符串拆分为子字符串。 -join 运算符将多个字符串串联成一个字符串。

有关详细信息，请参阅 about_Split 和 about_Join。

类型运算符

使用类型运算符（-is、-isnot、-as）查找或更改对象的 .NET 类型。

有关详细信息，请参阅 about_Type_Operators。

一元运算符

使用一元 ++ 和 -- 运算符递增或递减值，并 - 求反。例如，若要将变量 $a 从 9 递增到 10，请键入 $a++。

有关详细信息，请参阅 about_Arithmetic_Operators。

特殊运算符

特殊运算符具有不适合任何其他运算符组的特定用例。例如，特殊运算符允许你运行命令、更改值的数据类型或从数组中检索元素。

分组运算符 `( )`

与其他语言一样，(...) 用于替代表达式中的运算符优先级。例如：(1 + 2) / 3

但是，在 PowerShell 中，还有其他行为。

分组结果表达式

(...) 允许从 命令输出 参与表达式。例如：

PowerShell

PS> (Get-Item *.txt).Count -gt 10
True

管道分组表达式

用作管道的第一段时，将命令或表达式包装在括号中总是会导致表达式结果枚举。如果括号包装命令，则会在通过管道发送结果之前，在内存中收集的所有输出完成。

在管道之前对表达式进行分组还可确保后续对象逐对象处理不会干扰命令用于生成其输出的枚举。

分组赋值语句

未组合赋值语句不输出值。分组赋值语句时，赋值变量的值通过传递，并且可以在较大的表达式中使用。例如：

PowerShell

PS> ($var = 1 + 2)
3
PS> ($var = 1 + 2) -eq 3
True

将语句包装在括号中会将其转换为输出 $var值的表达式。

此行为适用于所有赋值运算符，包括复合运算符（如 +=），以及递增（++）和递减（--）运算符。但是，递增和递减的作顺序取决于其位置。

PowerShell

PS> $i = 0
PS> (++$i) # prefix
1
PS> $i = 0
PS> ($i++) # postfix
0
PS> $i
1

在前缀情况下，$i 的值在输出之前递增。在后缀示例中，输出后 $i 的值递增。

还可以在条件语句的上下文中使用此技术，例如 if 语句。

PowerShell

if ($textFiles = Get-ChildItem *.txt) {
    $textFiles.Count
}

在此示例中，如果没有文件匹配，Get-ChildItem 命令将返回任何内容，并将任何内容分配给 $textFiles，这在布尔上下文中被视为 $false。如果将一个或多个 FileInfo 对象分配给 $textFiles，则条件计算结果为 $true。可以使用 if 语句正文中的 $textFiles 值。

备注

虽然此方法方便简洁，但它可能会导致赋值运算符（=）和相等运算符（-eq）之间的混淆。

子表达式运算符 `$( )`

返回一个或多个语句的结果。对于单个结果，返回标量。对于多个结果，返回一个数组。如果要在另一个表达式中使用表达式，请使用此方法。例如，在字符串表达式中嵌入命令的结果。

PowerShell

PS> "Today is $(Get-Date)"
Today is 12/02/2019 13:15:20

PS> "Folder list: $((dir c:\ -dir).Name -join ', ')"
Folder list: Program Files, Program Files (x86), Users, Windows

数组子表达式运算符 `@( )`

以数组形式返回一个或多个语句的结果。结果始终为 0 个或多个对象的数组。

PowerShell

PS> $list = @(Get-Process | Select-Object -First 10; Get-Service | Select-Object -First 10 )
PS> $list.GetType()

IsPublic IsSerial Name                                     BaseType
-------- -------- ----                                     --------
True     True     Object[]                                 System.Array

PS> $list.Count
20
PS> $list = @(Get-Service | Where-Object Status -eq Starting )
PS> $list.GetType()

IsPublic IsSerial Name                                     BaseType
-------- -------- ----                                     --------
True     True     Object[]                                 System.Array

PS> $list.Count
0

哈希表文本语法 `@{}`

与数组子表达式类似，此语法用于声明哈希表。有关详细信息，请参阅 about_Hash_Tables。

调用运算符 `&`

运行命令、脚本或脚本块。调用运算符（也称为 调用运算符）允许运行存储在变量中并由字符串或脚本块表示的命令。调用运算符在子范围中执行。有关范围的详细信息，请参阅 about_Scopes。可以使用它生成包含所需命令、参数和参数的字符串，然后像调用命令一样调用字符串。创建的字符串必须与在命令行中键入的命令遵循相同的分析规则。有关详细信息，请参阅 about_Parsing。

此示例将命令存储在字符串中，并使用调用运算符执行该命令。

PowerShell

PS> $c = "Get-ExecutionPolicy"
PS> $c
Get-ExecutionPolicy
PS> & $c
AllSigned

调用运算符不分析字符串。这意味着在使用调用运算符时，不能在字符串中使用命令参数。

PowerShell

PS> $c = "Get-Service -Name Spooler"
PS> $c
Get-Service -Name Spooler
PS> & $c
& : The term 'Get-Service -Name Spooler' is not recognized as the name of a
cmdlet, function, script file, or operable program. Check the spelling of
the name, or if a path was included, verify that the path is correct and
try again.

Invoke-Expression cmdlet 可以执行导致使用调用运算符时分析错误的代码。

PowerShell

PS> & "1+1"
&: The term '1+1' is not recognized as a name of a cmdlet, function, script
file, or executable program. Check the spelling of the name, or if a path was
included, verify that the path is correct and try again.

PS> Invoke-Expression "1+1"
2

可以使用脚本的文件名执行脚本。脚本文件必须具有 .ps1 文件扩展名才能可执行文件。其路径中具有空格的文件必须用引号引起来。如果尝试执行带引号的路径，PowerShell 将显示带引号的字符串的内容，而不是运行脚本。调用运算符允许执行包含文件名的字符串的内容。

PowerShell

PS C:\Scripts> Get-ChildItem

    Directory: C:\Scripts


Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        8/28/2018   1:36 PM             58 script name with spaces.ps1

PS C:\Scripts> ".\script name with spaces.ps1"
.\script name with spaces.ps1
PS C:\Scripts> & ".\script name with spaces.ps1"
Hello World!

有关脚本块的详细信息，请参阅 about_Script_Blocks。

后台运算符 `&`

在后台、PowerShell 作业中运行管道。此运算符的行为类似于 UNIX 控件运算符与（&），该运算符在子Shell 中以作业的形式异步运行命令。

此运算符在功能上等效于 Start-Job。默认情况下，后台运算符在启动并行任务的调用方当前工作目录中启动作业。以下示例演示后台作业运算符的基本用法。

PowerShell

Get-Process -Name pwsh &

该命令在功能上等效于以下 Start-Job用法：

PowerShell

Start-Job -ScriptBlock {Get-Process -Name pwsh}

与 Start-Job一样，& 后台运算符返回 Job 对象。此对象可与 Receive-Job 和 Remove-Job一起使用，就像使用过 Start-Job 来启动作业一样。

PowerShell

$job = Get-Process -Name pwsh &
Receive-Job $job -Wait

Output


 NPM(K)    PM(M)      WS(M)     CPU(s)      Id  SI ProcessName
 ------    -----      -----     ------      --  -- -----------
      0     0.00     221.16      25.90    6988 988 pwsh
      0     0.00     140.12      29.87   14845 845 pwsh
      0     0.00      85.51       0.91   19639 988 pwsh

PowerShell

Remove-Job $job

& 后台运算符也是语句终止符，就像 UNIX 控件运算符和（&）。这使你可以在 & 后台运算符之后调用其他命令。以下示例演示了在 & 后台运算符之后调用其他命令。

PowerShell

$job = Get-Process -Name pwsh & Receive-Job $job -Wait

Output


 NPM(K)    PM(M)      WS(M)     CPU(s)      Id  SI ProcessName
 ------    -----      -----     ------      --  -- -----------
      0     0.00     221.16      25.90    6988 988 pwsh
      0     0.00     140.12      29.87   14845 845 pwsh
      0     0.00      85.51       0.91   19639 988 pwsh

这等效于以下脚本：

PowerShell

$job = Start-Job -ScriptBlock {Get-Process -Name pwsh}
Receive-Job $job -Wait

如果要运行多个命令，每个命令在各自的后台进程中，但全部位于一行中，只需在每个命令之间和之后放置 &。

PowerShell

Get-Process -Name pwsh & Get-Service -Name BITS & Get-CimInstance -ClassName Win32_ComputerSystem &

有关 PowerShell 作业的详细信息，请参阅 about_Jobs。

强制转换运算符 `[ ]`

将对象转换为或限制指定类型。如果无法转换对象，PowerShell 将生成错误。

PowerShell

[DateTime] '2/20/88' - [DateTime] '1/20/88' -eq [TimeSpan] '31'

在使用强制转换表示法分配变量时，还可以执行强制转换。

逗号运算符 `,`

作为二进制运算符，逗号将创建数组或追加到要创建的数组。在表达式模式下，作为一元运算符，逗号只创建一个成员的数组。将逗号置于成员前面。

PowerShell

$myArray = 1,2,3
$SingleArray = ,1
Write-Output (,1)

由于 Write-Output 需要参数，您必须将表达式置于括号中。

点溯源运算符 `.`

在当前作用域中运行脚本，以便脚本创建的任何函数、别名和变量都添加到当前范围，从而替代现有函数。脚本声明的参数将成为变量。没有给定值的参数将成为没有值的变量。但是，保留自动变量 $args。

PowerShell

. c:\scripts\sample.ps1 1 2 -Also:3

备注

点溯源运算符后跟空格。使用空格将点与表示当前目录的点（.）符号区分开来。

在以下示例中，当前目录中的 Sample.ps1 脚本在当前范围内运行。

PowerShell

. .\sample.ps1

Format 运算符 `-f`

提供对 .NET 复合格式设置功能的访问权限。复合格式字符串由与索引占位符混合的固定文本组成，称为 格式项。这些格式项对应于列表中的对象。

每个格式项采用以下形式，由以下组件组成：

{index[,alignment][:formatString]}

需要匹配大括号（{ 和 }）。

格式设置作将生成一个结果字符串，该字符串由原始固定文本与列表中的对象的字符串表示形式混合在一起。有关详细信息，请参阅复合格式。

在运算符左侧输入复合格式字符串，以及要设置运算符右侧格式的对象。

PowerShell

"{0} {1,-10} {2:N}" -f 1,"hello",[math]::pi

Output

1 hello      3.14

可以使用 “0”自定义说明符对数值进行零填充。 : 后面的零数指示将格式化字符串填充到的最大宽度。

PowerShell

"{0:00} {1:000} {2:000000}" -f 7, 24, 365

Output

07 024 000365

如果需要将大括号（{}）保留在带格式的字符串中，可以通过加倍大括号来转义它们。

PowerShell

"{0} vs. {{0}}" -f 'foo'

Output

foo vs. {0}

索引运算符 `[ ]`

从索引集合中选择对象，例如数组和哈希表。数组索引是从零开始的，因此第一个对象被索引为 [0]。还可以使用负索引获取最后一个值。哈希表按键值编制索引。

给定索引列表后，索引运算符将返回与这些索引对应的成员列表。

PowerShell

PS> $a = 1, 2, 3
PS> $a[0]
1
PS> $a[-1]
3
PS> $a[2, 1, 0]
3
2
1

PowerShell

(Get-HotFix | Sort-Object installedOn)[-1]

PowerShell

$h = @{key="value"; name="PowerShell"; version="2.0"}
$h["name"]

Output

PowerShell

PowerShell

$x = [xml]"<doc><intro>Once upon a time...</intro></doc>"
$x["doc"]

Output

intro
-----
Once upon a time...

当对象不是索引集合时，使用索引运算符访问第一个元素将返回对象本身。第一个元素之外的索引值返回 $null。

PowerShell

PS> (2)[0]
2
PS> (2)[-1]
2
PS> (2)[1] -eq $null
True
PS> (2)[0,0] -eq $null
True

管道运算符 `|`

将前面命令的输出发送到其后面的命令（“pipes”）。当输出包含多个对象（“集合”），管道运算符一次发送一个对象。

PowerShell

Get-Process | Get-Member
Get-Service | Where-Object {$_.StartType -eq 'Automatic'}

管道链运算符 `&&` 和 `||`

根据左侧管道的成功，有条件地执行右侧管道。

PowerShell

# If Get-Process successfully finds a process called notepad,
# Stop-Process -Name notepad is called
Get-Process notepad && Stop-Process -Name notepad

PowerShell

# If npm install fails, the node_modules directory is removed
npm install || Remove-Item -Recurse ./node_modules

有关详细信息，请参阅 About_Pipeline_Chain_Operators。

范围运算符 `..`

范围运算符可用于表示顺序整数或字符数组。范围运算符联接的值定义范围的开始和结束值。

备注

PowerShell 6 中添加了对字符范围的支持。

数字范围

PowerShell

1..10
$max = 10
foreach ($a in 1..$max) {Write-Host $a}

还可以按相反顺序创建范围。

PowerShell

10..1
5..-5 | ForEach-Object {Write-Output $_}

范围的开始值和结束值可以是计算结果为整数或字符的任何表达式对。范围的终结点必须可转换为有符号的 32 位整数（[int32]）。较大的值会导致错误。此外，如果在数组中捕获范围，生成的数组的大小限制为 [int]::MaxValue - 56。这是 .NET 中数组的最大大小。

例如，可以将枚举的成员用于开始值和结束值。

PowerShell

PS> enum Food {
      Apple
      Banana = 3
      Kiwi = 10
    }
PS> [Food]::Apple..[Food]::Kiwi
0
1
2
3
4
5
6
7
8
9
10

重要

生成的范围不限于枚举的值。而是表示提供的两个值之间的值范围。不能使用范围运算符可靠地表示枚举的成员。

字符范围

若要创建一系列字符，请将字符括在引号中。

PowerShell

PS> 'a'..'f'
a
b
c
d
e
f

PowerShell

PS> 'F'..'A'
F
E
D
C
B
A

如果将字符范围分配给字符串，则会将字符数组分配给字符串。

PowerShell

PS> [string]$s = 'a'..'e'
$s
a b c d e
$a = 'a', 'b', 'c', 'd', 'e'
$a
a b c d e

数组中的字符将联接到字符串中。字符由 $OFS 首选项变量的值分隔。有关详细信息，请参阅 about_Preference_Variables。

数组中的字符顺序由字符的 ASCII 值确定。例如，c 和 X 的 ASCII 值分别为 99 和 88。该范围将按相反的顺序显示。

PowerShell

PS> 'c'..'X'
c
b
a
`
_
^
]
\
[
Z
Y
X

成员访问运算符 `.`

访问对象的属性和方法。成员名称可以是表达式。

PowerShell

$myProcess.peakWorkingSet
(Get-Process PowerShell).Kill()
'OS', 'Platform' | Foreach-Object { $PSVersionTable. $_ }

从 PowerShell 3.0 开始，当对没有成员的列表集合对象使用运算符时，PowerShell 会自动枚举该集合中的项，并在其中每个项上使用运算符。有关详细信息，请参阅 about_Member Access_Enumeration。

静态成员运算符 `::`

调用 .NET 类的静态属性和方法。若要查找对象的静态属性和方法，请使用 Get-Member cmdlet 的 Static 参数。成员名称可以是表达式。

PowerShell

[datetime]::Now
'MinValue', 'MaxValue' | Foreach-Object { [int]:: $_ }

三元运算符 `? <if-true> : <if-false>`

在简单的条件情况下，可以使用三元运算符作为 if-else 语句的替代项。

有关详细信息，请参阅 about_If。

null 合并运算符 `??`

如果左作数不为 null，则 null 合并运算符 ?? 返回其左侧作数的值。否则，它将计算右侧作数并返回其结果。如果左侧作数的计算结果为非 null，则 ?? 运算符不会计算其右侧作数。

PowerShell

$x = $null
$x ?? 100

Output

在以下示例中，不会计算右侧作数。

PowerShell

[string] $todaysDate = '1/10/2020'
$todaysDate ?? (Get-Date).ToShortDateString()

Output

1/10/2020

null 合并赋值运算符 `??=`

null 合并赋值运算符 ??= 仅当左侧作数计算结果为 null 时，才将其右作数的值赋给其左侧作数。如果左侧作数的计算结果为非 null，则 ??= 运算符不会计算其右侧作数。

PowerShell

$x = $null
$x ??= 100
$x

Output

在以下示例中，不会计算右侧作数。

PowerShell

[string] $todaysDate = '1/10/2020'
$todaysDate ??= (Get-Date).ToShortDateString()
$todaysDate

Output

1/10/2020

null 条件运算符 `?.` 和 `?[]`

备注

此功能已从实验性迁移到 PowerShell 7.1 中的主流。

null 条件运算符仅当作数的计算结果为非 null 时，才对其作数应用成员访问、?.或元素访问 ?[]作数;否则，它将返回 null。

由于 PowerShell 允许 ? 成为变量名称的一部分，因此使用这些运算符需要对变量名称进行正式规范。必须在变量名称（如 ${a}）周围使用大括号（{}），或者当 ? 是变量名称 ${a?}的一部分时。

备注

不应将 ${<name>} 的变量名称语法与 $() 子表达式运算符混淆。有关详细信息，请参阅 about_Variables的“变量名称”部分。

在以下示例中，将返回 PropName 的值。

PowerShell

$a = @{ PropName = 100 }
${a}?.PropName

Output

以下示例返回 null，而不尝试访问 propName 的成员名称。

PowerShell

$a = $null
${a}?.PropName

在此示例中，返回索引元素的值。

PowerShell

$a = 1..10
${a}?[0]

Output

以下示例在不尝试访问索引元素的情况下返回 null。

PowerShell

$a = $null
${a}?[0]

通过

about_Operators

简短说明

长说明

算术运算符

赋值运算符

比较运算符

逻辑运算符

重定向运算符

拆分和联接运算符

类型运算符

一元运算符

特殊运算符

分组运算符 `( )`

分组结果表达式

管道分组表达式

分组赋值语句

子表达式运算符 `$( )`

数组子表达式运算符 `@( )`

哈希表文本语法 `@{}`

调用运算符 `&`

后台运算符 `&`

强制转换运算符 `[ ]`

逗号运算符 `,`

点溯源运算符 `.`

Format 运算符 `-f`

索引运算符 `[ ]`

管道运算符 `|`

管道链运算符 `&&` 和 `||`

范围运算符 `..`

数字范围

字符范围

成员访问运算符 `.`

静态成员运算符 `::`

三元运算符 `? <if-true> : <if-false>`

null 合并运算符 `??`

null 合并赋值运算符 `??=`

null 条件运算符 `?.` 和 `?[]`

另请参阅

其他资源

通过

about_Operators

简短说明

长说明

算术运算符

赋值运算符

比较运算符

逻辑运算符

重定向运算符

拆分和联接运算符

类型运算符

一元运算符

特殊运算符

分组运算符 ( )

分组结果表达式

管道分组表达式

分组赋值语句

子表达式运算符 $( )

数组子表达式运算符 @( )

哈希表文本语法 @{}

调用运算符 &

后台运算符 &

强制转换运算符 [ ]

逗号运算符 ,

点溯源运算符 .

Format 运算符 -f

索引运算符 [ ]

管道运算符 |

管道链运算符 && 和 ||

范围运算符 ..

数字范围

字符范围

成员访问运算符 .

静态成员运算符 ::

三元运算符 ? <if-true> : <if-false>

null 合并运算符 ??

null 合并赋值运算符 ??=

null 条件运算符 ?. 和 ?[]

另请参阅

其他资源

分组运算符 `( )`

子表达式运算符 `$( )`

数组子表达式运算符 `@( )`

哈希表文本语法 `@{}`

调用运算符 `&`

后台运算符 `&`

强制转换运算符 `[ ]`

逗号运算符 `,`

点溯源运算符 `.`

Format 运算符 `-f`

索引运算符 `[ ]`

管道运算符 `|`

管道链运算符 `&&` 和 `||`

范围运算符 `..`

成员访问运算符 `.`

静态成员运算符 `::`

三元运算符 `? <if-true> : <if-false>`

null 合并运算符 `??`

null 合并赋值运算符 `??=`

null 条件运算符 `?.` 和 `?[]`