Export-Clixml
Cria uma representação baseada em XML de um objeto ou objetos e a armazena em um arquivo.
Sintaxe
Export-Clixml [-Path] <string> -InputObject <psobject> [-Depth <int>] [-Encoding <string>] [-Force] [-NoClobber] [-Confirm] [-WhatIf] [<CommonParameters>]
Descrição
O cmdlet Export-Clixml cria uma representação baseada em XML de um objeto ou objetos e a armazena em um arquivo. Você pode usar o cmdlet Import-CLIXML para criar novamente o objeto salvo com base no conteúdo desse arquivo.
Esse cmdlet é semelhante ao ConvertTo-XML, com a exceção de que o Export-Clixml armazena o XML resultante em um arquivo. O ConvertTo-XML retorna o XML para que você possa continuar a processá-lo no Windows PowerShell.
Parâmetros
-Depth <int>
Especifica quantos níveis de objetos contidos são incluídos na representação XML. O valor padrão é 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.
Necessário? |
false |
Posição? |
named |
Valor padrão |
2 |
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-Encoding <string>
Especifica o tipo de codificação para o arquivo de destino. Os valores válidos são ASCII, UTF8, UTF7, UTF32, Unicode, BigEndianUnicode, Default e OEM. UTF8 é o padrão.
Necessário? |
false |
Posição? |
named |
Valor padrão |
UTF8 |
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-Force
Se necessário, faz com que o cmdlet limpe o atributo somente leitura do arquivo de saída. Após o comando ter sido concluído, o cmdlet tentará redefinir o atributo somente leitura.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-InputObject <psobject>
Especifica o objeto a ser convertido. Insira uma variável que contenha os objetos ou digite um comando ou uma expressão que obtenha os objetos. Também é possível canalizar objetos para Export-Clixml.
Necessário? |
true |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
true (ByValue) |
Aceitar caracteres curinga? |
false |
-NoClobber
Garante que o cmdlet não substituirá o conteúdo de um arquivo existente. Por padrão, se existir um arquivo no caminho especificado, o Export-Clixml substituirá o arquivo sem aviso prévio.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-Path <string>
Especifica o caminho para o arquivo no qual a representação XML do objeto será armazenada.
Necessário? |
true |
Posição? |
1 |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-Confirm
Solicita confirmação antes da execução do comando.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-WhatIf
Descreve o que aconteceria se você executasse o comando, sem executá-lo de fato.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
<CommonParameters>
Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
Entradas |
System.Management.Automation.PSObject Você pode canalizar qualquer objeto para Export-Clixml. |
Saídas |
System.IO.FileInfo O Export-Clixml cria um arquivo que contém o XML. |
Exemplo 1
C:\PS>"This is a test" | export-clixml sample.xml
Descrição
-----------
Este comando cria um arquivo XML que armazena uma representação da cadeia de caracteres, "Isto é um teste".
Exemplo 2
C:\PS>get-acl C:\test.txt | export-clixml -Path fileacl.xml
C:\PS> $fileacl = import-clixml fileacl.xml
Descrição
-----------
Esse exemplo mostra como exportar um objeto para um arquivo XML e, em seguida, criar um objeto importando o XML do arquivo.
O primeiro comando usa o cmdlet Get-ACL para obter o descritor de segurança do arquivo Test.txt. Ele usa um operador de pipeline para transmitir o descritor de segurança ao Export-Clixml que armazena uma representação baseada em XML do objeto em um arquivo denominado FileACL.xml.
O segundo comando usa o cmdlet Import-Clixml para criar um objeto a partir do XML no arquivo FileACL.xml. Em seguida, ele salva o objeto na variável $FileAcl.