Export-Clixml
创建对象的基于 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 变量中。