Создает 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.
См. также