Import-Clixml

参考

模块:: Microsoft.PowerShell.Utility

导入 CLIXML 文件并在 PowerShell 中创建相应的对象。

语法

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 文件，其中包含表示Microsoft .NET Framework 对象并创建 PowerShell 对象的数据。有关 CLI 的详细信息，请参阅语言独立。

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

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

示例

示例 1：导入序列化文件并重新创建对象

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

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

示例 2：导入安全凭据对象

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

重要

Export-Clixml 仅导出 Windows 上的加密凭据。在非 Windows 操作系统（如 macOS 和 Linux）上，凭据以纯文本形式导出。

$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 将安全凭据对象导入脚本。此导入消除了在脚本中公开纯文本密码的风险。

参数

-First

仅获取指定的对象数。输入要获取的对象数。

类型:	UInt64
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-IncludeTotalCount

报告数据集中的对象总数，后跟所选对象。如果 cmdlet 无法确定总计数，则会显示 未知的总计数。该整数具有 准确性 属性，指示总计数值的可靠性。 准确性 的值范围从 0.0 到 1.0，其中 0.0 表示 cmdlet 无法对对象进行计数，1.0 表示计数精确，0.0 和 1.0 之间的值表示越来越可靠的估计。

类型:	SwitchParameter
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-LiteralPath

指定 XML 文件的路径。与 Path不同，LiteralPath 参数的值与类型化完全相同。不会将任何字符解释为通配符。如果路径包含转义字符，请将它括在单引号中。单引号告知 PowerShell 不要将任何字符解释为转义序列。

类型:	String[]
别名:	PSPath
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Path

指定 XML 文件的路径。

类型:	String[]
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Skip

忽略指定的对象数，然后获取其余对象。输入要跳过的对象数。

类型:	UInt64
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

String

可以管道包含指向 Import-Clixml的路径的字符串。

输出

PSObject

Import-Clixml 返回从存储的 XML 文件反序列化的对象。

备注

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

通过