about_Quoting_Rules
簡短描述
描述在PowerShell中使用單引號和雙引號的規則。
完整描述
引號可用來指定常值字串。 您可以使用單引號括住字串, ('
) 或雙引號 ("
) 。
引號也可用來建立 here-string。 here-string 是單引號或雙引號字串,以常值方式解譯引號。 here-string 可以跨越多行。 此處字串中的所有行都會解譯為字串,即使它們未以引號括住也一樣。
在遠端電腦的命令中,引號會定義在遠端電腦上執行的命令部分。 在遠端會話中,引號也會決定命令中的變數會先在本機計算機或遠端電腦上解譯。
雙引號字串
以雙引弧括住的字串是 可展開 的字串。 $
() 前面加上貨幣符號的變數名稱會取代為變數的值,然後再將字串傳遞至 命令進行處理。
例如:
$i = 5
"The value of $i is $i."
此指令輸出為:
The value of 5 is 5.
此外,在雙引號字串中,會評估表達式,並將結果插入字串中。 例如:
"The value of $(2+3) is 5."
此指令輸出為:
The value of 5 is 5.
只有基本變數參考可以直接內嵌在可展開的字串中。 使用陣列索引或成員存取的變數參考必須包含在子表達式中。 例如:
"PS version: $($PSVersionTable.PSVersion)"
PS version: 7.2.0
若要分隔變數名稱與字串中的後續字元,請將它括在大括號 ({}
) 。 如果變數名稱後面接著冒號, :
() ,這特別重要。 PowerShell 會考慮 與:
範圍規範之間的$
一切,通常會導致解譯失敗。 例如, "$HOME: where the heart is."
擲回錯誤,但 "${HOME}: where the heart is."
如預期般運作。
若要避免在雙引號字串中替代變數值,請使用反引號字元 (`
) ,也就是 PowerShell 逸出字元。
在下列範例中,第一個 $i
變數前面的反引號字元會防止 PowerShell 將變數名稱取代為其值。
例如:
$i = 5
"The value of `$i is $i."
此指令輸出為:
The value of $i is 5.
單引號字串
以單引弧括住的字串是 逐字 字串。 字串會與您輸入字串一樣傳遞至命令。 不會執行替代。 例如:
$i = 5
'The value of $i is $i.'
此指令輸出為:
The value $i is $i.
同樣地,不會評估單引號字串中的表達式。 它們會解譯為字串常值。 例如:
'The value of $(2+3) is 5.'
此指令輸出為:
The value of $(2+3) is 5.
在字串中包含引號字元
若要讓雙引號出現在字串中,請以單引號括住整個字串。 例如:
'As they say, "live and learn."'
此指令輸出為:
As they say, "live and learn."
您也可以在雙引號字串中括住單引號字串。 例如:
"As they say, 'live and learn.'"
此指令輸出為:
As they say, 'live and learn.'
或者,在雙引號片語周圍加上雙引號。 例如:
"As they say, ""live and learn."""
此指令輸出為:
As they say, "live and learn."
若要在單引號字串中包含單引號,請使用第二個連續的單引號。 例如:
'don''t'
此指令輸出為:
don't
若要強制 PowerShell 以常值方式解譯雙引號,請使用反引號字元。 這可防止PowerShell將引號解譯為字串分隔符。 例如:
"Use a quotation mark (`") to begin a string."
'Use a quotation mark (`") to begin a string.'
由於單引號字串的內容會以常值方式解譯,所以反引號字元會被視為常值字元,並顯示在輸出中。
Use a quotation mark (") to begin a string.
Use a quotation mark (`") to begin a string.
Here-strings
此處字串的引號規則稍有不同。
here-string 是以單引號或雙引弧括住的字串, @
() 。 此處字串內的引號會以常值方式解譯。
here-string:
- 跨越多行
- 開頭標記後面接著換行符
- 結尾為換行符,後面接著結尾標記
- 在單一字串中,包含開頭和結尾標記之間的每一行
如同一般字串,變數會以雙引號此處字串取代其值。 在此處以單引號括住的字串中,變數不會由其值取代。
您可以針對任何文字使用 here-strings,但對於下列類型的文字特別有用:
- 包含常值引號的文字
- 多行文字,例如 HTML 或 XML 區塊中的文字
- 文稿或函式檔的說明文字
這裡字串可以有下列其中一種格式,其中 <Enter>
代表按下 ENTER 鍵時新增的換行字元或換行符。
雙引號:
@"<Enter>
<string> [string] ...<Enter>
"@
單引號:
@'<Enter>
<string> [string] ...<Enter>
'@
注意
最後的換行符是結尾標記的一部分。 它不會新增至 here-string。
這裡字串包含開頭和結尾標記之間的所有文字。 在此字串中,所有引號都會以常值方式解譯。 例如:
@"
For help, type "get-help"
"@
此指令輸出為:
For help, type "get-help"
使用 here-string 可以簡化在命令中使用字串。 例如:
@"
Use a quotation mark, like ' or ", to begin a string.
"@
此指令輸出為:
Use a quotation mark, like ' or ", to begin a string.
在此處的單引號字串中,變數會以常值方式解譯並完全重現。 例如:
@'
The $profile variable contains the path
of your PowerShell profile.
'@
此指令輸出為:
The $profile variable contains the path
of your PowerShell profile.
在此處以雙引號括住的字串中,變數會由其值取代。 例如:
@"
Even if you have not created a profile,
the path of the profile file is:
$profile.
"@
此指令輸出為:
Even if you have not created a profile,
the path of the profile file is:
C:\Users\User1\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1.
這裡字串通常用於將多行指派給變數。 例如,下列 here-string 會將 XML 的頁面指派給$page變數。
$page = [XML] @"
<command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10"
xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10"
xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10">
<command:details>
<command:name>
Format-Table
</command:name>
<maml:description>
<maml:para>Formats the output as a table.</maml:para>
</maml:description>
<command:verb>format</command:verb>
<command:noun>table</command:noun>
<dev:version></dev:version>
</command:details>
...
</command:command>
"@
這裡字串也是 Cmdlet 輸入 ConvertFrom-StringData
的便利格式,可將這裡字串轉換成哈希表。
如需詳細資訊,請參閱ConvertFrom-StringData
。
注意
PowerShell 允許雙引號或單引號字串跨越多行,而不需使用 @
這裡字串串的語法。 不過,這裡的完整字串語法是慣用的用法。
可展開字串的解譯
展開的字串不一定與您在控制台中看到的預設輸出相同。
集合,包括數位,會藉由在元素的字串表示之間放置單一空格,以轉換成字串。 您可以藉由設定喜好設定變數 $OFS
來指定不同的分隔符。 如需詳細資訊,請參閱喜好設定$OFS
變數。
任何其他型別的實例會藉由呼叫 ToString()
方法轉換成字串,這可能不會提供有意義的表示法。 例如:
"hashtable: $(@{ key = 'value' })"
hashtable: System.Collections.Hashtable
若要取得與主控台相同的輸出,請使用您透過管道傳送至 Out-String
的子運算式。 如果您想要移除任何開頭和尾端空白行,請 Trim()
套用 方法。
"hashtable:`n$((@{ key = 'value' } | Out-String).Trim())"
hashtable:
Name Value
---- -----
key value
文化特性設定會影響字串解譯
方法 ToString()
會使用目前設定的文化特性設定,將值轉換成字串。 例如,下列 PowerShell 工作階段的文化特性會設定為 de-DE
。 ToString()
當 方法將 的值$x
轉換成字串時,它會針對小數分隔符使用逗號 (,
) 。 此外,方法會 ToString()
使用德文地區設定的適當格式,將日期轉換為字串。
PS> Get-Culture
LCID Name DisplayName
---- ---- -----------
1031 de-DE German (Germany)
PS> $x = 1.2
PS> $x.ToString()
1,2
PS> (Get-Date 2024-03-19).ToString()
19.03.2024 00:00:00
不過,PowerShell 會在解譯可展開的字串表達式時使用不因文化特性而異。
PS? "$x"
1.2
PS> "$(Get-Date 2024-03-19)"
03/19/2024 00:00:00
將引號字串傳遞至外部命令
某些原生命令需要包含引號字元的自變數。 PowerShell 會在將字串傳遞至外部命令之前解譯引號字串。 此解譯會移除外引號字元。
如需此行為的詳細資訊,請參閱 about_Parsing 文章。