创建对象的基于 XML 的表示形式并将其存储在文件中。

语法

Export-Clixml [-Path] <string> -InputObject <psobject> [-Depth <int>] [-Encoding <string>] [-Force] [-NoClobber] [-Confirm] [-WhatIf] [<CommonParameters>]

说明

Export-Clixml cmdlet 创建对象的基于 XML 的表示形式并将其存储在文件中。随后，可以使用 Import-CLIXML cmdlet 基于该文件的内容来重新创建保存的对象。

除 Export-Clixml 将所得到的 XML 存储在文件中以外，此 cmdlet 类似于 ConvertTo-XML。ConvertTo-XML 返回 XML，因此您可在 Windows PowerShell 中继续处理它。

参数

-Depth <int>

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

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

是否为必需？

false

位置？

named

默认值

2

是否接受管道输入？

false

是否接受通配符？

false

-Encoding <string>

为目标文件指定编码类型。有效值包括 ASCII、UTF8、UTF7、UTF32、Unicode、BigEndianUnicode、Default 和 OEM。默认值为 UTF8。

是否为必需？

false

位置？

named

默认值

UTF8

是否接受管道输入？

false

是否接受通配符？

false

-Force

可导致 cmdlet 清除输出文件的只读属性（如果需要）。在该命令完成后，cmdlet 将尝试重置只读属性。

是否为必需？

false

位置？

named

默认值

是否接受管道输入？

false

是否接受通配符？

false

-InputObject <psobject>

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

是否为必需？

true

位置？

named

默认值

是否接受管道输入？

true (ByValue)

是否接受通配符？

false

-NoClobber

确保 cmdlet 不会覆盖现有文件的内容。默认情况下，如果指定的路径中存在同名文件，则 Export-Clixml 将覆盖该文件，而不会发出警告。

是否为必需？

false

位置？

named

默认值

是否接受管道输入？

false

是否接受通配符？

false

-Path <string>

指定对象的 XML 表示形式要存储到其中的文件的路径。

是否为必需？

true

位置？

1

默认值

是否接受管道输入？

false

是否接受通配符？

false

-Confirm

在执行命令之前提示您进行确认。

是否为必需？

false

位置？

named

默认值

是否接受管道输入？

false

是否接受通配符？

false

-WhatIf

描述如果执行该命令会发生什么情况（无需实际执行该命令）。

是否为必需？

false

位置？

named

默认值

是否接受管道输入？

false

是否接受通配符？

false

<CommonParameters>

此 cmdlet 支持通用参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息，请参阅 about_Commonparameters.

输入和输出

输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。

输入

System.Management.Automation.PSObject

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

输出

System.IO.FileInfo

Export-Clixml 将创建一个包含 XML 的文件。

示例 1

C:\PS>"This is a test" | export-clixml sample.xml

说明
-----------
此命令将创建存储字符串表示形式的 XML 文件，例如“This is a test”。

示例 2

C:\PS>get-acl C:\test.txt | export-clixml -Path fileacl.xml

C:\PS> $fileacl = import-clixml fileacl.xml

说明
-----------
此示例演示了如何将对象导出到 XML 文件中，然后通过从文件中导入 XML 来创建对象。

第一条命令使用 Get-ACL cmdlet 来获取 Test.txt 文件的安全描述符。它使用管道运算符将安全描述符传递至 Export-Clixml，后者将对象的基于 XML 的表示形式存储在名为 FileACL.xml 的文件中。

第二条命令使用 Import-Clixml cmdlet 基于 FileACL.xml 文件中的 XML 创建对象。然后，它将对象保存在 $FileAcl 变量中。

另请参阅



目录