Создает XML-представление объекта или объектов и сохраняет его в файле.

Синтаксис

Export-Clixml [-Path] <string> -InputObject <psobject> [-Depth <int>] [-Кодирование <string>] [-Force] [-NoClobber] [-Confirm] [-WhatIf] [<CommonParameters>]

Описание

Командлет Export-Clixml создает XML-представление объекта или объектов и сохраняет его в файле. После этого с помощью командлета Import-CLIXML можно воссоздать сохраненный объект на основе содержимого этого файла.

Этот командлет аналогичен командлету ConvertTo-XML, за исключением того, что Export-Clixml сохраняет полученный XML-код в файл. Командлет ConvertTo-XML возвращает XML-код, чтобы его можно было далее обрабатывать с помощью Windows PowerShell.

Параметры

-Depth <int>

Задает число уровней вложенных объектов, которые включаются в XML-представление. По умолчанию используется значение 2.

Значение по умолчанию можно переопределить для типа объекта в файлах Types.ps1xml. Дополнительные сведения см. в разделе about_Types.ps1xml.

Обязательно?	false
Позиция?	named
Значение по умолчанию	2
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Кодирование <string>

Задает кодировку целевого файла. Допустимые значения: ASCII, UTF8, UTF7, UTF32, Unicode, BigEndianUnicode, Default и OEM. По умолчанию используется значение UTF8.

Обязательно?	false
Позиция?	named
Значение по умолчанию	UTF8
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Force

Указывает командлету снять для файла вывода атрибут "только чтение", если это необходимо. Когда выполнение команды завершится, командлет попытается заново установить атрибут "только чтение".

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-InputObject <psobject>

Задает объект, подлежащий преобразованию. Введите переменную, содержащую объекты, либо команду или выражение для получения объектов. Кроме того, можно передать объекты командлету Export-Clixml по конвейеру.

Обязательно?	true
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	true (ByValue)
Принимать подстановочные знаки?	false

-NoClobber

Не позволяет командлету перезаписать содержимое существующего файла. По умолчанию если файл существует по указанному пути, командлет Export-Clixml перезаписывает файл без предупреждения.

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Path <string>

Задает путь к файлу, в котором будет сохранено XML-представление объекта.

Обязательно?	true
Позиция?	1
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Confirm

Запрашивает подтверждение перед выполнением команды.

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-WhatIf

Описывает, что произойдет при выполнении команды, без ее фактического выполнения.

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

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

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

System.Management.Automation.PSObject

Любой объект можно передать командлету Export-Clixml по конвейеру.

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

System.IO.FileInfo

Командлет Export-Clixml создает файл, содержащий XML-код.

Пример 1

C:\PS>"This is a test" | export-clixml sample.xml

Описание
-----------
Эта команда создает XML-файл, который содержит представление строки "This is a test".

Пример 2

C:\PS>get-acl C:\test.txt | export-clixml -Path fileacl.xml

C:\PS> $fileacl = import-clixml fileacl.xml

Описание
-----------
В этом примере показано, как экспортировать объект в XML-файл, а затем создать объект путем импорта из XML-файла. 

В первой команде используется командлет Get-ACL, чтобы получить дескриптор безопасности файла Test.txt. С помощью оператора конвейера этот дескриптор безопасности передается командлету Export-Clixml, который сохраняет XML-представление объекта в файле FileACL.xml. 

Во второй команде с помощью командлета Import-Clixml из XML-кода, содержащегося в файле FileACL.xml, создается объект. После этого объект сохраняется в переменной $FileAcl.

Export-Clixml