Import-Clixml

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

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

Командлет Import-Clixml импортирует объекты, сериализованные в XML-файл common Language Infrastructure (CLI). Ценное использование Import-Clixml на компьютерах Windows заключается в импорте учетных данных и безопасных строк, экспортированных как безопасный XML с помощью Export-Clixml. примере #2 показано, как использовать Import-Clixml для импорта защищенного объекта учетных данных.

Данные CLIXML десериализируются обратно в объекты PowerShell. Однако десериализированные объекты не являются динамическими объектами. Они представляют собой моментальный снимок объектов во время сериализации. Десериализированные объекты включают свойства, но не методы.

Свойство TypeNames содержит префикс имени исходного типа, префиксированного Deserialized. примере #3 показать свойство TypeNames десериализированного объекта.

Import-Clixml использует метку байтового порядка (BOM) для обнаружения формата кодирования файла. Если файл не имеет BOM, предполагается, что кодировка — UTF8.

Дополнительные сведения о интерфейсе командной строки см. в независимости языка.

В этом примере используется командлет Export-Clixml для сохранения сериализованной копии сведений о процессе, возвращаемой Get-Process. Import-Clixml извлекает содержимое сериализованного файла и повторно создает объект, хранящийся в переменной $Processes.

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

В этом примере, имея учетные данные, которые вы сохранили в переменной $Credential, с помощью командлета Get-Credential, вы можете исполнить командлет Export-Clixml, чтобы записать учетные данные на диск.

$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 шифрует объекты учетных данных с помощью API защиты данных Windows . Шифрование гарантирует, что только ваша учетная запись пользователя может расшифровать содержимое объекта учетных данных. Экспортируемый 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

Обратите внимание, что тип объекта в $originalSystem.Management.Automation.PSCustomObject, но тип объекта в $deserializeddeserialized.System.Management.Automation.PSCustomObject. Кроме того, метод GetDisplay() отсутствует из десериализированного объекта.

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Можно передать строку, содержащую путь к этому командлету.

Этот командлет возвращает объекты, десериализованные из сохраненных XML-файлов.

При указании нескольких значений для параметра используйте запятые для разделения значений. Например: <parameter-name> <value1>, <value2>.