ConvertTo-CliXml
Converte um objeto em uma cadeia de caracteres formatada em CliXml.
Sintaxe
Default (Padrão)
ConvertTo-CliXml
[-InputObject] <PSObject>
[-Depth <Int32>]
[<CommonParameters>]
Description
O cmdlet ConvertTo-CliXml converte objetos em cadeias de caracteres formatadas como XML da CLI (Common Language Infrastructure). Esse comando é semelhante a Export-Clixml, mas não grava em um arquivo. Em vez disso, ele gera uma cadeia de caracteres.
Esse cmdlet foi introduzido no PowerShell 7.5-preview.4.
Exemplos
Exemplo 1 – Converter um objeto de processo em CliXml e voltar
Este exemplo mostra o resultado da conversão de um objeto de processo para CliXml e de volta. Primeiro, o processo atual é armazenado na variável $process. A propriedade pstypenames do objeto de processo mostra que o objeto é do tipo System.Diagnostics.Process. O comando a seguir exibe a contagem para cada tipo de membro no objeto de processo.
$process = Get-Process -Id $PID
$process.pstypenames
System.Diagnostics.Process
System.ComponentModel.Component
System.MarshalByRefObject
System.Object
$process | Get-Member | Group-Object MemberType | Select-Object Name, Count
Name Count
---- -----
AliasProperty 7
CodeProperty 1
Property 52
NoteProperty 1
ScriptProperty 8
PropertySet 2
Method 19
Event 4
$xml = $process | ConvertTo-CliXml
$fromXML = ConvertFrom-CliXml $xml
$fromXML.pstypenames
Deserialized.System.Diagnostics.Process
Deserialized.System.ComponentModel.Component
Deserialized.System.MarshalByRefObject
Deserialized.System.Object
$fromXML | Get-Member | Group-Object MemberType | Select-Object Name, Count
Name Count
---- -----
Property 46
NoteProperty 17
PropertySet 2
Method 2
Em seguida, o objeto de processo é convertido em CliXml e de volta. O tipo do novo objeto é prefixado com Deserialized. A contagem de membros no novo objeto é diferente do objeto original.
Parâmetros
-Depth
Especifica quantos níveis de objetos contidos estão incluídos na representação XML. Os valores padrão são 2.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | 2 |
| 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
O objeto a ser convertido em uma cadeia de caracteres formatada em CliXml.
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 |
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.
