Share via

ConvertTo-Xml

  • 参考
模块:
Microsoft.PowerShell.Utility

创建对象的基于 XML 的表示形式。

语法

ConvertTo-Xml
              [-Depth <Int32>]
              [-InputObject] <PSObject>
              [-NoTypeInformation]
              [-As <String>]
              [<CommonParameters>]

说明

cmdlet ConvertTo-Xml 创建一个或多个 .NET 对象的 基于 XML 的表示形式。 若要使用此 cmdlet，请通过管道将一个或多个对象传递给 cmdlet，或使用 InputObject 参数指定对象。

通过管道将多个对象传递给 ConvertTo-Xml 或使用 InputObject 参数提交多个对象时， ConvertTo-Xml 将返回一个内存中 XML 文档，其中包含所有对象的表示形式。

此 cmdlet 类似于 Export-Clixml ， Export-Clixml 只是将生成的 XML 存储在 公共语言基础结构 (CLI) XML 文件中，该文件可通过 Import-Clixml 重新导入为对象。 ConvertTo-Xml 返回 XML 文档的内存中表示形式，因此你可以继续在 PowerShell 中处理它。 ConvertTo-Xml 没有将对象转换为 CLI XML 的选项。

示例

示例 1：将日期转换为 XML

Get-Date | ConvertTo-Xml

此命令将当前日期 (dateTime 对象) 转换为 XML。

示例 2：将进程转换为 XML

ConvertTo-Xml -As "Document" -InputObject (Get-Process) -Depth 3

此命令可将表示计算机上所有进程的进程对象转换为一个 XML 文档。 这些对象的级别深度将扩展至三。

参数

-As

确定输出格式。 此参数的可接受值为：

  • String 返回单个字符串。
  • Stream 返回字符串数组。
  • Document 返回 XmlDocument 对象。

默认值为 Document。

Type:String
Accepted values:Stream, String, Document
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Depth

指定 XML 表示形式中所包含的包含对象的级别数。 默认值为 1。

例如，如果对象的属性还包含对象，若要保存所包含对象的属性的 XML 表示形式，则必须将深度指定为 2。

可以覆盖 Types.ps1xml 文件中对象类型的默认值。 有关详细信息，请参阅 about_Types.ps1xml。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

指定要转换的对象。 输入一个包含对象的变量，或键入可获取对象的命令或表达式。 还可以通过管道将 对象传递给 ConvertTo-XML。

Type:PSObject
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoTypeInformation

省略对象节点中的 Type 属性。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

PSObject

可以通过管道将任何对象传递给 ConvertTo-XML。

输出

System.String or System.Xml.XmlDocument

As 参数的值确定返回的对象ConvertTo-XML类型。