次の方法で共有

Format-Wide

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

オブジェクトを、各オブジェクトの 1 つのプロパティのみを表示するワイド テーブルとして書式設定します。

構文

Default (既定) 

Format-Wide
    [[-Property] <Object>]
    [-AutoSize]
    [-Column <int>]
    [-GroupBy <Object>]
    [-View <string>]
    [-ShowError]
    [-DisplayError]
    [-Force]
    [-Expand <string>]
    [-InputObject <psobject>]
    [<CommonParameters>]

説明

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

例

例 1: 現在のディレクトリ内のファイルの名前を書式設定する

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

Get-ChildItem | Format-Wide -Column 3

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

例 2: レジストリ キーの形式名

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

Get-ChildItem HKCU:\software\Microsoft | Format-Wide -Property PSChildName -AutoSize

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

例 3: 形式エラーのトラブルシューティング

次の例は、式を使用して 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

パラメーター

-AutoSize

データの幅に基づいて列のサイズと列数を調整します。 既定では、列のサイズと数はビューによって決まります。 同じコマンドでは、AutoSize パラメーターと Column パラメーターを使用することはできません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Column

ディスプレイ内の列の数を指定します。 同じコマンドでは、AutoSize パラメーターと Column パラメーターを使用することはできません。

パラメーターのプロパティ

型:Int32
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DisplayError

コマンド ラインにエラーを表示します。 このパラメーターはほとんど使用されませんが、Format-Wide コマンドで式を書式設定していて、式が機能していないように見える場合は、デバッグ支援として使用できます。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Expand

コレクション オブジェクトとコレクション内のオブジェクトの書式を設定します。 このパラメーターは、System.Collections.ICollection インターフェイスをサポートするオブジェクトを書式設定するように設計されています。 既定値は EnumOnly です。

有効な値は次のとおりです。

  • EnumOnly: コレクション内のオブジェクトのプロパティを表示します。
  • CoreOnly: コレクション オブジェクトのプロパティを表示します。
  • Both: コレクション オブジェクトのプロパティとコレクション内のオブジェクトのプロパティを表示します。

パラメーターのプロパティ

型:String
規定値:EnumOnly
指定可能な値:CoreOnly, EnumOnly, Both
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Force

変更によってセキュリティが損なわれるのを防ぐために、このコマンドレットがコマンドの成功を妨げる制限をオーバーライドすることを示します。 たとえば、Force は、読み取り専用属性をオーバーライドしたり、ディレクトリを作成してファイル パスを完了したりしますが、ファイルのアクセス許可の変更は試みません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-GroupBy

共有プロパティまたは値に基づいて出力をグループで書式設定します。 出力の式またはプロパティを入力します。 GroupBy パラメーターは、オブジェクトが並べ替えられていることを想定しています。 Sort-Object を使用してオブジェクトをグループ化する前に、Format-Wide コマンドレットを使用します。

GroupBy パラメーターの値には、新しい計算プロパティを指定できます。 計算プロパティには、スクリプト ブロックまたはハッシュ テーブルを指定できます。 有効なキーと値のペアは次のとおりです。

  • Name (または Label) - <string>
  • Expression - <string> または <script block>
  • FormatString - <string>

詳細については、「about_Calculated_Properties」を参照してください。

パラメーターのプロパティ

型:Object
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-InputObject

書式設定するオブジェクトを指定します。 オブジェクトを含む変数を入力するか、オブジェクトを取得するコマンドまたは式を入力します。

パラメーターのプロパティ

型:PSObject
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Property

ディスプレイに表示されるオブジェクト プロパティを指定します。 ワイルドカードを使用できます。

このパラメーターを省略した場合、表示に表示されるプロパティは、表示されるオブジェクトによって異なります。 パラメーター名 プロパティ は任意です。 同じコマンドでは、プロパティ パラメーターと View パラメーターを使用することはできません。

Property パラメーターの値には、新しい計算プロパティを指定できます。 計算プロパティには、スクリプト ブロックまたはハッシュ テーブルを指定できます。 有効なキーと値のペアは次のとおりです。

  • Expression - <string> または <script block>
  • FormatString - <string>

詳細については、「about_Calculated_Properties」を参照してください。

パラメーターのプロパティ

型:Object
規定値:None
ワイルドカードのサポート:True
DontShow:False

パラメーター セット

(All)
配置:0
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ShowError

パイプラインを介してエラーを送信します。 このパラメーターはほとんど使用されませんが、Format-Wide コマンドで式を書式設定していて、式が機能していないように見える場合は、デバッグ支援として使用できます。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-View

代替テーブル形式またはビューの名前を指定します。 同じコマンドでは、プロパティ パラメーターと View パラメーターを使用することはできません。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

PSObject

任意のオブジェクトをこのコマンドレットにパイプできます。

出力

Microsoft.PowerShell.Commands.Internal.Format

このコマンドレットは、テーブルを表す書式オブジェクトを返します。

メモ

PowerShell には、Format-Wideの次のエイリアスが含まれています。

  • すべてのプラットフォーム:
    • fw

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

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