Get-FormatData

参考

模块:: Microsoft.PowerShell.Utility

获取当前会话中的格式设置数据。

语法

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。

输出

ExtendedTypeDefinition

通过