Show-Command

模組:: Microsoft.PowerShell.Utility Module

在圖形化命令視窗中建立 Windows PowerShell 命令。

語法

Default (預設值)

Show-Command
    [[-Name] <String>]
    [-Height <Double>]
    [-Width <Double>]
    [-NoCommonParameter]
    [-ErrorPopup]
    [-PassThru]
    [<CommonParameters>]

Description

Show-Command Cmdlet 可讓您在命令視窗中建立 Windows PowerShell 命令。您可以使用命令視窗的功能來執行命令，或將命令傳回給您。

Show-Command 是非常有用的教學和學習工具。 Show-Command 適用於所有命令類型，包括 Cmdlet、函式、工作流程和 CIM 命令。

如果沒有參數，Show-Command 會顯示命令視窗，其中會列出所有已安裝模組中的所有可用命令。若要在模組中尋找命令，請從 [模組] 下拉式清單中選取模組。若要選取命令，請按下命令名稱。

若要使用命令視窗，請使用 [名稱] 或按兩下 [命令] 清單中的命令名稱，選取命令。每個參數集都會顯示在個別索引標籤上。星號表示必要參數。若要輸入參數的值，請在文字框中輸入值，或從下拉式方塊中選取值。若要新增參數，請按下以選取參數複選框。

當您準備好時，您可以按下 [複製] ，將您建立的命令複製到剪貼簿，或按兩下 [執行]，以執行命令。您還可以使用 PassThru 參數將命令返回給主機程式，例如 Windows PowerShell 控制台。若要取消命令選取專案，並返回顯示所有命令的檢視，請按 Ctrl 並按下選取的命令。

在 Windows PowerShell 整合式腳本環境中，預設會顯示 Show-Command 窗口的變化。有關使用此命令視窗的資訊，請參閱 Windows PowerShell ISE 幫助主題。

此 Cmdlet 已在 Windows PowerShell 3.0 中引進。

範例

範例 1：開啟 [命令] 視窗

PS C:\> Show-Command

此命令會顯示 Show-Command 視窗的預設檢視。 Commands （命令）視窗顯示電腦上安裝的所有模組中的所有命令的清單。

範例 2：在 [命令] 視窗中開啟 Cmdlet

PS C:\> Show-Command -Name "Invoke-Command"

此命令會在 Show-Command 視窗中開啟 Invoke-Command Cmdlet 顯示。您可以使用 Invoke-Command 顯示來執行 Invoke-Command 命令。

範例 3：使用指定的參數開啟 Cmdlet

PS C:\> Show-Command -Name "Connect-PSSession" -Height 700 -Width 1000 -ErrorPopup

此命令會開啟 Connect-PSSession Cmdlet Show-Command 視窗。它會使用 Height 和 Width 參數來指定命令視窗的維度，以及 ErrorPopup 參數來顯示錯誤命令視窗。

當您按兩下 [執行]時，Connect-PSSession 命令就會執行，就像您在命令行輸入 Connect-PSSession 命令一樣。

範例 4：指定 Cmdlet 的新預設參數值

PS C:\> $PSDefaultParameterValues = @{"Show-Command:Height" = 700; "Show-Command:Width" = 1000; "Show-Command:ErrorPopup" = $True}

此命令會使用 $PSDefaultParameterValues 自動變數，為 Show-Command Cmdlet 的 Height、Width和 ErrorPopup 參數設定新的預設值。現在當您執行 Show-Command 命令時，會自動套用新的預設值。

若要在每個 Windows PowerShell 工作階段中使用這些預設值，請將 $PSDefaultParameterValues 變數添加到 Windows PowerShell 配置檔中。有關更多資訊，請參閱 about_Profiles 和 about_Parameters_Default_Values。

範例 5：將輸出傳送至方格檢視

PS C:\> Show-Command Get-ChildItem | Out-GridView

此命令示範如何使用 Show-Command 和 Out-GridView Cmdlet。

此命令會使用 Show-Command Cmdlet 來開啟 Get-ChildItem Cmdlet 的命令視窗。當您按兩下 [執行] 按鈕時，Get-ChildItem 命令會執行並產生輸出。管線運算符（ | ）會將 get-ChildItem 命令的輸出傳送至 Out-GridView Cmdlet，此 Cmdlet 會在互動式視窗中顯示 Get-ChildItem 輸出。

範例 6：顯示您在 [命令] 視窗中建立的命令

PS C:\> Show-Command -PassThru
Get-EventLog -LogName "Windows PowerShell" -Newest 5

此命令會顯示您在 Show-Command 視窗中建立的命令。該命令使用 PassThru 參數，該參數以字串形式返回 Show-Command 結果。

例如，如果您使用 [Show-Command] 視窗來建立 Get-EventLog 命令，以取得 Windows PowerShell 事件記錄檔中最新的五個事件，然後按兩下 [確定]，命令會傳回下列輸出。

檢視命令字串可協助您瞭解 Windows PowerShell。

範例 7：將命令儲存至變數

PS C:\> $C = Show-Command -PassThru

This command displays the command string in the $C variable.
PS C:\> $C
Get-EventLog -LogName "Windows PowerShell" -Newest 5

These commands use the Invoke-Expression cmdlet to run the string in the $C variable. The first command uses the full cmdlet name. The second command uses the "iex" alias for the **Invoke-Expression** cmdlet. These commands are equivalent and you can use them interchangeably.The output shows the five newest events in the Windows PowerShell event log.
PS C:\> Invoke-Expression $C

