ConvertTo-CliXml
Converte um objeto em uma cadeia de caracteres formatada em CliXml.
Sintaxe
Default (Predefiniçã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). Este comando é semelhante ao Export-Clixml, mas não grava em um arquivo. Em vez disso, ele gera uma cadeia de caracteres.
Este cmdlet foi introduzido no PowerShell 7.5-preview.4.
Exemplos
Exemplo 1 - Converter um objeto de processo em CliXml e vice-versa
Este exemplo mostra o resultado da conversão de um objeto de processo em CliXml e vice-versa. Primeiro, o processo atual é armazenado na variável $process. A propriedade pstypenames do objeto process mostra que o objeto é do tipo System.Diagnostics.Process. O próximo comando 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 vice-versa. 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 são incluídos na representação XML. Os valores padrão são 2.
Propriedades dos parâmetros
| Tipo: | Int32 |
| Default value: | 2 |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-InputObject
O objeto a ser convertido em uma cadeia de caracteres formatada em CliXml.
Propriedades dos parâmetros
| Tipo: | PSObject |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
