Format-Wide

Format-Wide コマンドレットは、オブジェクトを、各オブジェクトの 1 つのプロパティのみを表示するワイド テーブルとして書式設定します。 Property パラメーターを使用して、表示されるプロパティを決定できます。

このコマンドは、現在のディレクトリ内のファイルの名前を画面の 3 つの列に表示します。

Get-ChildItem | Format-Wide -Column 3

Get-ChildItem コマンドレットは、ディレクトリ内の各ファイルを表すオブジェクトを取得します。 パイプライン演算子 (|) は、パイプラインを介してファイル オブジェクトを Format-Wide に渡し、出力用に書式設定します。 Column パラメーターは、列の数を指定します。

このコマンドは、HKEY_CURRENT_USER\Software\Microsoft キーのレジストリ キーの名前を表示します。

Get-ChildItem HKCU:\software\microsoft | Format-Wide -Property pschildname -AutoSize

Get-ChildItem コマンドレットは、キーを表すオブジェクトを取得します。 パスは、PowerShell レジストリ プロバイダーによって公開されるドライブの 1 つである HKCU: として指定され、その後にキー パスが続きます。 パイプライン演算子 (|) は、レジストリ キー オブジェクトをパイプライン経由で Format-Wide に渡し、出力用に書式設定します。 Property パラメーターはプロパティの名前を指定し、AutoSize パラメーターは読みやすくするために列を調整します。

次の例は、式を使用して DisplayError または ShowError パラメーターを追加した結果を示しています。

PS /> Get-Date | Format-Wide { $_ / $null } -DisplayError


#ERR

PS /> Get-Date | Format-Wide { $_ / $null } -ShowError


Failed to evaluate expression " $_ / $null ".
+ CategoryInfo          : InvalidArgument: (12/21/2018 8:18:01 AM:PSObject) [], RuntimeException
+ FullyQualifiedErrorId : PSPropertyExpressionError

PSObject

任意のオブジェクトをパイプ処理して Format-Wideできます。

Microsoft.PowerShell.Commands.Internal.Format

Format-Wide テーブルを表す format オブジェクトを返します。

また、組み込みのエイリアス、Format-Wideで fw を参照することもできます。 詳細については、about_Aliasesを参照してください。

GroupBy パラメーターは、オブジェクトが並べ替えられていることを前提としています。 Format-Custom を使用してオブジェクトをグループ化する前に、Sort-Object を使用してください。

View パラメーターを使用すると、テーブルの代替形式を指定できます。 PowerShell ディレクトリの *.format.PS1XML ファイルで定義されているビューを使用することも、新しい PS1XML ファイルに独自のビューを作成し、Update-FormatData コマンドレットを使用して PowerShell に含めることもできます。

View パラメーターの代替ビューでは、テーブル形式を使用する必要があります。そうでない場合、コマンドは失敗します。 代替ビューがリストの場合は、Format-Listを使用します。 代替ビューがリストでもテーブルでもない場合は、Format-Custom を使用します。