Get-FormatData
現在のセッションの書式設定データを取得します。
構文
Get-FormatData
[[-TypeName] <String[]>]
[-PowerShellVersion <Version>]
[<CommonParameters>]
説明
コマンドレットは Get-FormatData
、現在のセッションの書式設定データを取得します。
セッションの書式設定データには、ディレクトリ内の書式設定ファイルからの Format.ps1xml
書式設定データ、セッションに $PSHOME
インポートするモジュールのデータの書式設定、コマンドレットを使用して Import-PSSession
セッションにインポートするコマンドのデータの書式設定が含まれます。
このコマンドレットを使用すると、書式設定データを確認できます。 その後、コマンドレットを Export-FormatData
使用してオブジェクトをシリアル化し、それらを XML に変換し、ファイルに Format.ps1xml
保存できます。
PowerShell でのファイルの書式設定の詳細については、「about_Format.ps1xml」を参照してください。
例
例 1: すべての書式設定データを取得する
この例では、セッション内のすべての書式設定データを取得します。
Get-FormatData
例 2: 型名で書式設定データを取得する
次の使用例は、名前 System.Management.Automation.Cmd
が .
Get-FormatData -TypeName 'System.Management.Automation.Cmd*'
例 3: 書式設定データ オブジェクトを調べる
この例では、書式設定データ オブジェクトを取得し、そのプロパティを確認する方法を示します。
$F = Get-FormatData -TypeName 'System.Management.Automation.Cmd*'
$F
TypeName FormatViewDefinition
-------- --------------------
HelpInfoShort {help , TableControl}
$F.FormatViewDefinition[0].control
Headers : {System.Management.Automation.TableControlColumnHeader,
System.Management.Automation.TableControlColumnHeader,
System.Management.Automation.TableControlColumnHeader,
System.Management.Automation.TableControlColumnHeader}
Rows : {System.Management.Automation.TableControlRow}
AutoSize : False
HideTableHeaders : False
GroupBy :
OutOfBand : False
$F.FormatViewDefinition[0].control.Headers
Label Alignment Width
----- --------- -----
CommandType Undefined 15
Name Undefined 50
Version Undefined 10
Source Undefined 0
例 4: 書式設定データを取得してエクスポートする
この例では、モジュールによって追加された書式設定データを使用 Get-FormatData
および Export-FormatData
エクスポートする方法を示します。
$A = Get-FormatData
Import-Module bitstransfer
$B = Get-FormatData
Compare-Object $A $B
InputObject SideIndicator
----------- -------------
Microsoft.BackgroundIntelligentTransfer.Management.BitsJob =>
Get-FormatData *bits* | Export-FormatData -FilePath c:\test\bits.format.ps1xml
Get-Content c:\test\bits.format.ps1xml
<?xml version="1.0" encoding="utf-8"?><Configuration><ViewDefinitions>
<View><Name>Microsoft.BackgroundIntelligentTransfer.Management.BitsJob</Name>
...
最初の 4 つのコマンドでは、BitsTransfer モジュールがセッションに追加する形式の種類を識別するために 、Import-Module
、およびCompare-Object
コマンドレットを使用Get-FormatData
します。
5 番目のコマンドでは、コマンドレットをGet-FormatData
使用して BitsTransfer モジュールが追加する形式の種類を取得します。 パイプライン演算子 (|
) を使用して、形式の型オブジェクトをコマンドレットに Export-FormatData
送信し、それを XML に変換し、指定された format.ps1xml
ファイルに保存します。
最後のコマンドは、ファイルの内容の抜粋を format.ps1xml
示しています。
例 5: 指定したバージョンの PowerShell に基づいて書式設定データを取得する
この例では、指定した TypeName および PowerShell バージョンの書式データを取得するために使用Get-FormatData
する方法を示します。
Get-FormatData -TypeName 'Microsoft.Powershell.Utility.FileHash' -PowerShellVersion $PSVersionTable.PSVersion
TypeNames FormatViewDefinition
--------- --------------------
{Microsoft.Powershell.Utility.FileHash} {Microsoft.Powershell.Utility.FileHash}
パラメーター
-PowerShellVersion
このコマンドレットが書式設定データ用に取得する PowerShell のバージョンを指定します。 ピリオドで区切られた 2 桁の数字を入力します。
このパラメーターは、以前のバージョンの PowerShell を実行しているコンピューターをリモート処理するときの互換性を向上させるために、PowerShell 5.1 で追加されました。
Type: | Version |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TypeName
このコマンドレットが書式設定データに対して取得する型名を指定します。 型名を入力します。 ワイルドカードを使用できます。
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
入力
None
このコマンドレットにオブジェクトをパイプすることはできません。
出力
関連リンク
PowerShell
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示