Compartilhar via


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.





Consulte também

Conceitos

Import-Clixml
ConvertTo-XML
Export-CSV
ConvertTo-Html