about_Operators

發行項
02/27/2024

簡短描述

描述 PowerShell 支援的運算子。

詳細描述

運算子是可在命令或表達式中使用的語言專案。 PowerShell 支援數種類型的運算子，以協助您操作值。

算術運算子

使用算術運算子（+、、 -*、 /%）來計算命令或表示式中的值。使用這些運算符，您可以加入、減去、乘法或除法值，並計算除法運算的餘數（模數）。

加號運算符會串連專案。乘法運算符會傳回每個元素的指定複本數目。您可以在實作算術的任何 .NET 類型上使用算術運算符，例如： Int、 String、 DateTime、 Hashtable和陣列。

位運算子（-band、-bor-bxor-bnot-shl 、 -shr）會操作值中的位元模式。

如需詳細資訊，請參閱 about_Arithmetic_Operators。

指派運算子

使用指派運算子（=、-=*=+=/= 、 %=）將值指派、變更或附加至變數。您可以將算術運算符與指派結合，將算術運算的結果指派給變數。

如需詳細資訊，請參閱 about_Assignment_Operators。

比較運算子

使用比較運算子（-eq、、 -ne、 -lt-gt、 -le-ge）來比較值和測試條件。例如，您可以比較兩個字串值，以判斷它們是否相等。

比較運算子也包含尋找或取代文字模式的運算符。（-match、 -notmatch-replace、）運算子使用正規表示式，而（-like、 -notlike）則使用通配符 *。

內含項目比較運算符會判斷測試值是否出現在參考集（-in、、 -notin） -contains-notcontains中。

類型比較運算子（-is， -isnot）會判斷物件是否為指定的型別。

如需詳細資訊，請參閱 about_Comparison_Operators。

邏輯運算子

使用邏輯運算子（-and、、 -xor-or、 -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 中，還有其他行為。

群組結果表達式

(...)可讓您讓命令的輸出參與表達式。例如：

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

管線群組表達式

當做管線的第一個區段使用時，將命令或表達式包裝在括弧中，不一定會造成 表達式結果的列舉 。如果括弧包裝命令，則會在透過管線傳送結果之前，先執行以在記憶體中收集的所有輸出完成。

在管線之前將表達式分組也可確保後續的物件逐對象處理不會干擾命令用來產生其輸出的列舉。

群組指派語句

未分組的指派語句不會輸出值。將指派語句分組時，會傳遞指派變數的值，並可用於較大的表達式中。例如：

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

將語句包裝在括弧中，會將它轉換成輸出值的 $var表達式。

此行為適用於所有指派運算符，包括、等 +=複合運算符以及遞增（++）和遞減（--）運算符。不過，遞增和遞減的作業順序取決於其位置。

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

在前置詞案例中，的值 $i 會在輸出之前遞增。在後置案例中，的值 $i 會在輸出之後遞增。

您也可以在條件語句的內容中使用這項技術，例如 if 語句。

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

在這裡範例中，如果沒有相符的檔案， Get-ChildItem 則命令不會傳回任何專案，並將任何指派給 $textFiles，這會在布爾值內容中視為 $false 。如果將一或多個 FileInfo 物件指派給 $textFiles，則條件式會評估為 $true。您可以使用語句主體if中的值$textFiles。

注意

雖然這項技術方便且簡潔，但可能會導致指派運算符（）與等號比較運算符（=-eq）之間的混淆。

Subexpression 運算符 `$( )`

傳回一或多個語句的結果。針對單一結果，傳回純量。針對多個結果，傳回陣列。當您想要在另一個運算式內使用表示式時，請使用此選項。例如，若要在字串表示式中內嵌命令的結果。

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 個或多個物件的陣列。

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。

此範例會將命令儲存在字串中，並使用呼叫運算符執行。

PS> $c = "get-executionpolicy"
PS> $c
get-executionpolicy
PS> & $c
AllSigned

呼叫運算子不會剖析字串。這表示當您使用呼叫運算符時，無法在字串中使用命令參數。

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 可以執行程式碼，以在使用呼叫運算符時造成剖析錯誤。

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 會顯示引號字串的內容，而不是執行腳本。呼叫運算子可讓您執行包含檔名的字串內容。

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 控制項運算子 ampersand （&），它會在子Shell 中以異步方式在子Shell 中以作業方式執行命令。

此運算子的功能相當於 Start-Job。根據預設，背景運算符會啟動啟動平行工作的呼叫端目前工作目錄中的工作。下列範例示範背景作業運算數的基本用法。

Get-Process -Name pwsh &

該命令的功能相當於下列用法 Start-Job：

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

