取得目前工作階段中的格式化資料。

語法

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

描述

Get-FormatData Cmdlet 會取得目前工作階段中的格式化資料。

工作階段中的格式化資料包括 Format.ps1xml 格式化檔案中的格式化資料 (例如 $pshome 目錄中的資料)、您匯入工作階段之模組的格式化資料,以及您使用 Import-PSSession Cmdlet 匯入工作階段之命令的格式化資料。

您可以用這個 Cmdlet 來檢查格式化資料。然後,您可以使用 Export-FormatData Cmdlet 來序列化物件 (將其轉換成 XML),並將其儲存在 Format.ps1xml 檔案中。

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

參數

-TypeName <string[]>

只取得具有指定之型別名稱的格式化資料。請輸入型別名稱。允許使用萬用字元。

必要?

false

位置?

1

預設值

接受管線輸入?

false

接受萬用字元?

true

<CommonParameters>

這個 Cmdlet 支援一般參數:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊,請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入

您無法經由管道將輸入輸出至這個 Cmdlet。

輸出

System.Management.Automation.ExtendedTypeDefinition

範例 1

C:\PS>get-formatdata

描述
-----------
這個命令會取得工作階段中的所有格式化資料。






範例 2

C:\PS>get-formatdata -typename Microsoft.Wsman*

描述
-----------
這個命令會取得名稱開頭為 "Microsoft.Wsman" 的格式化資料項目。






範例 3

C:\PS>$f = get-formatdata -typename helpinfoshort

C:\PS> $f 

TypeName        FormatViewDefinition
--------        --------------------
HelpInfoShort   {help , TableControl}

C:\PS> $f.FormatViewDefinition[0].control

Headers                                                                    Rows
-------                                                                    ----
{System.Management.Automation.TableControlColumnHeader, System.Manageme... {System.Management.Automation.TableControlRow}


C:\PS> $f.FormatViewDefinition[0].control.headers

Label         Alignment      Width
-----         ---------      -----
Name          Left           33
Category      Left           9
              Undefined      0

描述
-----------
這個範例示範如何取得格式化資料物件及檢查物件的屬性。






範例 4

C:\PS>$a = get-formatdata

C:\PS> import-module bitstransfer
C:\PS> $b = get-formatdata
C:\PS> compare-object $a $b

InputObject                                                SideIndicator
-----------                                                -------------
Microsoft.BackgroundIntelligentTransfer.Management.BitsJob =>


C:\PS> get-formatdata *bits* | export-formatdata -filepath c:\test\bits.format.ps1xml

C:\PS> 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 檔案內容的摘要。






請參閱




目錄