NOM
Export-CSV
RÉSUMÉ
Convertit les objets Microsoft .NET Framework en une série de chaînes de longueur variable séparées par des virgule
s (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] [-NoTy
peInformation] [-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 vo
us envoyez.
Vous pouvez ensuite utiliser l'applet de commande Import-CSV pour recréer les objets à partir des chaînes CSV des f
ichiers. Les objets obtenus sont des versions CSV des objets d'origine qui consistent en des représentations sous f
orme 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 p
rè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 vi
rgule 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 pr
emier objet que vous envoyez. Si les autres objets ne possèdent pas l'une des propriétés spécifiées, la valeur de p
ropriété de l'objet est nulle, ce qui est représenté par deux virgules consécutives. Si les autres objets ont des p
roprié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 , (virgule)
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, BigEndi
anUnicode, 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 [<SwitchParameter>]
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 c
ommande 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 [<SwitchParameter>]
Ne remplace pas un fichier existant (n'écrase pas son contenu). Par défaut, s'il existe un fichier dans le chem
in 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 [<SwitchParameter>]
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 [<SwitchParameter>]
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 recherche
r le séparateur de liste d'une culture, utilisez la commande (Get-Culture).TextInfo.ListSeparator.
Obligatoire ? false
Position ? named
Valeur par défaut Virgule
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 .NET Framework vers Export-CSV.
SORTIES
System.String
La liste CSV est envoyée au fichier désigné dans le paramètre Path.
NOTES
L'applet de commande Export-CSV convertit les objets que vous envoyez en une série de chaînes de longueur varia
ble au format CSV, puis les enregistre dans le fichier texte spécifié. Vous pouvez utiliser Export-CSV pour enr
egistrer 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'expo
rte 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 NoTypeI
nformation.
-- 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 for
mat CSV nommé data.csv.
-------------------------- EXEMPLE 2 --------------------------
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éper
toire actif. Étant donné qu'elle ne spécifie pas de délimiteur, une virgule (,) est utilisée pour séparer les champ
s 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éper
toire 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éper
toire 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
# 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éper
toire actif. Elle utilise le paramètre NoTypeInformation pour supprimer les informations de type du fichier.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=113299
Import-CSV
ConvertTo-CSV
ConvertFrom-CSV
Aucun commentaire:
Enregistrer un commentaire