Поделиться через

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 импортирует XML-файл CLI с данными, которые представляют объекты Microsoft платформа .NET Framework и создают объекты PowerShell. Дополнительные сведения об интерфейсе командной строки см. в разделе Независимость от языка.

Полезное использование на компьютерах Windows заключается в импорте учетных данных и защищенных строк, экспортированных в виде защищенного Import-Clixml XML-кода с помощью Export-Clixml. Пример см. в примере 2.

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

Примеры

Пример 1. Импорт сериализованного файла и повторное создание объекта

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

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

Пример 2. Импорт защищенного объекта учетных данных

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

Важно!

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

В этом примере файл, в котором хранятся учетные данные, представлен с помощью TestScript.ps1.credential. Замените TestScript именем скрипта, с помощью которого загружаются учетные данные.

Объект учетных данных отправляется по конвейеру Export-Clixmlв и сохраняется по пути $Credxmlpath, указанному в первой команде.

Чтобы автоматически импортировать учетные данные в скрипт, выполните последние две команды. Выполните команду Import-Clixml , чтобы импортировать защищенный объект учетных данных в скрипт. Такой импорт исключает риск раскрытия паролей в виде обычного текста в скрипте.

Параметры

-First

Получает только указанное количество объектов. Введите количество объектов, которые необходимо получить.

Type:UInt64
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeTotalCount

Сообщает общее количество объектов в наборе данных, за которыми следуют выбранные объекты. Если командлету не удается определить общее число, отображается значение Неизвестное общее число. Целое число имеет свойство Точность , указывающее надежность общего значения счетчика. Значение Точности находится в диапазоне от 0.0 до 1.0 , где 0.0 означает, что командлет не может подсчитать объекты, означает, 1.0 что счетчик является точным, а значение между 0.0 и 1.0 указывает на все более надежную оценку.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LiteralPath

Указывает путь к XML-файлам. В отличие от Path, значение параметра LiteralPath используется точно так, как он типизированный. Никакие символы не интерпретируются как знаки подстановки. Если путь содержит escape-символы, заключите его в одинарные кавычки. Одинарные кавычки предписывают PowerShell не интерпретировать какие-либо символы как escape-последовательности.

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

Указывает путь к XML-файлам.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Skip

Игнорирует указанное количество объектов, а затем получает оставшиеся объекты. Введите количество объектов, которые необходимо пропустить.

Type:UInt64
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Входные данные

String

Можно конвейерировать строку, содержащую путь к Import-Clixml.

Выходные данные

PSObject

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

Примечания

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