about_Operators

發行項
05/09/2024

簡短描述

描述 PowerShell 支援的運算子。

完整描述

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

算術運算子

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

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

位運算子 (-band、-bor、、、、、-shl-bnot-bxor) -shr 操作值的位模式。

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

指派運算子

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

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

比較運算子

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

比較運算子也包含尋找或取代文字模式的運算符。 -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

分割和聯結運算符

和 -join 運算子會-split分割和合併子字串。運算符 -split 會將字串分割成子字串。運算符 -join 會將多個字串串連成單一字串。

如需詳細資訊，請參閱 about_Split 和 about_Join。

運算子型別

使用、) -isnot-as (-is類型運算符來尋找或變更物件的 .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。您可以使用這個來建置包含所需命令、參數和自變數的字串，然後叫用字串，就像是命令一樣。您所建立的字串必須遵循與您在命令列中輸入的命令相同的剖析規則。如需詳細資訊，請參閱 about_Parsing。

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

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 控制運算符連字元和 () & ，它會在子Shell 中以異步方式以作業方式執行命令。

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

Get-Process -Name pwsh &

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

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

就像一樣 Start-Job，背景運算符會 & 傳 Job 回物件。這個物件可以搭配 Receive-Job 和 Remove-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 控制運算符連字元和 (&) 一樣。這可讓您在背景運算符之後 & 叫用其他命令。下列範例示範背景運算符之後 & 的其他命令調用。

$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

格式運算元 `-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

管線運算子 `|`

傳送 (“pipes”，) 前面命令的輸出傳送至其後面的命令。當輸出包含多個物件 (“collection”) 時，管線運算符會一次傳送一個物件。

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>} 不應與 $() subexpression 運算子混淆。如需詳細資訊，請參閱 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 運算符 `$( )`

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

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

呼叫運算子 `&`

背景運算元 `&`

轉換運算元 `[ ]`

逗號運算子 `,`

點來源運算子 `.`

格式運算元 `-f`

索引運算子 `[ ]`

管線運算子 `|`

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

範圍運算子 `..`

數字範圍

字元範圍

成員存取運算子 `.`

靜態成員運算符 `::`

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

Null 聯合運算符 `??`

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

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

另請參閱

其他資源

共用方式為

about_Operators

簡短描述

完整描述

算術運算子

指派運算子

比較運算子

邏輯運算子

重新導向運算子

分割和聯結運算符

運算子型別

一元運算子

特殊運算子

群組運算子 ( )

群組結果表達式

管線群組表達式

群組指派語句

Subexpression 運算符 $( )

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

哈希表常值語法 @{}

呼叫運算子 &

背景運算元 &

轉換運算元 [ ]

逗號運算子 ,

點來源運算子 .

格式運算元 -f

索引運算子 [ ]

管線運算子 |

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

範圍運算子 ..

數字範圍

字元範圍

成員存取運算子 .

靜態成員運算符 ::

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

Null 聯合運算符 ??

Null 聯合指派運算符 ??=

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

另請參閱

其他資源

群組運算子 `( )`

Subexpression 運算符 `$( )`

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

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

呼叫運算子 `&`

背景運算元 `&`

轉換運算元 `[ ]`

逗號運算子 `,`

點來源運算子 `.`

格式運算元 `-f`

索引運算子 `[ ]`

管線運算子 `|`

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

範圍運算子 `..`

成員存取運算子 `.`

靜態成員運算符 `::`

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

Null 聯合運算符 `??`

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

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