Compartilhar via

ConvertTo-Xml

Módulo:
Microsoft.PowerShell.Utility Module

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

Sintaxe

Default (Default) 

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

Description

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

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

Esse cmdlet é semelhante a Export-Clixml exceto que Export-Clixml armazena o XML resultante em um arquivo. ConvertTo-Xml retorna o XML, para que você possa continuar processá-lo no PowerShell.

Exemplos

Exemplo 1: converter uma data em XML

PS C:\> Get-Date | ConvertTo-Xml

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

Exemplo 2: Converter processos em XML

PS C:\> 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 este parâmetro são:

  • Cadeia de caracteres. Retorna uma única cadeia de caracteres.
  • Riacho. Retorna uma matriz de cadeias de caracteres.
  • Documento. Retorna um objeto XmlDocument .

O valor padrão é Document.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Valores aceitos:Stream, String, Document
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 contiverem objetos, para salvar uma representação XML das propriedades dos objetos contidos, você deverá especificar uma profundidade de 2.

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

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-InputObject

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

Propriedades do parâmetro

Tipo:PSObject
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-NoTypeInformation

Omite o atributo Type dos nós do objeto.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

PSObject

Você pode redirecionar qualquer objeto para ConvertTo-XML.

Saídas

System.String or System.Xml.XmlDocument

O valor do parâmetro As determina o tipo de objeto que convertTo-XML retorna.