Show-Command

Show-Command コマンドレットを使用すると、コマンド ウィンドウで Windows PowerShell コマンドを作成できます。 コマンド ウィンドウの機能を使用してコマンドを実行するか、コマンドを返すことができます。

Show-Command は、非常に便利な教育および学習ツールです。 Show-Command は、コマンドレット、関数、ワークフロー、CIM コマンドなど、すべてのコマンドの種類で動作します。

パラメーターを指定しない場合、 Show-Command は、インストールされているすべてのモジュールで使用可能なすべてのコマンドを一覧表示するコマンド ウィンドウを表示します。 モジュール内のコマンドを見つけるには、[モジュール] ドロップダウン リストからモジュールを選択します。 コマンドを選択するには、コマンド名をクリックします。

コマンド ウィンドウを使用するには、[名前] を使用するか、[コマンド] 一覧でコマンド名をクリックして、コマンドを選択します。 各パラメーター セットは、個別のタブに表示されます。アスタリスクは必須パラメーターを示します。 パラメーターの値を入力するには、テキスト ボックスに値を入力するか、ドロップダウン ボックスから値を選択します。 スイッチ パラメーターを追加するには、クリックしてパラメーター のチェック ボックスをオンにします。

準備ができたら、[コピー] をクリックして、作成したコマンドをクリップボードにコピーするか、[ 実行] をクリックしてコマンドを実行できます。 PassThru パラメーターを使用して、Windows PowerShell コンソールなどのホスト プログラムにコマンドを返すこともできます。 コマンドの選択を取り消し、すべてのコマンドを表示するビューに戻すには、Ctrl キーを押して選択したコマンドをクリックします。

Windows PowerShell Integrated Scripting Environment (ISE) では、 Show-Command ウィンドウのバリエーションが既定で表示されます。 このコマンド ウィンドウの使用方法については、Windows PowerShell ISE のヘルプ トピックを参照してください。

このコマンドレットは、Windows PowerShell 3.0 で導入されました。

PS C:\> Show-Command

このコマンドは、 Show-Command ウィンドウの既定のビューを表示します。 [コマンド] ウィンドウには、コンピューターにインストールされているすべてのモジュールのすべてのコマンドの一覧が表示されます。

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

このコマンドは、Invoke-Command コマンドレットの表示を Show-Command ウィンドウで開きます。 「Invoke-Command」画面を使用して、Invoke-Commandコマンドを実行できます。

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

このコマンドは、Connect-PSSession コマンドレットの Show-Command ウィンドウを開きます。 Height パラメーターと Width パラメーターを使用してコマンド ウィンドウの寸法を指定し、ErrorPopup パラメーターを使用してエラー コマンド ウィンドウを表示します。

[実行] をクリックすると、コマンド ラインで Connect-PSSession コマンドを入力した場合と同様に、Connect-PSSession コマンドが実行されます。

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

このコマンドでは、$PSDefaultParameterValues 自動変数を使用して、Show-Command コマンドレットの Height、Width、ErrorPopup パラメーターに新しい既定値を設定します。 これで、 Show-Command コマンドを実行すると、新しい既定値が自動的に適用されます。

すべての Windows PowerShell セッションでこれらの既定値を使用するには、$PSDefaultParameterValues 変数を Windows PowerShell プロファイルに追加します。 詳細については、「about_Profiles」および 「about_Parameters_Default_Values」を参照してください。

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

このコマンドは、 Show-Command コマンドレットと Out-GridView コマンドレットを一緒に使用する方法を示しています。

このコマンドでは、 Show-Command コマンドレットを使用して、Get-ChildItem コマンドレットのコマンド ウィンドウを開きます。 [実行] ボタンをクリックすると、Get-ChildItem コマンドが実行され、出力が生成されます。 パイプライン演算子 ( | ) は 、Get-ChildItem コマンドの出力を Out-GridView コマンドレットに送信し、 Get-ChildItem 出力が対話型ウィンドウに表示されます。

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

このコマンドは、作成したコマンドを Show-Command ウィンドウに表示します。 このコマンドは PassThru パラメーターを使用し、 Show-Command の結果を文字列で返します。

たとえば、[ Show-Command ] ウィンドウを使用して、Windows PowerShell イベント ログ内の最新の 5 つのイベントを取得する Get-EventLog コマンドを作成し、[ OK] をクリックすると、コマンドは次の出力を返します。

コマンド文字列を表示すると、Windows PowerShell の学習に役立ちます。

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 コマンドレットの PassThru パラメーターを使用するときに取得するコマンド文字列を実行する方法を示しています。 この方法では、コマンドを表示して使用できます。

最初のコマンドでは、Show-Command コマンドレットの PassThru パラメーターを使用します。 コマンドの結果を $C 変数に保存します。

このコマンドは 、Show-Command ウィンドウを開きます。 この場合は、[ Show-Command ] ウィンドウを使用して、Windows PowerShell イベント ログの最新の 5 つのイベントを取得する Get-EventLog コマンドを作成します。 [OK] をクリックすると、Show-Command は $C 変数に保存されているコマンド文字列を返します。

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 コマンドレットの ErrorPopup パラメーターを使用して、コマンドの出力を変数に保存します。

最初のコマンドは、ErrorPopup パラメーターを使用して Show-Command コマンドレットを実行します。 エラーをウィンドウに表示するだけでなく、ErrorPopup は、新しいコマンドを作成するのではなく、現在のコマンドにコマンド出力を返します。

このコマンドを実行すると、[ Show-Command ] ウィンドウが開きます。 ウィンドウ機能を使用して、パラメーター値を設定できます。 コマンドを実行するには、[Show-Command] ウィンドウの [Run] ボタンをクリックします。

None

入力を Show-Command にパイプすることはできません。

System.String, System.Object

PassThru パラメーターを使用すると、Show-Command はコマンド文字列を返します。 ErrorPopup パラメーターを使用すると、Show-Command はコマンド出力 (任意のオブジェクト) を返します。それ以外の場合、show-Command は出力を生成しません。

• show-Command はリモートセッションでは機能しません。