主題
    about_Quoting_Rules

簡短描述
    說明在 Windows PowerShell 中使用單引號和雙引號的規則。


完整描述
    引號用於指定常值字串。您可以使用單引號 (') 或雙引號 (") 括住字串。
 

    引號也用於建立 here-string。here-string 是單引號或雙引號字串,當中的引號會照其原樣解
    譯。here-string 可以跨越多行, 其中的所有行都會被解譯為字串,不論是否以引號括住。


    至於傳至遠端電腦的命令,引號則是用來定義要在遠端電腦上執行的命令部分。在遠端工
    作階段中,引號也用於判斷命令中的變數是先在本機電腦還是遠端電腦上解譯。


 單引號和雙引號字串

      使用雙引號括住字串 (雙引號字串) 時,以貨幣符號 ($) 開頭的變數名稱會被取代為變數
      的值,然後字串才傳遞給命令進行處理。
 

      例如:

          $i = 5
          "$i 的值為 $i。"


      此命令的輸出為: 

          5 的值為 5。


      此外,雙引號字串中的運算式會經過評估,而結果會插入至字串中。例如:

	  "$(2+3) 的值為 5。"


      此命令的輸出為:

	  5 的值為 5。


      使用單引號括住字串 (單引號字串) 時,會將實際輸入的字串內容傳遞給命令。並沒有
      取代的情形發生。例如:

          $i = 5
          '$i 的值為 $i。'


      此命令的輸出為: 

          $i 的值為 $i。


      同樣的,也不會評估單引號字串中的運算式, 而會照其原樣加以解譯。例如:

	  '$(2+3) 的值為 5。'


      此命令的輸出為:

	  $(2+3) 的值為 5。


      如果不要雙引號字串中發生以變數值取代的情形,請使用倒引號字元 (`)(ASCII 96),這是 
      Windows PowerShell 逸出字元。


      以下範例在第一個 $i 變數前面加上倒引號字元,可防止 Windows PowerShell 將變數名稱
      取代為變數值。例如:

          $i = 5
          "`$i 的值為 $i。"


      此命令的輸出為: 

          $i 的值為 5。
     
    
      若要在字串中顯示雙引號,請以單引號括住整個字串。例如:

          '就像他們說的:"活到老學到老"。'


      此命令的輸出為:

          就像他們說的:"活到老學到老"。


      您也可以在雙引號字串中使用單引號字串。例如:

          "就像他們說的:'活到老學到老'。"


      此命令的輸出為:

          就像他們說的:'活到老學到老'。


      或者,再以雙引號括住雙引號片語。例如:

          "就像他們說的:""活到老學到老""。"


      此命令的輸出為:

          就像他們說的:"活到老學到老"。


      若要在單引號字串中加入單引號,請使用兩個連續單引號。例如:

          'don''t'


      此命令的輸出為:

          don't


      若要強制 Windows PowerShell 照原樣解譯雙引號,請使用倒引號字元。這樣可避免 
      Windows PowerShell 將引號解譯為字串分隔符號。例如:

          "使用引號 (`") 開始字串。"


      由於單引號字串的內容會照原樣解譯,因此您不能使用倒引號字元來強制將常值字元解譯為單引號字串。

 
      例如,下列命令會產生錯誤,因為 Windows PowerShell 無法辨識逸出字元, 反而將第二
      個引號視為字串結尾。


	  PS C:\> '使用引號 (`') 開始字串。'
          運算式或陳述式中有未預期的 ')' 語彙基元。
          位於第 1 行,第 27 個字元
          + '使用引號 (`') <<<< 開始字串。'


 單引號和雙引號 Here-String

      Here-string 的引號規則有點不同。


      here-string 是單引號或雙引號字串,當中的引號會照其原樣解譯。here-string 可以跨越多
      行, 其中的所有行都會被解譯為字串,不論是否以引號括住。


      與規則字串相同,雙引號 here-string 中的變數會被其值取代。而單引號 here-string 中的
      變數則不會被值取代。

 
      您可以在 here-string 中使用任何文字,但對下列文字種類特別有用:

          - 包含常值引號的文字、多行文字 (例如 HTML 或 XML 文件中的文字)、指令碼或
            函數的說明文字


      here-string 可以具有下列其中一種格式,其中 <Enter> 代表按下 ENTER 鍵時新增的換行
      符號或新行隱藏字元。
 

      格式 1:

	  @"<Enter>
          <字串> [字串] ...<Enter>
          "@


      格式 2:
 
	  @'<Enter>
          <字串> [字串] ...<Enter>
          '@


      在兩個格式中,右引號都必須是一行的第一個字元。

   
      here-string 包含兩個隱藏字元之間的所有文字。
      here-string 中的所有引號都會照原樣解譯。
      例如:

	  @"
	  如需說明,請輸入 "get-help"
	  "@

    
      此命令的輸出為:

	  如需說明,請輸入 "get-help"


      使用 here-string 可簡化在命令中使用字串。例如:

	  @"
          使用引號 (') 開始字串。
          "@

	    
      此命令的輸出為:

          使用引號 (') 開始字串。


      單引號 here-string 中的變數會照原樣解譯並完整重現。例如:

          @'
	  $profile 變數包含
          Windows PowerShell 設定檔的路徑。
          '@


      此命令的輸出為:

	  $profile 變數包含
          Windows PowerShell 設定檔的路徑。


      雙引號 here-string 中的變數會被其值取代。例如:

	  @" 
          即使您尚未建立設定檔,設定檔的路徑仍為:
          $profile。
          "@

    
      此命令的輸出為:

	  即使您尚未建立設定檔,
	  設定檔的路徑仍為:
	  C:\Users\User01\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1。


      Here-string 通常用來指派多行給變數。例如,下列 here-string 會將 XML 頁面指派給 
      $page 變數。


        $page = [XML] @"
        <command:command 
        xmlns:maml="https://schemas.microsoft.com/maml/2004/10" 
        xmlns:command="https://schemas.microsoft.com/maml/dev/command/2004/10" 
        xmlns:dev="https://schemas.microsoft.com/maml/dev/2004/10">
 	    <command:details>
	    	    <command:name>
                       Format-Table
		    </command:name>
		    <maml:description>
			<maml:para>將輸出格式化為表格。</maml:para> 
		    </maml:description>
		    <command:verb>format</command:verb>
		    <command:noun>table</command:noun>
		    <dev:version></dev:version>
 	    </command:details>
        ...
        </command:command>
        "@
   

      Here-string 也能用於格式化 ConvertFrom-StringData Cmdlet 的輸入,它會將 
      here-string 轉換成雜湊表。如需詳細資訊,請參閱 ConvertFrom-StringData。


請參閱
    about_Escape_Characters
    ConvertFrom-StringData




目錄