获取当前会话中的格式数据。
语法
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 所返回对象的类型。
输入 |
None 不能通过管道将输入传递给此 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 文件内容的摘要。
另请参阅