Export-Clixml

NOM
    Export-Clixml

RÉSUMÉ
    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 [<SwitchParameter>]
        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 [<SwitchParameter>]
        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 [<SwitchParameter>]
        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 [<SwitchParameter>]
        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, WarningAction, WarningVariable,
        OutBuffer et OutVariable. Pour plus d'informations, tapez
        « get-help about_commonparameters ».

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.


NOTES





    -------------------------- 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.






LIENS CONNEXES
    Online version: http://go.microsoft.com/fwlink/?LinkID=113297
    Import-Clixml
    ConvertTo-XML
    Export-Csv
    ConvertTo-Html