取得目前工作階段中的格式化資料。
語法
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 檔案內容的摘要。
請參閱