Format-Table

Format-Table コマンドレットは、コマンドの出力をテーブルとして書式設定し、各列のオブジェクトの選択したプロパティを使用します。 オブジェクトの種類によって、各列に表示される既定のレイアウトとプロパティが決まりますが、 Property パラメーターを使用して、表示するプロパティを選択できます。

また、ハッシュ テーブルを使用して、オブジェクトを表示する前に計算プロパティを追加したり、テーブル内の列見出しを指定したりすることもできます。 計算プロパティを追加するには、Property または GroupBy パラメーター 使用します。

このコマンドは、PowerShell のホスト プログラムに関する情報をテーブルに表示します。 デフォルトでは、リストとして書式設定されます。

Get-Host | Format-Table -AutoSize

Get-Host コマンドレットは、ホストを表すオブジェクトを取得します。 パイプライン演算子 (|) は、オブジェクトを Format-Table コマンドレットに渡します。 Format-Table コマンドレットは、テーブル内のオブジェクトを書式設定します。 AutoSize パラメーターは、切り捨てを最小限に抑えるために列の幅を調整します。

このコマンドは、コンピューター上のプロセスを同じ基本優先度のグループで表示します。

Get-Process | Sort-Object -Property basepriority | Format-Table -GroupBy basepriority -Wrap

Get-Process コマンドレットは、コンピューター上の各プロセスを表すオブジェクトを取得します。 パイプライン演算子 (|) はオブジェクトを Sort-Object コマンドレットに渡し、 コマンドレットはオブジェクトを基本優先度順に並べ替えます。

別のパイプライン演算子が結果を Format-Table コマンドレットに渡します。 GroupBy パラメーターは、BasePriority プロパティの値に基づいて、プロセスに関するデータをグループに配置します。 Wrap パラメーターは、データが切り捨てられないようにします。

Get-Process | Sort-Object starttime | Format-Table -View starttime

このコマンドは、プロセスの開始日に基づいて、グループ内のコンピューター上のプロセスに関する情報を表示します。 Get-Process コマンドレットを使用して、コンピューター上のプロセスを表すオブジェクトを取得します。 パイプライン演算子 (|) は、 Get-Process の出力を Sort-Object コマンドレットに送信し、StartTime プロパティに基づいて並べ替えます。 別のパイプライン オペレーターは、並べ替えられた結果を Format-Table に送信します。

View パラメーターは、Get-Process によって返されるオブジェクトなど、System.Diagnostics.Process オブジェクトの DotNetTypes.format.ps1xml ファイルで定義されている StartTime ビューを選択するために使用されます。 このビューでは、プロセスの StartTime が短い日付に変換され、プロセスが開始日でグループ化されます。

DotNetTypes.format.ps1xmlファイルには、プロセスの優先度ビューも含まれています。 カスタマイズされたビューを使用して、独自の format.ps1xml ファイルを作成できます。

Get-Service | Format-Table -Property Name, DependentServices

このコマンドは、コンピュータ上のすべてのサービスを 、Name と DependentServices の 2 つの列を持つテーブルに表示します。 Get-Service コマンドレットは、コンピューター上のすべてのサービスを取得します。 パイプライン演算子 (|) は結果を Format-Table コマンドレットに送信し、 コマンドレットによって出力がテーブルに書式設定されます。 Property パラメーターは、テーブルに列として表示されるプロパティを指定します。 Property パラメーターの名前は省略可能であるため、Format-Table Name, DependentServices のように省略できます。

Name と DependentServices は、サービス オブジェクトのプロパティの 2 つにすぎません。 すべてのプロパティを表示するには、「 Get-Service | Get-Member -MemberType Properties」と入力します。

このコマンドは、テーブルで計算プロパティを使用する方法を示しています。

Get-Process Notepad | Format-Table ProcessName,
   @{Label="TotalRunningTime"; Expression={(Get-Date) - $_.StartTime}}

このコマンドは、ローカル コンピューター上のすべてのメモ帳プロセスのプロセス名と合計実行時間を含むテーブルを表示します。 合計実行時間は、現在の時刻から各プロセスの開始時刻を減算することによって計算されます。

このコマンドでは、 Get-Process コマンドレットを使用して、ローカル コンピューター上の Notepad という名前のすべてのプロセスを取得します。 パイプライン演算子 (|) は結果を Format-Table に送信し、プロセスの標準プロパティである ProcessName と計算プロパティである TotalRunningTime の 2 つの列を持つテーブルが表示されます。

TotalRunningTime プロパティは、Label と Expression 2 つのキーを持つハッシュ テーブルによって指定されます。 プロパティの名前は Label キーに割り当てられます。 計算は 式 キーに割り当てられます。 式は、各プロセス オブジェクトの StartTime プロパティを取得し、現在の日時を取得する Get-Date コマンドの結果からそれを減算します。

これらのコマンドは、 Get-WmiObject コマンドレットを使用する点を除いて、前のコマンドと似ています。

$Processes = Get-WmiObject -ComputerName "Server01" -Class win32_process -Filter "name='notepad.exe'"
$Processes | Format-Table ProcessName, @{ Label = "Total Running Time"; Expression={(Get-Date) - $_.ConvertToDateTime($_.CreationDate)}}

最初のコマンドでは、Get-WmiObject コマンドレットを使用して、Server01 コンピューター上の Notepad.exe という名前のすべてのプロセスを記述する WMI Win32_Process クラスのインスタンスを取得します。 このコマンドは、プロセス情報を $Processes 変数に格納します。

2 番目のコマンドでは、パイプライン演算子 (|) を使用して、 $Processes 変数のプロセス情報を Format-Table コマンドレットに送信し、 ProcessName と新しい計算プロパティを表示します。

このコマンドは、新しい計算プロパティの名前 "Total Running Time" を Label キーに割り当てます。 Expression キーに割り当てられたスクリプト ブロックは、現在の日付からプロセスの作成日を差し引いて、プロセスの実行時間を計算します。 Get-Date コマンドレットは現在の日付を取得します。 ConvertToDateTime メソッドは、Win32_Process オブジェクトの CreationDate プロパティを WMI CIM_DATETIME オブジェクトから Get-Date の出力と比較できる .NET DateTime オブジェクトに変換します。 次に、変換された作成日が現在の日付から差し引かれます。 結果は、合計実行時間 値です。

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

PC /> Get-Date | Format-Table DayOfWeek,{ $_ / $null } -DisplayError

DayOfWeek  $_ / $null
--------- ------------
Wednesday #ERR

PC /> Get-Date | Format-Table DayOfWeek,{ $_ / $null } -ShowError

DayOfWeek  $_ / $null
--------- ------------
Wednesday

Failed to evaluate expression " $_ / $null ".
    + CategoryInfo          : InvalidArgument: (10/30/2013 2:28:07 PM:PSObject) \[\], RuntimeException
    + FullyQualifiedErrorId : mshExpressionError

PSObject

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

Microsoft.PowerShell.Commands.Internal.Format

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

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

View パラメーターを使用すると、テーブルの代替形式を指定できます。 PowerShell ディレクトリ内の *.format.PS1XML ファイルで定義されているビューを使用するか、新しい PS1XML ファイルに独自のビューを作成し、 Update-FormatData コマンドレットを使用してそれらを PowerShell に含めることができます。 View パラメーターの代替ビューは、テーブル形式を使用する必要があり、そうしないと、コマンドは失敗します。 代替ビューがリストの場合は、Format-List コマンドレットを使用します。 代替ビューがリストでもテーブルでもない場合は、 Format-Custom コマンドレットを使用します。