就像 Start-Job，背景運算符會 & 傳 Job 回物件。此物件可以搭配和 Remove-Job使用Receive-Job，就像您曾經用來Start-Job啟動作業一樣。

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


 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

Remove-Job $job

&背景運算符也是語句終止符，就像 UNIX 控件運算符 ampersand （&）。這可讓您在背景運算符之後 & 叫用其他命令。下列範例示範在背景運算符之後 & 叫用其他命令。

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


 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

這相當於下列腳本：

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

如果您想要執行多個命令，每個命令都會在自己的背景進程中，但全部放在一行，只要在每個命令之間和之後放置 & 。

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

如需 PowerShell 作業的詳細資訊，請參閱 about_Jobs。

轉換運算元 `[ ]`

將物件轉換成或限制指定的型別。如果無法轉換物件，PowerShell 會產生錯誤。

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

當變數指派給使用轉換表示法時，也可以執行轉換。

逗號運算子 `,`

做為二進位運算符，逗號會建立陣列或附加至所建立的陣列。在表達式模式中，以一元運算符的形式，逗號只會建立一個成員的陣列。將逗號放在成員前面。

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

因為 Write-Output 需要自變數，因此您必須將表達式放在括弧中。

點來源運算子 `.`

在目前範圍中執行腳本，讓腳本建立的任何函式、別名和變數都會新增至目前的範圍，並覆寫現有的函式。腳本所宣告的參數會變成變數。未指定任何值的參數會變成沒有值的變數。不過，會保留自動變數 $args 。

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

注意

點來源運算子後面接著空格。使用空格來區分點與代表目前目錄的點（.）符號。

在下列範例中，目前目錄中的Sample.ps1腳本會在目前範圍中執行。

. .\sample.ps1

Format 運算符 `-f`

使用字串物件的 format 方法格式化字串。在運算子左邊輸入格式字串，以及要格式化在運算元右邊的物件。

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

1 hello      3.14

您可以使用「0」自訂規範來將數值零位。後面的 : 零數表示要填補格式化字串的最大寬度。

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

07 024 000365

如果您需要將大括號（{}）保留在格式化字串中，您可以藉由將大括弧加倍來逸出它們。

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

foo vs. {0}

如需詳細資訊，請參閱 String.Format 方法和複合格式。

索引運算子 `[ ]`

從索引集合中選取物件，例如數位和哈希表。陣列索引是以零起始，因此第一個物件會編製索引為 [0]。您也可以使用負數索引來取得最後一個值。哈希表會依索引鍵值編製索引。

指定索引清單時，索引運算符會傳回對應至這些索引的成員清單。

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

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

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

PowerShell

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

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

當物件不是索引集合時，使用索引運算符存取第一個項目會傳回物件本身。超出第一個專案的索引值會傳回 $null。

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

管線運算子 `|`

將前面命令的輸出傳送至後面命令的輸出。當輸出包含多個物件（「集合」時，管線運算符會一次傳送一個物件。

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

管線鏈結運算子 `&&` 和 `||`

根據左側管線的成功，有條件地執行右側管線。

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

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

如需詳細資訊，請參閱 About_Pipeline_Chain_Operators。

範圍運算子 `..`

範圍運算子可用來表示循序整數或字元的陣列。範圍運算子所聯結的值會定義範圍的開始和結束值。

注意

PowerShell 6 已新增字元範圍支援。

數字範圍

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

您也可以以反向順序建立範圍。

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

範圍的開始和結束值可以是任何評估為整數或字元的表達式組。範圍的端點必須可轉換成帶正負號的32位整數（[int32]）。較大的值會造成錯誤。此外，如果在數位中擷取範圍，產生的陣列大小會限製為 [int]::MaxValue - 56。這是 .NET 中陣列的大小上限。

例如，您可以使用列舉的成員作為開始和結束值。

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

重要

產生的範圍不限於列舉的值。相反地，它代表所提供兩個值之間的值範圍。您無法使用範圍運算子可靠地表示列舉的成員。

字元範圍

若要建立字元範圍，請以引號括住字元。

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

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

如果您將字元範圍指派給字串，則會將字元陣列指派給字串的相同。

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 值。例如，和 X 的 c ASCII 值分別為 99 和 88。該範圍會以反向順序呈現。

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

成員存取運算子 `.`

存取物件的屬性和方法。成員名稱可能是表達式。

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

從 PowerShell 3.0 開始，當您在沒有成員的清單集合物件上使用運算符時，PowerShell 會自動列舉該集合中的專案，並在每個集合上使用運算符。如需詳細資訊，請參閱 about_Member-Access_Enumeration。

靜態成員運算符 `::`

呼叫 .NET 類別的靜態屬性和方法。若要尋找對象的靜態屬性和方法，請使用 Cmdlet 的 Get-Member Static 參數。成員名稱可能是表達式。

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

