主題
    about_Language_Keywords

簡短描述
    說明 Windows PowerShell 指令碼語言中的關鍵字。


完整描述
    Windows PowerShell 具有下列語言關鍵字。如需詳細資訊,請參閱關鍵字的「關於」
    主題,以及下表後面的資訊。


        關鍵字             參考資料
        -------            ---------
        Begin              about_Functions, about_Functions_Advanced
        Break              about_Break, about_Trap
        Catch              about_Try_Catch_Finally
        Continue           about_Continue, about_Trap
        Data               about_Data_Sections
        Do                 about_Do, about_While 
        Dynamicparam       about_Functions_Advanced_Parameters
        Else               about_If 
        Elseif             about_If 
        End                about_Functions, about_Functions_Advanced_Methods
        Exit               本主題中說明.
        Filter             about_Functions
        Finally            about_Try_Catch_Finally
        For                about_For
        Foreach            about_Foreach
        From               保留供未來使用。
        Function           about_Functions, about_Functions_Advanced
        If                 about_If
        In                 about_Foreach
        Param              about_Functions
        Process            about_Functions, about_Functions_Advanced
        Return             about_Return
        Switch             about_Switch
        Throw              about_Throw, about_Functions_Advanced_Methods
        Trap               about_Trap, about_Break, about_Try_Catch_Finally
        Try                about_Try_Catch_Finally
        Until              about_Do
        While              about_While, about_Do

  語言關鍵字

      Begin 
      -----

      與 Dynamicparam、Process 和 End 關鍵字一起組成函數主體的一部分。在從管線
      收到任何物件之前,Begin 陳述式清單會執行一次。

      語法:

          function <名稱> { 
              dynamicparam {<陳述式清單>}
              begin {<陳述式清單>}
              process {<陳述式清單>}
              end {<陳述式清單>}
          }

      Break
      -----

      讓指令碼離開迴圈。

      語法:

          while (<條件>) {
              <陳述式>
                   ...
              break 
                   ...
              <陳述式> 
          }

      Catch
      -----

      指定當伴隨的 Try 陳述式清單發生錯誤時,所要執行的陳述式清單。錯誤類型需使
      用方括號。第二對方括號表示錯誤類型為選擇項。

      語法:
      
          try {<陳述式清單>}
          catch [[<錯誤類型>]] {<陳述式清單>}

      Continue
      --------

      讓指令碼停止執行迴圈,並返回條件。如果條件符合,指令碼會再次開始迴圈。

      語法:

          while (<條件>) {
              <陳述式>
                  ...
              continue 
                  ...
              <陳述式> 
          }

      Data  
      ---- 

      在指令碼中定義區段,用來區別資料與指令碼邏輯。此外,還也能包含 If 陳述式
      和一些受限命令。

      語法:

      data <變數> [-supportedCommand <Cmdlet 名稱>] {<允許的內容>}

      Do  
      --

      與 While 或 Until 關鍵字搭配使用,形成迴圈建構。與使用 While 的迴圈不同,
      Windows PowerShell 至少會執行一次陳述式清單。

      語法:

          do {<陳述式清單>} while (<條件>)

          do {<陳述式清單>} until (<條件>)

      Dynamicparam
      ------------

      與 Begin、Process 和 End 關鍵字一起組成函數主體的一部分。動態參數是在執行
      階段加入的。

      語法:

          function <名稱> { 
              dynamicparam {<陳述式清單>}
              begin {<陳述式清單>}
              process {<陳述式清單>}
              end {<陳述式清單>}
          }

      Else
      ----

      與 If 關鍵字搭配使用,指定預設的陳述式清單。

      語法:

          if (<條件>) {<陳述式清單>}
          else {<陳述式清單>}

      Elseif
      ------

      與 If 和 Else 關鍵字搭配使用,指定其他條件。Else 關鍵字為選擇項。

      語法:

          if (<條件>) {<陳述式清單>}
          elseif (<條件>) {<陳述式清單>}
          else {<陳述式清單>}

      End
      ---

      與 Dynamicparam、Begin 和 End 關鍵字一起組成函數主體的一部分。在從管線收
      到所有物件之後,End 陳述式清單會執行一次。

      語法:

          function <名稱> { 
              dynamicparam {<陳述式清單>}
              begin {<陳述式清單>}
              process {<陳述式清單>}
              end {<陳述式清單>}
          }

      Exit
      ----

      讓 Windows PowerShell 結束指令碼或 Windows PowerShell 執行個體。

      語法:

          exit

      Filter 
      ------

      指定函數,其中的陳述式清單會針對每個輸入物件執行一次。這與只包含一個 
      Process 區塊的函數作用相同。

      語法:

          filter <名稱> {<陳述式清單>}

      Finally
      -------

      定義陳述式清單,在與 Try 和 Catch 關聯的陳述式之後執行。即使按下 CTRL+C 
      離開指令碼或在指令碼中使用 Exit 關鍵字,Finally 陳述式清單仍會執行。

      語法:

          try {<陳述式清單>}
          catch [<錯誤類型>] {<陳述式清單>}
          finally {<陳述式清單>}

      For  
      ---

      使用條件來定義迴圈。

      語法:

          for (<初始化>; <條件>; <反覆運算>) {<陳述式清單>}

      Foreach
      -------
      
      使用集合的每個成員來定義迴圈。

      語法:

          foreach (<項目> in <集合>){<陳述式清單>}

      From
      -----

      保留供未來使用。

      Function
      --------

      建立可重複使用之程式碼的具名陳述式清單。您可以命名函數所屬的範圍,也可以
      使用 Param 關鍵字,指定一個或多個具名參數。在函數陳述式清單中,您可以加入 
      Dynamicparam、Begin、Process 和 End 陳述式清單。

      語法:

           function [<scope:>]<name> { 
              param ([type]<$pname1> [, [type]<$pname2>])
              dynamicparam {<statement list>}
              begin {<statement list>}
              process {<statement list>}
              end {<statement list>}
          }

      此外,您也可以在函數名稱後面、陳述式清單外部定義一個或多個參數。

      語法:

          function [<scope:>]<name> [([type]<$pname1>, 
          [[type]<$pname2>])] 
          { 
              dynamicparam {<statement list>}
              begin {<statement list>}
              process {<statement list>}
              end {<statement list>}
          }

      If
      --

      定義條件式。

      語法:

          if (<條件>) {<陳述式清單>}

      In
      --

      用於 Foreach 陳述式中,可建立使用每個集合成員的迴圈。

      語法:

          foreach (<項目> in <集合>){<陳述式清單>}

      Param
      -----

      定義函數的參數。

      語法:

          function [<scope:>]<name> {
              param ([type]<$pname1>[, [[type]<$pname2>]])
              <statement list>
          }

      Process
      -------

      與 Dynamicparam、Begin 和 End 關鍵字一起組成函數主體的一部分。當 Process 
      陳述式清單從管線收到輸入時,Process 陳述式清單會針對來自管線的每個元素各執
      行一次。如果管線未提供物件,Process 陳述式清單就不會執行。如果該命令是管線
      中的第一個命令,則 Process 陳述式清單會執行一次。

      語法:

          function <名稱> { 
              dynamicparam {<陳述式清單>}
              begin {<陳述式清單>}
              process {<陳述式清單>}
              end {<陳述式清單>}
          }


      Return 
      ------

      讓 Windows PowerShell 離開目前範圍,例如指令碼或函數,並將選擇性運算式寫
      入至輸出。

      語法:

          return [<運算式>]

      Switch
      ------

      指定要對管線或檔案中項目執行的各種動作。您可以使用下列其中一種語法模型。

      語法 1:

          switch [-regex|-wildcard|-exact][-casesensitive] ( 管線 ) 
          { 
              <字串>|<數字>|<變數>|{ <運算式> } {<陳述式清單>}
              <字串>|<數字>|<變數>|{ <運算式> } {<陳述式清單>} 
              ...
              default {<陳述式清單>}
          }


      語法 2:

          switch [-regex|-wildcard|-exact][-casesensitive] -file 檔名 
          { 
              <字串>|<數字>|<變數>|{ <運算式> } {<陳述式清單>}
              <字串>|<數字>|<變數>|{ <運算式> } {<陳述式清單>} 
              ...
              default {<陳述式清單>}
          }


      Throw
      -----

      擲回物件做為錯誤。

      語法:

          throw [<物件>]

      Trap 
      ----

      定義若發生錯誤時要執行的陳述式清單。錯誤類型需使用方括號。第二對方括號表
      示錯誤類型為選擇項。

      語法:

          trap [[<錯誤類型>]] {<陳述式清單>}

      Try
      ---

      定義陳述式清單,用來檢查當陳述式執行時是否發生錯誤。如果發生錯誤,
      Windows PowerShell 會繼續執行 Catch 或 Finally 陳述式。錯誤類型需
      使用方括號。第二對方括號表示錯誤類型為選擇項。

      語法:

          try {<陳述式清單>}
          catch [[<錯誤類型>]] {<陳述式清單>}
          finally {<陳述式清單>}

      Until
      -----

      用於 Do 陳述式中做為迴圈建構,其中的陳述式清單至少會執行一次。

      語法:

          do {<陳述式清單>} until (<條件>)

      While
      -----

      用於 Do 陳述式中做為迴圈建構,其中的陳述式清單至少會執行一次。

      語法:

          do {<陳述式清單>} while (<條件>)

請參閱
     about_escape_characters
     about_special_characters
     about_wildcards




目錄