Get-FormatData

模組:: Microsoft.PowerShell.Utility Module

取得目前會話中的格式化數據。

語法

Default (預設值)

Get-FormatData
    [[-TypeName] <String[]>]
    [<CommonParameters>]

Description

Get-FormatData Cmdlet 會取得目前會話中的格式化數據。

會話中的格式化數據報含 Format.ps1xml 格式化檔案中的格式數據，例如$pshome目錄中的格式化數據、匯入會話之模組的格式數據，以及使用 Import-PSSession Cmdlet 匯入會話之命令的格式數據。

您可以使用此 Cmdlet 來檢查格式化數據。然後，您可以使用 Export-FormatData Cmdlet 來串行化物件、將它們轉換成 XML，並將其儲存在 Format.ps1xml 檔案中。

如需在PowerShell中格式化檔案的詳細資訊，請參閱 about_Format.ps1xml。

範例

範例 1：取得所有格式化數據

此命令會取得會話中的所有格式化數據。

Get-FormatData

範例 2：依類型名稱取得格式化數據

Get-FormatData -TypeName 'System.Management.Automation.Cmd*'

此命令會取得名稱開頭為 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
-----         ---------      -----
Name          Left           33
Category      Left           9
Undefined      0

此範例示範如何取得格式化數據物件，並檢查其屬性。

範例 4：取得格式化數據並將其匯出

$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>
...

此範例示範如何使用 Get-FormatData 和 Export-FormatData 導出模組新增的格式數據。

前四個命令會使用 Get-FormatData、Import-Module 和 Compare-Object Cmdlet 來識別 BitsTransfer 模組新增至會話的格式類型。

第五個命令會使用 Get-FormatData Cmdlet 來取得 BitsTransfer 模組新增的格式類型。它會使用管線運算符（|）將格式類型對象傳送至 Export-FormatData Cmdlet，此 Cmdlet 會將它轉換成 XML，並以指定的 format.ps1xml 檔案儲存。

最後一個命令會顯示 format.ps1xml 檔案內容的摘錄。

參數

-TypeName

指定此 Cmdlet 取得格式數據的類型名稱。輸入類型名稱。允許使用通配符。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	True
不要顯示:	False

參數集

(All)

Position:	0
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

共用方式為