Get-FormatData
获取当前会话中的格式设置数据。
语法
Get-FormatData
[[-TypeName] <String[]>]
[<CommonParameters>]
说明
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,后者将该对象转换回 XML 并将其保存在指定的 format.ps1xml 文件中。
最后一个命令显示 format.ps1xml 文件内容的摘录。
参数
-TypeName
指定此 cmdlet 为格式设置数据获取的类型名称。 输入类型名称。 允许使用通配符。
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
输入
None
不能通过管道将输入传递给此 cmdlet。