about_Language_Keywords
主題
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