Import-Clixml

Import-Clixml
    [-Path] <String[]>
    [-IncludeTotalCount]
    [-Skip <UInt64>]
    [-First <UInt64>]
    [<CommonParameters>]

Import-Clixml
    -LiteralPath <String[]>
    [-IncludeTotalCount]
    [-Skip <UInt64>]
    [-First <UInt64>]
    [<CommonParameters>]

Import-Clixml cmdlet 导入已序列化为公共语言基础结构 (CLI) XML 文件的对象。 在 Windows 计算机上，使用 Import-Clixml 的一个宝贵用途是导入凭据和安全字符串，这些凭据和字符串是使用 Export-Clixml导出为安全 XML 的。 示例 #2 演示如何使用 Import-Clixml 导入安全凭据对象。

CLIXML 数据被反序列化为 PowerShell 对象。 但是，反序列化的对象不是实时对象。 它们是序列化时对象的快照。 反序列化的对象包括属性，但没有方法。

TypeNames 属性包含前缀为 Deserialized的原始类型名称。 示例 #3 显示反序列化对象的 TypeNames 属性。

Import-Clixml 使用字节顺序标记（BOM）来检测文件的编码格式。 如果文件没有 BOM，则假定编码为 UTF8。

有关 CLI 的详细信息，请参阅 语言独立。

此示例使用 Export-Clixml cmdlet 保存由 Get-Process返回的进程信息的序列化副本。 Import-Clixml 检索序列化文件的内容，并重新创建存储在 $Processes 变量中的对象。

Get-Process | Export-Clixml -Path .\pi.xml
$Processes = Import-Clixml -Path .\pi.xml

在此示例中，如果您已通过运行 $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 将安全凭据对象导入脚本。 此导入消除了在脚本中公开纯文本密码的风险。

此示例演示如何导入存储为 CLIXML 数据的对象。 数据反序列化回 PowerShell 对象。 但是，反序列化的对象不是实时对象。 它们是序列化时对象的快照。 反序列化的对象包括属性，但没有方法。

$original = [pscustomobject] @{
    Timestamp = Get-Date
    Label     = 'Meeting event'
}
$original | Add-Member -MemberType ScriptMethod -Name GetDisplay -Value {
    '{0:yyyy-MM-dd HH:mm} {1}' -f $this.Timestamp, $this.Label
}
$original | Get-Member -MemberType ScriptMethod

   TypeName: System.Management.Automation.PSCustomObject

Name        MemberType   Definition
----        ----------   ----------
Equals      Method       bool Equals(System.Object obj)
GetHashCode Method       int GetHashCode()
GetType     Method       type GetType()
ToString    Method       string ToString()
Label       NoteProperty string Label=Meeting event
Timestamp   NoteProperty System.DateTime Timestamp=1/31/2024 2:27:59 PM
GetDisplay  ScriptMethod System.Object GetDisplay();

$original | Export-Clixml -Path event.clixml
$deserialized = Import-CliXml -Path event.clixml
$deserialized | Get-Member

   TypeName: Deserialized.System.Management.Automation.PSCustomObject

Name        MemberType   Definition
----        ----------   ----------
Equals      Method       bool Equals(System.Object obj)
GetHashCode Method       int GetHashCode()
GetType     Method       type GetType()
ToString    Method       string ToString()
Label       NoteProperty string Label=Meeting event
Timestamp   NoteProperty System.DateTime Timestamp=1/31/2024 2:27:59 PM

请注意，$original 中对象的类型是 System.Management.Automation.PSCustomObject，而 $deserialized 中对象的类型是 Deserialized.System.Management.Automation.PSCustomObject。 此外，反序列化对象中缺少 GetDisplay() 方法。

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

可以通过管道将包含路径的字符串传递给此 cmdlet。

此 cmdlet 返回从存储的 XML 文件反序列化的对象。

为参数指定多个值时，请使用逗号分隔值。 例如，<parameter-name> <value1>, <value2>。