Crea una rappresentazione basata su XML di uno o più oggetti e la archivia in un file.

Sintassi

Export-Clixml [-Path] <string> -InputObject <psobject> [-Depth <int>] [-Encoding <string>] [-Force] [-NoClobber] [-Confirm] [-WhatIf] [<CommonParameters>]

Descrizione

Il cmdlet Export-Clixml consente di creare una rappresentazione basata su XML di uno o più oggetti e di archiviarla in un file. Sarà quindi possibile utilizzare il cmdlet Import-CLIXML per ricreare l'oggetto salvato in base al contenuto del file.

Questo cmdlet è simile a ConvertTo-XML, a eccezione del fatto che Export-Clixml consente di archiviare l'XML risultante in un file. ConvertTo-XML restituisce l'XML, per consentire di continuarne l'elaborazione in Windows PowerShell.

Parametri

-Depth <int>

Specifica quanti livelli di oggetti contenuti vengono inclusi nella rappresentazione XML. Il valore predefinito è 2.

È possibile eseguire l'override del valore predefinito per il tipo di oggetto nei file Types.ps1xml. Per ulteriori informazioni, vedere about_Types.ps1xml.

Obbligatorio?

false

Posizione?

named

Valore predefinito

2

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Encoding <string>

Specifica il tipo di codifica del file di destinazione. I valori validi sono ASCII, UTF8, UTF7, UTF32, Unicode, BigEndianUnicode, Default e OEM. Il valore predefinito è UTF8.

Obbligatorio?

false

Posizione?

named

Valore predefinito

UTF8

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Force

Forza il cmdlet a cancellare l'attributo di sola lettura del file di output, se necessario. Dopo il completamento del comando, il cmdlet tenterà di reimpostare l'attributo di sola lettura.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-InputObject <psobject>

Specifica l'oggetto da convertire. Immettere una variabile contenente gli oggetti oppure digitare un comando o un'espressione che consente di ottenere gli oggetti. È inoltre possibile reindirizzare gli oggetti a Export-Clixml.

Obbligatorio?

true

Posizione?

named

Valore predefinito

Accettare input da pipeline?

true (ByValue)

Accettare caratteri jolly?

false

-NoClobber

Assicura che il cmdlet non sovrascriva il contenuto di un file esistente. Per impostazione predefinita, se nel percorso specificato è presente un file, Export-Clixml lo sovrascrive senza visualizzare alcun avviso.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Path <string>

Specifica il percorso del file in cui verrà archiviata la rappresentazione XML dell'oggetto.

Obbligatorio?

true

Posizione?

1

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Confirm

Chiede una conferma prima di eseguire il comando.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-WhatIf

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Input e output

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Input

System.Management.Automation.PSObject

È possibile reindirizzare qualsiasi oggetto a Export-Clixml.

Output

System.IO.FileInfo

Export-Clixml crea un file che contiene XML.

Esempio 1

C:\PS>"This is a test" | export-clixml sample.xml

Descrizione
-----------
Tramite questo comando verrà creato un file XML in cui è archiviata una rappresentazione della stringa "This is a test".






Esempio 2

C:\PS>get-acl C:\test.txt | export-clixml -Path fileacl.xml

C:\PS> $fileacl = import-clixml fileacl.xml

Descrizione
-----------
In questo esempio viene illustrato come esportare un oggetto in un file XML e creare quindi un oggetto importando l'XML dal file. 

Nel primo comando viene utilizzato il cmdlet Get-ACL per ottenere il descrittore di sicurezza del file Test.txt. Viene utilizzato un operatore pipeline per passare il descrittore di sicurezza a Export-Clixml che archivia una rappresentazione basata su XML dell'oggetto in un file denominato FileACL.xml. 

Nel secondo comando viene utilizzato il cmdlet Import-Clixml per creare un oggetto dall'XML nel file FileACL.xml. L'oggetto viene quindi salvato nella variabile $FileAcl.






Vedere anche




Argomenti della Guida