編輯附註
重要
Windows PowerShell 語言規格 3.0 於 2012 年 12 月發行,並以 Windows PowerShell 3.0 為基礎。 此規格不會反映 PowerShell 的目前狀態。 沒有計劃更新此檔以反映目前的狀態。 這份文件在此呈現作為歷史參考。
規格文件可以從 Microsoft 下載中心取得,格式為 Microsoft Word 文件:https://www.microsoft.com/download/details.aspx?id=36389。該 Word 文件已在 Microsoft Learn 上轉換後呈現。 在轉換期間,已進行一些編輯變更,以配合 Docs 平臺的格式設定。 已修正某些錯字和次要錯誤。
Cmdlet 是單一功能命令,可操作 PowerShell 中的物件。 Cmdlets 可以透過其名稱格式來辨識,即由動詞和名詞組成,並以破折號(-
)分隔,例如 Get-Help
、Get-Process
和 Start-Service
。
動詞模式 是使用通配符表示的動詞,如 W*
所示。
名詞模式 是使用通配符表示的名詞,如 事件所示。
Cmdlet 應該簡單,並設計為可以與其他 Cmdlet 組合使用。 例如,Get Cmdlet 應該只擷取數據,Set Cmdlet 應該只建立或變更數據,Format Cmdlet 應該只格式化數據,Out Cmdlet 應該只將輸出導向至指定的目的地。
針對每個 Cmdlet,提供可透過輸入以下命令來存取的說明檔案:
Get-Help *cmdlet-name* -Detailed
Cmdlet 說明檔的詳細檢視應該包含 Cmdlet 的描述、命令語法、參數的描述,以及示範使用該 Cmdlet 的範例。
Cmdlet 的使用方式類似於作業系統命令和公用程式的使用方式。 PowerShell 命令不區分大小寫。
注意
編輯器的附註:源檔包含一份 Cmdlet 清單,其中包含描述、語法圖表、參數定義和範例。 此資訊不完整且已過期。 如需目前有關 Cmdlet 的資訊,請參閱 PowerShell 文件的 參考 部分。
13.1 一般參數
一般參數 是一組 Cmdlet 參數,可與任何 Cmdlet 搭配使用。 它們是由 PowerShell 執行時間環境本身實作,而不是由 Cmdlet 開發人員實作,且它們會自動提供給任何使用 Parameter 屬性的 Cmdlet 或函式,使用(§12.3.7)或 CmdletBinding 屬性(§12.3.5)。
雖然任何 Cmdlet 都接受一般參數,但它們可能沒有任何該 Cmdlet 的語意。 例如,如果 Cmdlet 並未產生任何詳細資訊輸出,那麼使用 Verbose 一般參數也不會有任何效果。
數個常見的參數會覆寫系統預設值或透過喜好設定變數設定的偏好設定(§2.3.2.3)。 不同於喜好設定變數,一般參數只會影響所使用的命令。
注意
編輯器的附註:源檔包含一般參數的清單。 此資訊不完整且已過期。 如需最新資訊,請參閱 about_CommonParameters。