Export-Clixml

Export-Clixml
    [-Path] <String>
    -InputObject <PSObject>
    [-Depth <Int32>]
    [-Force]
    [-NoClobber]
    [-Encoding <Encoding>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Export-Clixml
    -LiteralPath <String>
    -InputObject <PSObject>
    [-Depth <Int32>]
    [-Force]
    [-NoClobber]
    [-Encoding <Encoding>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Export-Clixml cmdlet 将对象序列化为基于公共语言基础结构 （CLI） XML 的表示形式，将其存储在文件中。 然后，可以使用 Import-Clixml cmdlet 根据该文件的内容重新创建已保存的对象。 有关 CLI 的详细信息，请参阅 语言独立。

此 cmdlet 类似于 ConvertTo-Xml，不同之处在于 Export-Clixml 将生成的 XML 存储在文件中。 ConvertTo-Xml 返回 XML，因此你可以继续在 PowerShell 中处理它。

在 Windows 计算机上使用 Export-Clixml 的宝贵用途是将凭据和安全字符串安全地导出为 XML。 有关示例，请参阅示例 3。

此示例创建一个 XML 文件，该文件存储在当前目录中，字符串的表示形式 这是一个测试。

"This is a test" | Export-Clixml -Path .\sample.xml

字符串 This is a test 发送到管道。 Export-Clixml 使用 Path 参数在当前目录中创建名为 sample.xml 的 XML 文件。

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

Get-Acl C:\test.txt | Export-Clixml -Path .\FileACL.xml
$fileacl = Import-Clixml -Path .\FileACL.xml

Get-Acl cmdlet 获取 Test.txt 文件的安全描述符。 它将对象向下发送管道，以将安全描述符传递给 Export-Clixml。 对象的基于 XML 的表示形式存储在名为 FileACL.xml的文件中。

Import-Clixml cmdlet 从 FileACL.xml 文件中的 XML 创建对象。 然后，它将对象保存在 $fileacl 变量中。

在此示例中，如果您已通过运行 $Credential cmdlet 将凭据存储在 Get-Credential 变量中，则可以运行 Export-Clixml cmdlet 将该凭据保存到磁盘。

$Credxmlpath = Join-Path (Split-Path $PROFILE) TestScript.ps1.credential
$Credential | Export-Clixml $Credxmlpath
$Credxmlpath = Join-Path (Split-Path $PROFILE) TestScript.ps1.credential
$Credential = Import-Clixml $Credxmlpath

Export-Clixml cmdlet 使用 Windows 数据保护 API来加密凭据对象。 加密可确保只有该计算机上的用户帐户才能解密凭据对象的内容。 导出 CLIXML 文件不能在不同的计算机上或其他用户使用。

在此示例中，存储凭据的文件由 TestScript.ps1.credential表示。 将 TestScript 替换为脚本名称，可使用该脚本加载凭据。

将凭据对象向下发送到管道 Export-Clixml，并将其保存到在第一个命令中指定的路径 $Credxmlpath。

若要将凭据自动导入脚本，请运行最后两个命令。 运行 Import-Clixml 将安全凭据对象导入脚本。 此导入消除了在脚本中公开纯文本密码的风险。

在此示例中，我们使用 cmdlet 在 $Credential 变量中创建 Get-Credential。 然后使用 Export-Clixml 将凭据保存到磁盘。

PS> $Credential = Get-Credential

PowerShell credential request
Enter your credentials.
User: User1
Password for user User1: ********

PS> $Credential | Export-Clixml ./cred2.xml
PS> Get-Content ./cred2.xml

...
    <Props>
      <S N="UserName">User1</S>
      <SS N="Password">700061007300730077006f0072006400</SS>
    </Props>
...

PS> 'password' | Format-Hex -Encoding unicode

   Label: String (System.String) <52D60C91>

          Offset Bytes                                           Ascii
                 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
          ------ ----------------------------------------------- -----
0000000000000000 70 00 61 00 73 00 73 00 77 00 6F 00 72 00 64 00 p a s s w o r d

此示例中 Get-Content 的输出已被截断，以专注于 XML 文件中的凭据信息。 请注意，密码的纯文本值以 Unicode 字符数组的形式存储在 XML 文件中，由 Format-Hex证明。 因此，该值已编码，但未加密。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

可以将任何对象管道传递给此 cmdlet。

此 cmdlet 返回一个 FileInfo 对象，该对象代表使用存储的数据创建的文件。