Compartilhar via


ConvertTo-Xml

Cria uma representação de um objeto baseada em XML.

Sintaxe

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

Description

O ConvertTo-Xml cmdlet cria uma representação baseada em XML de um ou mais objetos .NET. Para usar esse cmdlet, canalize um ou mais objetos para o cmdlet ou use o parâmetro InputObject para especificar o objeto.

Quando você canaliza vários objetos ou ConvertTo-Xml usa o parâmetro InputObject para enviar vários objetos ConvertTo-Xml , retorna um único documento XML na memória que inclui representações de todos os objetos.

Esse cmdlet é semelhante ao Export-Clixml , exceto que Export-Clixml armazena o XML resultante em um arquivo CLI (Common Language Infrastructure) que pode ser reimportado como objetos com Import-Clixml. ConvertTo-Xml retorna uma representação na memória de um documento XML, para que você possa continuar a processá-lo no PowerShell. ConvertTo-Xml não tem a opção de converter objetos em XML da CLI.

Exemplos

Exemplo 1: Converter uma data em XML

Get-Date | ConvertTo-Xml

Esse comando converte a data atual (um objeto DateTime ) em XML.

Exemplo 2: Converter processos em XML

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

Esse comando converte os objetos de processo que representam todos os processos no computador em um documento XML. Os objetos são expandidos para uma profundidade de três níveis.

Parâmetros

-As

Determina o formato de saída. Os valores aceitáveis para esse parâmetro são:

  • String - Retorna uma única string.
  • Stream - Retorna uma matriz de strings.
  • Document - Retorna um objeto XmlDocument .

O valor padrão é Document.

Tipo:String
Valores aceitos:Stream, String, Document
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Depth

Especifica quantos níveis de objetos contidos estão incluídos na representação XML. O valor padrão é 1.

Por exemplo, se as propriedades do objeto também contêm objetos e você deseja salvar uma representação XML das propriedades dos objetos nelas contidos, é necessário especificar uma profundidade igual a 2.

O valor padrão pode ser substituído para o tipo de objeto em questão nos arquivos Types.ps1xml. Para obter mais informações, consulte about_Types.ps1xml.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifica o objeto a ser convertido. Insira uma variável que contém os objetos ou digite um comando ou uma expressão que obtém os objetos. Você também pode canalizar objetos para ConvertTo-XML.

Tipo:PSObject
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-NoTypeInformation

Omite o atributo Type dos nós do objeto.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

PSObject

Você pode canalizar qualquer objeto para esse cmdlet

Saídas

String

Quando você usa o parâmetro As e define o valor como string, esse cmdlet retorna o XML como uma cadeia de caracteres. Quando o valor é stream, esse cmdlet retorna uma matriz de cadeias de caracteres.

XmlDocument

Por padrão, esse cmdlet retorna um documento XML.