Share via

ConvertTo-Xml

  • Ссылка
Модуль:
Microsoft.PowerShell.Utility

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

Синтаксис

ConvertTo-Xml
              [-Depth <Int32>]
              [-InputObject] <PSObject>
              [-NoTypeInformation]
              [-As <String>]
              [<CommonParameters>]

Описание

Командлет ConvertTo-Xml создает xml-представление одного или нескольких объектов .NET. Чтобы использовать этот командлет, передайте в командлет один или несколько объектов или используйте параметр InputObject , чтобы указать объект .

Если передать несколько объектов ConvertTo-Xml в или использовать параметр InputObject для отправки нескольких объектов, ConvertTo-Xml возвращается один xml-документ в памяти, содержащий представления всех объектов.

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

Примеры

Пример 1. Преобразование даты в XML

Get-Date | ConvertTo-Xml

Эта команда преобразует текущую дату (объект DateTime ) в XML.

Пример 2. Преобразование процессов в XML

ConvertTo-Xml -As "Document" -InputObject (Get-Process) -Depth 3

Эта команда преобразует объекты процесса, представляющие все процессы на компьютере, в XML-документ. Объекты расширяются до трех уровней.

Параметры

-As

Определяет формат вывода. Допустимые значения для этого параметра:

  • String — возвращает одну строку.
  • Stream — возвращает массив строк.
  • Document — возвращает объект XmlDocument .

Значение по умолчанию — Document.

Type:String
Accepted values:Stream, String, Document
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Depth

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

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

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

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

-InputObject

Задает объект для преобразования. Введите переменную, которая содержит объекты, или команду или выражение, которое возвращает объекты. Объекты также можно передать в ConvertTo-XML.

Type:PSObject
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoTypeInformation

Исключает атрибут Type из узлов объектов.

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

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

PSObject

Вы можете передать любой объект в этот командлет.

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

String

Если вы используете параметр As и задаете значение string, этот командлет возвращает XML в виде строки. Если значение равно stream, этот командлет возвращает массив строк.

XmlDocument

По умолчанию этот командлет возвращает XML-документ.