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