Update-FormatData
現在のセッションの書式設定データを更新します。
構文
Default (既定)
Update-FormatData
[[-AppendPath] <String[]>]
[-PrependPath <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Update-FormatData コマンドレットは、書式設定ファイルから現在のセッションに書式設定データを再読み込みします。 このコマンドレットを使用すると、PowerShell を再起動せずに書式設定データを更新できます。
パラメーターがない場合、Update-FormatData は以前に読み込んだ書式設定ファイルを再読み込みします。
Update-FormatData のパラメーターを使用して、新しい書式設定ファイルをセッションに追加できます。
フォーマット ファイルは、format.ps1xml ファイル名拡張子を持つ XML 形式のテキスト ファイルです。 ファイル内の書式設定データは、セッション内の Microsoft .NET Framework オブジェクトの表示を定義します。
PowerShell が起動すると、PowerShell ソース コードからフォーマット データが読み込まれます。 ただし、カスタム format.ps1xml ファイルを作成して、現在のセッションの書式設定を更新することはできます。
Update-FormatData を使用すると、PowerShell を再起動せずに書式設定データを現在のセッションに再読み込みできます。 これは、書式設定ファイルを追加または変更したが、セッションを中断したくない場合に便利です。
PowerShell でのファイルの書式設定の詳細については、「about_Format.ps1xml」を参照してください。
例
例 1: 以前に読み込まれた書式設定ファイルを再読み込みする
Update-FormatData
このコマンドは、以前に読み込んだ書式設定ファイルを再読み込みします。
例 2: フォーマット ファイルとトレースおよびログの書式設定ファイルを再読み込みする
Update-FormatData -AppendPath Trace.format.ps1xml, Log.format.ps1xml
このコマンドは、Trace.format.ps1xml と Log.format.ps1xmlの 2 つの新しいファイルを含む、書式設定ファイルをセッションに再読み込みします。
コマンドは AppendPath パラメーターを使用するため、新しいファイル内の書式設定データは、組み込みファイルの書式設定データの後に読み込まれます。
AppendPath パラメーターは、新しいファイルに組み込みファイルで参照されていないオブジェクトの書式設定データが含まれているために使用されます。
例 3: 書式設定ファイルを編集して再読み込みする
Update-FormatData -PrependPath "C:\test\NewFiles.format.ps1xml"
# Edit the NewFiles.format.ps1 file.
Update-FormatData
この例では、編集後に書式設定ファイルを再読み込みする方法を示します。
最初のコマンドは、NewFiles.format.ps1xml ファイルをセッションに追加します。
PrependPath パラメーターを使用します。ファイルには、組み込みファイルで参照されるオブジェクトの書式設定データが含まれているためです。
NewFiles.format.ps1xml ファイルを追加し、これらのセッションでテストした後、作成者はファイルを編集します。
2 番目のコマンドでは、Update-FormatData コマンドレットを使用して書式設定ファイルを再読み込みします。
NewFiles.format.ps1xml ファイルは以前に読み込まれたため、Update-FormatData はパラメーターを使用せずに自動的に再読み込みします。
パラメーター
-AppendPath
このコマンドレットがセッションに追加するフォーマット ファイルを指定します。 ファイルは、PowerShell が組み込みの書式設定ファイルを読み込んだ後に読み込まれます。
.NET オブジェクトを書式設定する場合、PowerShell では、.NET 型ごとに検索される最初の書式設定定義が使用されます。 AppendPath パラメーターを使用すると、追加する書式設定データが検出される前に、PowerShell によって組み込みファイルのデータが検索されます。
このパラメーターを使用して、組み込みの書式設定ファイルで参照されていない .NET オブジェクトを書式設定するファイルを追加します。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | PSPath, 経路 |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PrependPath
このコマンドレットがセッションに追加するフォーマット ファイルを指定します。 PowerShell が組み込みの書式設定ファイルを読み込む前に、ファイルが読み込まれます。
.NET オブジェクトを書式設定する場合、PowerShell では、.NET 型ごとに検索される最初の書式設定定義が使用されます。 PowerShellでPrependPathパラメーターを使用すると、組み込みファイルの書式設定データに到達する前に、追加しているファイルからデータを検索します。
このパラメーターを使用して、組み込みの書式設定ファイルでも参照される .NET オブジェクトを書式設定するファイルを追加します。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
入力
String
このコマンドレットへの追加パスを含む文字列をパイプ処理できます。
出力
None
このコマンドレットは出力を返しません。
メモ
-
Update-FormatDataでは、モジュールからインポートされたセッション内のコマンドの書式設定データも更新されます。 モジュールのフォーマット ファイルが変更された場合は、Update-FormatDataコマンドを実行して、インポートされたコマンドの書式設定データを更新できます。 モジュールをもう一度インポートする必要はありません。