三元運算子 `? <if-true> : <if-false>`

您可以在簡單的條件式案例中使用三元運算子來取代 if-else 語句。

如需詳細資訊，請參閱 about_If。

Null 聯合運算符 `??`

Null 聯合運算符 ?? 會傳回其左側操作數的值，如果不是 Null，則傳回其值。否則，它會評估右側操作數，並傳回其結果。如果左方運算元評估為非 Null，?? 運算子不會評估其右方運算元。

$x = $null
$x ?? 100

在下列範例中，將不會評估右側操作數。

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

1/10/2020

Null 聯合指派運算符 `??=`

Null 聯合指派運算符 ??= 只有在左側操作數評估為 null 時，才會將右操作數的值指派給其左側操作數。如果左方運算元評估為非 Null，??= 運算子不會評估其右方運算元。

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

在下列範例中，將不會評估右側操作數。

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

1/10/2020

Null 條件運算子 `?.` 和 `?[]`

注意

此功能已從實驗性移至 PowerShell 7.1 中的主流。

Null 條件運算子只有在操作數評估為非 Null 時，才會將成員存取、 ?.或專案存取 ?[]、作業套用至其操作數，否則會傳回 null。

由於 PowerShell 允許 ? 成為變數名稱的一部分，因此使用這些運算元需要變數名稱的正式規格。您必須在變數名稱周圍使用大括弧（{}），例如 ${a} 或當是變數名稱${a?}的一部分時?。

注意

的變數名稱語法 ${<name>} 不應與 $() 子表達式運算子混淆。如需詳細資訊，請參閱 about_Variables的變數名稱一節。

在下列範例中，會傳回 PropName 的值。

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

下列範例會傳回 null，而不嘗試存取成員名稱 PropName。

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

在此範例中，會傳回索引專案的值。

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

下列範例會傳回 null，而不嘗試存取索引專案。

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

about_Operators

簡短描述

詳細描述

算術運算子

指派運算子

比較運算子

邏輯運算子

重新導向運算子

分割和聯結運算符

類型運算元

一元運算子

特殊運算子

群組運算子 `( )`

群組結果表達式

管線群組表達式

群組指派語句

Subexpression 運算符 `$( )`

陣列子表達式運算子 `@( )`

哈希表常值語法 `@{}`

呼叫運算子 `&`

背景運算元 `&`

轉換運算元 `[ ]`

逗號運算子 `,`

點來源運算子 `.`

Format 運算符 `-f`

索引運算子 `[ ]`

管線運算子 `|`

管線鏈結運算子 `&&` 和 `||`

範圍運算子 `..`

數字範圍

字元範圍

成員存取運算子 `.`

靜態成員運算符 `::`

三元運算子 `? <if-true> : <if-false>`

Null 聯合運算符 `??`

Null 聯合指派運算符 `??=`

Null 條件運算子 `?.` 和 `?[]`

另請參閱

意見反應

其他資源

about_Operators

簡短描述

詳細描述

算術運算子

指派運算子

比較運算子

邏輯運算子

重新導向運算子

分割和聯結運算符

類型運算元

一元運算子

特殊運算子

群組運算子 ( )

群組結果表達式

管線群組表達式

群組指派語句

Subexpression 運算符 $( )

陣列子表達式運算子 @( )

哈希表常值語法 @{}

呼叫運算子 &

背景運算元 &

轉換運算元 [ ]

逗號運算子 ,

點來源運算子 .

Format 運算符 -f

索引運算子 [ ]

管線運算子 |

管線鏈結運算子 && 和 ||

範圍運算子 ..

數字範圍

字元範圍

成員存取運算子 .

靜態成員運算符 ::

三元運算子 ? <if-true> : <if-false>

Null 聯合運算符 ??

Null 聯合指派運算符 ??=

Null 條件運算子 ?. 和 ?[]

另請參閱

意見反應

其他資源

群組運算子 `( )`

Subexpression 運算符 `$( )`

陣列子表達式運算子 `@( )`

哈希表常值語法 `@{}`

呼叫運算子 `&`

背景運算元 `&`

轉換運算元 `[ ]`

逗號運算子 `,`

點來源運算子 `.`

Format 運算符 `-f`

索引運算子 `[ ]`

管線運算子 `|`

管線鏈結運算子 `&&` 和 `||`

範圍運算子 `..`

成員存取運算子 `.`

靜態成員運算符 `::`

三元運算子 `? <if-true> : <if-false>`

Null 聯合運算符 `??`

Null 聯合指派運算符 `??=`

Null 條件運算子 `?.` 和 `?[]`