Show-Command

リファレンス

モジュール:: Microsoft.PowerShell.Utility

PowerShell コマンド情報をグラフィカルウィンドウに表示します。

構文

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

説明

このコマンドレットは、Windows プラットフォームでのみ使用できます。

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

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

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

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

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

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

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

このコマンドレットにはユーザーインターフェイスが必要であるため、Windows Server Core または Windows Nano Server では機能しません。このコマンドレットは、Windows デスクトップをサポートする Windows システムでのみ使用できます。

例

例 1: コマンドウィンドウを開く

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

Show-Command

例 2: コマンドウィンドウでコマンドレットを開く

次の使用例は、Invoke-Commandコマンド ウィンドウにコマンドレットを表示します。この表示を使用して、コマンドを実行 Invoke-Command できます。

Show-Command -Name "Invoke-Command"

例 3: 指定されたパラメーターを使用してコマンドレットを開く

このコマンドを実行すると、コマンドレットの Show-Command ウィンドウがConnect-PSSession開きます。

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

Height パラメーターと Width パラメーターは、コマンドウィンドウの寸法を指定します。 ErrorPopup パラメーターには、エラーコマンドウィンドウが表示されます。

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

例 4: コマンドレットの新しい既定のパラメーター値を指定する

この例では、自動変数を $PSDefaultParameterValues 使用して、コマンドレットの 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 コマンドレットを一緒にShow-Command使用する方法を示しています。

Show-Command Get-ChildItem | Out-GridView

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

例 6: 作成したコマンドを [コマンド] ウィンドウに表示する

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

Show-Command -PassThru

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

たとえば、ウィンドウをShow-Command使用して、Windows PowerShell イベントログに 5 つの最新のイベントを取得するコマンドを作成Get-EventLogし、[OK] をクリックすると、上記の出力が返されます。コマンド文字列を表示すると、PowerShell の学習に役立ちます。

例 7: コマンドを変数に保存する

この例では、コマンドレットの 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. ...

最初のコマンドでは、コマンドレットの PassThru パラメーターを Show-Command 使用し、コマンドの結果を変数に $C 保存します。この場合、ウィンドウをShow-Command使用して、Windows PowerShell イベントログ内の 5 つの最新のイベントを取得するコマンドを作成Get-EventLogします。 [OK] をクリックすると、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

コマンドラインにエラーが表示されるだけでなく、ポップアップウィンドウにエラーが表示されることを示します。既定では、ウィンドウで実行されるコマンドで Show-Command エラーが生成されると、エラーはコマンドラインにのみ表示されます。

また、(ウィンドウの Show-Command [実行] ボタンを使用して) コマンドを実行すると、ErrorPopup パラメーターは、コマンドを実行して新しいコマンドに出力を返す代わりに、コマンドの結果を現在のコマンドに返します。この機能を使用すると、コマンドの結果を変数に保存できます。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Height

ウィンドウの高さを Show-Command ピクセル単位で指定します。 300 以上で画面の解像度以下の値を入力します (ピクセル単位)。値が大きすぎてコマンドウィンドウを画面に表示しないと、 Show-Command エラーが発生します。既定の高さは 600 ピクセルです。 Name パラメーターをShow-Command含むコマンドの場合、既定の高さは 300 ピクセルです。

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

指定されたコマンドについて、コマンドウィンドウが表示されます。コマンドレット、関数、CIM コマンドの名前など、1 つのコマンドの名前を入力します。このパラメーターを省略すると、 Show-Command コンピューターにインストールされているすべてのモジュールのすべての PowerShell コマンドを一覧表示するコマンドウィンドウが表示されます。

Type:	String
Aliases:	CommandName
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoCommonParameter

このコマンドレットがコマンド表示の [共通パラメーター] セクションを省略することを示します。既定では、共通パラメーターはコマンドウィンドウの下部の展開可能なセクションに表示されます。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

作業中の項目を表すオブジェクトを返します。既定では、このコマンドレットによる出力はありません。コマンド文字列を実行するには、コマンドプロンプトでコピーして貼り付けるか、変数に保存し、コマンドレットを Invoke-Expression 使用して変数で文字列を実行します。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Width

ウィンドウの幅を Show-Command ピクセル単位で指定します。 300 以上で画面の解像度以下の値を入力します (ピクセル単位)。値が大きすぎてコマンドウィンドウを画面に表示しないと、 Show-Command エラーが発生します。既定の幅は 300 ピクセルです。

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

None

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

出力

None, System.String, System.Object

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

メモ

このコマンドレットは、Windows プラットフォームでのみ使用できます。

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

次の方法で共有

Show-Command

構文

説明

例

例 1: コマンドウィンドウを開く

例 2: コマンドウィンドウでコマンドレットを開く

例 3: 指定されたパラメーターを使用してコマンドレットを開く

例 4: コマンドレットの新しい既定のパラメーター値を指定する

例 5: グリッドビューに出力を送信する

例 6: 作成したコマンドを [コマンド] ウィンドウに表示する

例 7: コマンドを変数に保存する

例 8: コマンドの出力を変数に保存する

パラメーター

-ErrorPopup

-Height

-Name

-NoCommonParameter

-PassThru

-Width

入力

出力

メモ

その他のリソース

次の方法で共有

Show-Command

構文

説明

例

例 1: コマンド ウィンドウを開く

例 2: コマンド ウィンドウでコマンドレットを開く

例 3: 指定されたパラメーターを使用してコマンドレットを開く

例 4: コマンドレットの新しい既定のパラメーター値を指定する

例 5: グリッド ビューに出力を送信する

例 6: 作成したコマンドを [コマンド] ウィンドウに表示する

例 7: コマンドを変数に保存する

例 8: コマンドの出力を変数に保存する

パラメーター

-ErrorPopup

-Height

-Name

-NoCommonParameter

-PassThru

-Width

入力

出力

メモ

その他のリソース

例 1: コマンドウィンドウを開く

例 2: コマンドウィンドウでコマンドレットを開く

例 5: グリッドビューに出力を送信する