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

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) для определения формата кодирования файла. Если файл не содержит 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
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>.