PS C:\> iex $C
   Index Time          EntryType   Source                 InstanceID Message
   ----- ----          ---------   ------                 ---------- -------
   11520 Dec 16 16:37  Information PowerShell                    400 Engine state is changed from None to Available....
   11519 Dec 16 16:37  Information PowerShell                    600 Provider "Variable" is Started. ...
   11518 Dec 16 16:37  Information PowerShell                    600 Provider "Registry" is Started. ...
   11517 Dec 16 16:37  Information PowerShell                    600 Provider "Function" is Started. ...
   11516 Dec 16 16:37  Information PowerShell                    600 Provider "FileSystem" is Started. ...

此命令示範如何使用 Show-Command Cmdlet PassThru 參數時，執行您取得的命令字串。此策略可讓您查看命令並使用它。

第一個命令使用 Show-Command cmdlet 的 PassThru 參數。它將命令的結果保存在 $C 變數中。

該命令將打開 Show-Command 視窗。在本例中，我們使用 Show-Command 視窗創建一個 Get-EventLog 命令，用於獲取 Windows PowerShell 事件日誌中的五個最新事件。按兩下 確定時， Show-Command 將返回保存在 $C 變數中的命令字串。

範例 8：將命令的輸出儲存至變數

PS C:\> $P = Show-Command Get-Process -ErrorPopup

The second command displays the value in the $P variable.
PS C:\> $P
Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id ProcessName

-------  ------    -----      ----- -----   ------     -- -----------

    473      33    94096     112532   709     2.06   4492 powershell

這些命令會使用 Show-Command Cmdlet 的 ErrorPopup 參數，將命令的輸出儲存在變數中。

第一個命令運行帶有 ErrorPopup 參數的 Show-Command cmdlet。除了在視窗中顯示錯誤之外，ErrorPopup 會傳回命令輸出至目前的命令，而不是建立新的命令。

運行此命令時，將打開 Show-Command 視窗。您可以使用視窗功能來設定參數值。要運行該命令，請按兩下 Show-Command 視窗中的 Run 按鈕。

參數

-ErrorPopup

指出 Cmdlet 除了在命令行上顯示錯誤之外，也會在彈出視窗中顯示錯誤。根據預設，當 Show-Command 視窗中執行的命令會產生錯誤時，錯誤只會顯示在命令行上。

此外，當您執行命令時（使用 [Show-Command] 視窗中的 [執行] 按鈕時，ErrorPopup 參數會將命令結果傳回至目前的命令，而不是執行命令，並將其輸出傳回至新的命令。您可以使用這項功能將命令結果儲存在變數中。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Height

以像素為單位指定 Show-Command 視窗的高度。輸入介於 300 與螢幕解析度中像素數之間的值。如果值太大而無法在螢幕上顯示命令視窗，Show-Command 會產生錯誤。預設高度為 600 像素。針對包含 Name 參數的 Show-Command 命令，預設高度為 300 像素。

參數屬性

類型:	Double
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Name

顯示指定命令的命令視窗。輸入一個命令的名稱，例如 Cmdlet、函式、工作流程或 CIM 命令的名稱。如果您省略此參數，Show-Command 會顯示命令視窗，其中會列出計算機上安裝之所有模組中的所有 Windows PowerShell 命令。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	CommandName

參數集

(All)

Position:	0
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-NoCommonParameter

指出這個 Cmdlet 會省略命令顯示的 Common Parameters 區段。根據預設，Common Parameters 會出現在命令視窗底部的可展開區段中。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PassThru

返回一個物件，代表您正在處理的項目。根據預設，此 Cmdlet 不會產生任何輸出。

若要執行命令字串，請在命令提示字元複製並貼上它，或將它儲存在變數中，並使用 Invoke-Expression Cmdlet 在變數中執行字串。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Width

以像素為單位指定 Show-Command 視窗的寬度。輸入介於 300 與螢幕解析度中像素數之間的值。如果值太大而無法在螢幕上顯示命令視窗，Show-Command 會產生錯誤。默認寬度為 300 像素。

參數屬性

類型:	Double
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

輸入

None

您無法使用管線將輸入傳送至 Show-Command。

輸出

System.String, System.Object

當您使用 PassThru 參數時，Show-Command 會傳回命令字串。當您使用 ErrorPopup 參數時，Show-Command 會傳回命令輸出（任何物件）。否則，Show-Command 不會產生任何輸出。

備註

Show-Command 無法在遠端會話中運作。

共用方式為

Show-Command

語法

Default (預設值)

Description

範例

範例 1：開啟 [命令] 視窗

範例 2：在 [命令] 視窗中開啟 Cmdlet

範例 3：使用指定的參數開啟 Cmdlet

範例 4：指定 Cmdlet 的新預設參數值

範例 5：將輸出傳送至方格檢視

範例 6：顯示您在 [命令] 視窗中建立的命令

範例 7：將命令儲存至變數

範例 8：將命令的輸出儲存至變數

參數

-ErrorPopup

參數屬性

參數集

-Height

參數屬性

參數集

-Name

參數屬性

參數集

-NoCommonParameter

參數屬性

參數集

-PassThru

參數屬性

參數集

-Width

參數屬性

參數集

CommonParameters

輸入

None

輸出

System.String, System.Object

備註