Crée une représentation XML d'un ou de plusieurs objets et la stocke dans un fichier.
Syntaxe
Export-Clixml [-Path] <string> -InputObject <psobject> [-Depth <int>] [-Encoding <string>] [-Force] [-NoClobber] [-Confirm] [-WhatIf] [<CommonParameters>]
Description
L'applet de commande Export-Clixml crée une représentation XML d'un ou plusieurs objets et la stocke dans un fichier. Vous pouvez utiliser ensuite l'applet de commande Import-CLIXML pour recréer l'objet enregistré selon le contenu de ce fichier.
Cette applet de commande est semblable à l'applet de commande ConvertTo-XML, sauf que Export-Clixml stocke le contenu XML obtenu dans un fichier. ConvertTo-XML retourne le contenu XML, que vous pouvez donc continuer à traiter dans Windows PowerShell.
Paramètres
-Depth <int>
Spécifie combien de niveaux d'objets contenus sont inclus dans la représentation XML. La valeur par défaut est 2.
La valeur par défaut peut être remplacée pour le type d'objet dans les fichiers Types.ps1xml. Pour plus d'informations, consultez about_Types.ps1xml.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
2 |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Encoding <string>
Spécifie le type d'encodage pour le fichier cible. Les valeurs valides sont ASCII, UTF8, UTF7, UTF32, Unicode, BigEndianUnicode, Default et OEM. La valeur par défaut est UTF8.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
UTF8 |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Force
Fait en sorte que l'applet de commande désactive l'attribut de lecture seule du fichier de sortie, s'il est défini. L'applet de commande essaiera de réinitialiser l'attribut de lecture seule lors de l'exécution de la commande.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-InputObject <psobject>
Spécifie l'objet à convertir. Entrez une variable contenant les objets ou tapez une commande ou une expression permettant d'obtenir ces objets. Vous pouvez également diriger les objets vers Export-Clixml.
|
Obligatoire ? |
true |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByValue) |
|
Accepter les caractères génériques ? |
false |
-NoClobber
Garantit que l'applet de commande ne remplace pas le contenu d'un fichier existant. Par défaut, si un fichier existe dans le chemin d'accès spécifié, Export-Clixml le remplace sans avertissement.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Path <string>
Spécifie le chemin d'accès du fichier où la représentation XML de l'objet sera stockée.
|
Obligatoire ? |
true |
|
Position ? |
1 |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Confirm
Vous invite à confirmer l'exécution de la commande.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-WhatIf
Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
|
Entrées |
System.Management.Automation.PSObject Vous pouvez diriger n'importe quel objet vers Export-Clixml. |
|
Sorties |
System.IO.FileInfo Export-Clixml crée un fichier qui contient le XML. |
Exemple 1
C:\PS>"This is a test" | export-clixml sample.xml Description ----------- Cette commande crée un fichier XML qui stocke une représentation de la chaîne « This is a test » (« Ceci est un test »).
Exemple 2
C:\PS>get-acl C:\test.txt | export-clixml -Path fileacl.xml C:\PS> $fileacl = import-clixml fileacl.xml Description ----------- Cet exemple montre comment exporter un objet vers un fichier XML, puis créer un objet en important le contenu XML à partir du fichier. La première commande utilise l'applet de commande Get-ACL pour obtenir le descripteur de sécurité du fichier Test.txt. Elle utilise un opérateur de pipeline pour passer le descripteur de sécurité à Export-Clixml, qui stocke une représentation XML de l'objet dans un fichier intitulé FileACL.xml. La deuxième commande utilise l'applet de commande Import-Clixml pour créer un objet à partir du contenu XML dans le fichier FileACL.xml. Elle enregistre ensuite l'objet dans la variable $FileAcl.
Voir aussi