Convertit les objets Microsoft .NET Framework en une série de chaînes de longueur variable séparées par des virgules (CSV), puis enregistre ces chaînes dans un fichier CSV.
Syntaxe
Export-CSV [[-Delimiter] <char>] [-Path] <string> -InputObject <psobject> [-Encoding <string>] [-Force] [-NoClobber] [-NoTypeInformation] [-Confirm] [-WhatIf] [<CommonParameters>] Export-CSV [-UseCulture] [-Path] <string> -InputObject <psobject> [-Encoding <string>] [-Force] [-NoClobber] [-NoTypeInformation] [-Confirm] [-WhatIf] [<CommonParameters>]
Description
L'applet de commande Export-CSV crée un fichier de longueur variable au format CSV qui représente les objets que vous envoyez.
Vous pouvez ensuite utiliser l'applet de commande Import-CSV pour recréer les objets à partir des chaînes CSV des fichiers. Les objets obtenus sont des versions CSV des objets d'origine qui consistent en des représentations sous forme de chaînes des valeurs de propriété et ne comportent pas de méthodes.
Vous pouvez également utiliser les applets de commande ConvertTo-CSV et ConvertFrom-CSV pour convertir des objets .NET Framework en chaînes CSV (et inversement). L'applet Export-CSV est identique à l'applet ConvertTo-CSV, à ceci près qu'elle enregistre les chaînes CSV dans un fichier.
Vous pouvez utiliser les paramètres de l'applet de commande Export-CSV pour spécifier un délimiteur autre qu'une virgule ou pour demander à Export-CSV d'utiliser le délimiteur par défaut de la culture actuelle.
Lorsque vous envoyez plusieurs objets à Export-CSV, Export-CSV organise le fichier en fonction des propriétés du premier objet que vous envoyez. Si les autres objets ne possèdent pas l'une des propriétés spécifiées, la valeur de propriété de l'objet est nulle, ce qui est représenté par deux virgules consécutives. Si les autres objets ont des propriétés supplémentaires, ces valeurs de propriété ne sont pas incluses dans le fichier.
Pour plus d'informations, consultez la section Remarques d'Export-CSV.
Paramètres
-Delimiter <char>
Spécifie un délimiteur pour séparer les valeurs de propriété. La valeur par défaut est une virgule (,). Entrez un caractère, tel qu'un signe deux-points (:). Pour spécifier un point-virgule (;), placez-le entre guillemets.
|
Obligatoire ? |
false |
|
Position ? |
2 |
|
Valeur par défaut |
, (comma) |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Encoding <string>
Spécifie l'encodage du fichier CSV exporté. Les valeurs valides sont Unicode, UTF7, UTF8, ASCII, UTF32, BigEndianUnicode, Default et OEM. La valeur par défaut est ASCII.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
ASCII |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Force
Remplace le fichier spécifié dans le chemin d'accès sans aucune invite.
|
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 les objets à exporter en tant que chaînes CSV. Entrez une variable contenant les objets ou tapez une commande ou une expression qui obtient les objets. Vous pouvez également diriger les objets vers Export-CSV.
|
Obligatoire ? |
true |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByValue, ByPropertyName) |
|
Accepter les caractères génériques ? |
false |
-NoClobber
Ne remplace pas un fichier existant (n'écrase pas son contenu). Par défaut, s'il existe un fichier dans le chemin d'accès spécifié, Export-CSV 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 |
-NoTypeInformation
Omet les informations de type du fichier CSV. Par défaut, la première ligne du fichier CSV contient « #TYPE », suivi du nom complet du type d'objet .NET Framework.
|
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 au fichier de sortie CSV. Ce paramètre est obligatoire.
|
Obligatoire ? |
true |
|
Position ? |
1 |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-UseCulture
Utilisez le séparateur de liste de la culture actuelle en tant que délimiteur d'éléments. La valeur par défaut est une virgule (,).
Ce paramètre est très utile dans les scripts distribués à des utilisateurs dans le monde entier. Pour rechercher le séparateur de liste d'une culture, utilisez la commande (Get-Culture).TextInfo.ListSeparator.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
Comma |
|
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 .NET Framework vers Export-CSV. |
|
Sorties |
System.String La liste CSV est envoyée au fichier désigné dans le paramètre Path. |
Remarques
L'applet de commande Export-CSV convertit les objets que vous envoyez en une série de chaînes de longueur variable au format CSV, puis les enregistre dans le fichier texte spécifié. Vous pouvez utiliser Export-CSV pour enregistrer les objets dans un fichier CSV, puis utiliser l'applet de commande Import-CSV pour créer des objets à partir du texte du fichier CSV.
Dans le fichier CSV, chaque objet est représenté par une liste séparée par des virgules des valeurs de propriété de l'objet. Les valeurs de propriété sont converties en chaînes (par l'intermédiaire de la méthode ToString() de l'objet). Elles sont donc généralement représentées par le nom de la valeur de propriété. Export-CSV n'exporte pas les méthodes de l'objet.
Le format d'un fichier exporté est le suivant :
-- La première ligne du fichier CSV contient la chaîne « #TYPE », suivie du nom complet du type .NET Framework de l'objet, tel que #TYPE System.Diagnostics.Process. Pour supprimer cette ligne, utilisez le paramètre NoTypeInformation.
-- La ligne suivante du fichier CSV représente les en-têtes de colonne. Elle contient une liste séparée par des virgules des noms de toutes les propriétés du premier objet.
-- Les autres lignes du fichier consistent en des listes séparées par des virgules des valeurs de propriété de chaque objet.
Exemple 1
C:\PS>get-process wmiprvse | select-object basePriority,ID,SessionID,WorkingSet | export-csv -path data.csv Description ----------- Cette commande sélectionne quelques propriétés du processus wmiprvse traitent et les exporte vers un fichier au format CSV nommé data.csv.
Exemple 2
C:\PS>get-process | export-csv processes.csv C:\PS> get-process | export-csv processes.csv # In processes.csv #TYPE System.Diagnostics.Process __NounName,Name,Handles,VM,WS,PM,NPM,Path,Company,CPU,FileVersion,... Process,powershell,626,201666560,76058624,61943808,11960,C:\WINDOWS... Process,powershell,257,151920640,38322176,37052416,7836,C:\WINDOWS\... Description ----------- Cette commande exporte les objets représentant les processus de l'ordinateur vers le fichier Processes.csv du répertoire actif. Étant donné qu'elle ne spécifie pas de délimiteur, une virgule (,) est utilisée pour séparer les champs du fichier.
Exemple 3
C:\PS>get-process | export-csv processes.csv -Delimiter ";" # In processes.csv #TYPE System.Diagnostics.Process __NounName;Name;Handles;VM;WS;PM;NPM;Path;Company;CPU;FileVersion;... Process;powershell;626;201666560;76058624;61943808;11960;C:\WINDOWS... Process;powershell;257;151920640;38322176;37052416;7836;C:\WINDOWS\... Description ----------- Cette commande exporte les objets représentant les processus de l'ordinateur vers le fichier Processes.csv du répertoire actif. Elle utilise le paramètre Delimiter pour spécifier le point-virgule (;). En conséquence, les champs du fichier sont séparés par des points-virgules.
Exemple 4
C:\PS>get-process | export-csv processes.csv -UseCulture Description ----------- Cette commande exporte les objets représentant les processus de l'ordinateur vers le fichier Processes.csv du répertoire actif. Elle utilise le paramètre UseCulture pour demander à Export-CSV d'utiliser le délimiteur spécifié par la propriété ListSeparator de la culture actuelle.
Exemple 5
C:\PS>get-process | export-csv processes.csv -NoTypeInformation C:\PS> get-process | export-csv processes.csv -NoTypeInformation # In processes.csv __NounName,Name,Handles,VM,WS,PM,NPM,Path,Company,CPU,FileVersion,... Process,powershell,626,201666560,76058624,61943808,11960,C:\WINDOWS... Process,powershell,257,151920640,38322176,37052416,7836,C:\WINDOWS\... Description ----------- Cette commande exporte les objets représentant les processus de l'ordinateur vers le fichier Processes.csv du répertoire actif. Elle utilise le paramètre NoTypeInformation pour supprimer les informations de type du fichier.
Voir aussi