Show-Command

參考

模組:: Microsoft.PowerShell.Utility

在圖形視窗中顯示PowerShell命令資訊。

語法

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

Description

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

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

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

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

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

在 PowerShell 整合式腳本環境（ISE）中，預設會顯示視窗的變化 Show-Command 。如需使用此命令視窗的詳細資訊，請參閱 PowerShell ISE 說明主題。

此 Cmdlet 已在 PowerShell 3.0 中引進。

由於此 Cmdlet 需要使用者介面，所以無法在 Windows Server Core 或 Windows Nano Server 上運作。此 Cmdlet 僅適用於支援 Windows 桌面的 Windows 系統上。

範例

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

本範例會顯示視窗的預設檢視 Show-Command 。 [ 命令] 視窗會顯示電腦上所有模組中所有命令的清單。

Show-Command

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

本範例會在 Invoke-Command [命令] 視窗中顯示 Cmdlet。您可以使用此顯示來執行 Invoke-Command 命令。

Show-Command -Name "Invoke-Command"

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

此命令會開啟 Show-Command Cmdlet 的Connect-PSSession視窗。

Show-Command -Name "Connect-PSSession" -Height 700 -Width 1000 -ErrorPopup

Height 和 Width 參數會指定命令視窗的維度。 ErrorPopup 參數會顯示錯誤命令視窗。

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

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

這個範例會$PSDefaultParameterValues使用自動變數來設定 Cmdlet 之 Height、Width 和 ErrorPopup 參數Show-Command的新預設值。

$PSDefaultParameterValues = @{
    "Show-Command:Height" = 700
    "Show-Command:Width" = 1000
    "Show-Command:ErrorPopup" = $True
}

現在當您執行 Show-Command 命令時，會自動套用新的預設值。若要在每個 PowerShell 工作階段中使用這些預設值，請將變數新增 $PSDefaultParameterValues 至 PowerShell 配置檔。如需詳細資訊，請參閱 about_Profiles 和 about_Parameters_Default_Values。

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

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

Show-Command Get-ChildItem | Out-GridView

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

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

這個範例顯示您在視窗中建立的 Show-Command 命令。此命令會 使用PassThru 參數，以傳回 Show-Command 字串中的結果。

Show-Command -PassThru

Get-EventLog -LogName "Windows PowerShell" -Newest 5

例如，如果您使用 Show-Command 視窗來建立 Get-EventLog 命令，以取得 Windows PowerShell 事件記錄檔中的五個最新事件，然後按兩下 [ 確定]，命令會傳回上面顯示的輸出。檢視命令字串可協助您瞭解PowerShell。

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

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

$C = Show-Command -PassThru
$C
Invoke-Expression $C

Get-EventLog -LogName "PowerShell" -Newest 5

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

第一個命令會使用 Cmdlet 的 Show-Command PassThru 參數，並將命令的結果儲存在變數中$C。在此情況下，我們會使用 Show-Command 視窗來建立 Get-EventLog 命令，以取得 Windows PowerShell 事件記錄檔中的五個最新事件。當您按兩下 [ 確定] 時， Show-Command 會傳回儲存在變數中的 $C 命令字串。

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

這個範例會使用 ErrorPopup 參數，將命令的輸出儲存在變數中。

$P = Show-Command Get-Process -ErrorPopup
$P

Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id ProcessName
-------  ------    -----      ----- -----   ------     -- -----------
    473      33    94096     112532   709     2.06   4492 powershell

除了在視窗中顯示錯誤之外， ErrorPopup 也會將命令輸出傳回至目前的命令，而不是建立新的命令。當您執行此命令時，視窗隨即 Show-Command 開啟。您可以使用視窗功能來設定參數值。若要執行命令，請按兩下視窗中的 Show-Command [執行] 按鈕。

參數

-ErrorPopup

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

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

類型:	SwitchParameter
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Height

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

類型:	Double
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Name

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

類型:	String
別名:	CommandName
Position:	0
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-NoCommonParameter

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

類型:	SwitchParameter
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PassThru

會傳回物件，代表您正在使用的專案。根據預設，此 Cmdlet 不會產生任何輸出。若要執行命令字串，請在命令提示字元複製並貼上它，或將它儲存在變數中，並使用 Invoke-Expression Cmdlet 在變數中執行字串。

類型:	SwitchParameter
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Width

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

類型:	Double
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

None

您無法使用管線將物件傳送至此 Cmdlet。

輸出

None

根據預設，此 Cmdlet 不會傳回任何輸出。

String

當您使用 PassThru 參數時，這個 Cmdlet 會傳回命令字串。

Object

當您使用 ErrorPopup 參數時，這個 Cmdlet 會傳回命令輸出（任何物件）。

備註

Windows PowerShell 包含下列的 Show-Command別名：

shcm

Show-Command 無法在遠端會話中使用。

共用方式為