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

语法

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 文件内容的摘要。






另请参阅




目录