Export-Csv

Module:

Microsoft.PowerShell.Utility Module

Convertit les objets en une série de chaînes de valeurs séparées par des caractères (CSV) et enregistre les chaînes dans un fichier.

Syntaxe

Delimiter (Par défaut)

Export-Csv
    [[-Path] <string>]
    [[-Delimiter] <char>]
    -InputObject <psobject>
    [-LiteralPath <string>]
    [-Force]
    [-NoClobber]
    [-Encoding <string>]
    [-Append]
    [-NoTypeInformation]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UseCulture

Export-Csv
    [[-Path] <string>]
    -InputObject <psobject>
    [-LiteralPath <string>]
    [-Force]
    [-NoClobber]
    [-Encoding <string>]
    [-Append]
    [-UseCulture]
    [-NoTypeInformation]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

L’applet Export-Csv de commande crée un fichier CSV des objets que vous soumettez. Chaque objet est une ligne qui inclut une liste séparée par des caractères des valeurs de propriété de l’objet. Vous pouvez utiliser l’applet de commande pour créer des feuilles de calcul et partager des données avec des programmes qui acceptent les Export-Csv fichiers CSV en entrée.

Ne formatez pas les objets avant de les envoyer à l’applet Export-Csv de commande. Si Export-Csv reçoit des objets formatés, le fichier CSV contient les propriétés de format plutôt que les propriétés de l’objet. Pour exporter uniquement les propriétés sélectionnées d’un objet, utilisez l’applet de Select-Object commande.

Exemples

Exemple 1 : Exporter les propriétés du processus dans un fichier CSV

Cet exemple sélectionne les objets de processus avec des propriétés spécifiques, exporte les objets dans un fichier CSV.

Get-Process -Name WmiPrvSE |
    Select-Object -Property BasePriority,Id,SessionId,WorkingSet |
    Export-Csv -Path .\WmiData.csv -NoTypeInformation
Import-Csv -Path .\WmiData.csv

BasePriority Id    SessionId WorkingSet
------------ --    --------- ----------
8            976   0         20267008
8            2292  0         36786176
8            3816  0         30351360
8            8604  0         15011840
8            10008 0         8830976
8            11764 0         14237696
8            54632 0         9502720

L’applet Get-Process de commande récupère les objets Process . Le paramètre Name filtre la sortie pour inclure uniquement les objets de processus WmiPrvSE. Les objets de processus sont envoyés dans le pipeline vers l’applet Select-Object de commande. Select-Object utilise le paramètre Property pour sélectionner un sous-ensemble de propriétés d’objet de processus. Les objets de processus sont envoyés dans le pipeline vers l’applet Export-Csv de commande. Export-Csv convertit les objets de processus en une série de chaînes CSV. Le paramètre Path spécifie que le WmiData.csv fichier est enregistré dans le répertoire actif. Le paramètre NoTypeInformation supprime l’en-tête d’informations #TYPE de la sortie CSV et n’est pas obligatoire dans PowerShell 6. L’applet Import-Csv de commande utilise le paramètre Path pour afficher le fichier situé dans le répertoire actif.

Exemple 2 : Exporter des processus vers un fichier délimité par des virgules

Cet exemple récupère les objets Process et les exporte dans un fichier CSV.

Get-Process | Export-Csv -Path .\Processes.csv -NoTypeInformation
Get-Content -Path .\Processes.csv

"Name","SI","Handles","VM","WS","PM","NPM","Path","Parent","Company","CPU","FileVersion", ...
"ApplicationFrameHost","4","511","2203597099008","35364864","21979136","30048", ...

L’applet Get-Process de commande récupère les objets Process . Les objets de processus sont envoyés dans le pipeline vers l’applet Export-Csv de commande. Export-Csv convertit les objets de processus en une série de chaînes CSV. Le paramètre Path spécifie que le Processes.csv fichier est enregistré dans le répertoire actif. Le paramètre NoTypeInformation supprime l’en-tête d’informations #TYPE de la sortie CSV et n’est pas obligatoire dans PowerShell 6. L’applet Get-Content de commande utilise le paramètre Path pour afficher le fichier situé dans le répertoire actif.

Exemple 3 : Exporter des processus vers un fichier délimité par des points-virgules

Cet exemple récupère les objets Process et les exporte dans un fichier avec un délimiteur point-virgule.

Get-Process | Export-Csv -Path .\Processes.csv -Delimiter ';' -NoTypeInformation
Get-Content -Path .\Processes.csv

"Name";"SI";"Handles";"VM";"WS";"PM";"NPM";"Path";"Parent";"Company";"CPU";"FileVersion"; ...
"ApplicationFrameHost";"4";"509";"2203595321344";"34807808";"21770240";"29504"; ...

L’applet Get-Process de commande récupère les objets Process . Les objets de processus sont envoyés dans le pipeline vers l’applet Export-Csv de commande. Export-Csv convertit les objets de processus en une série de chaînes CSV. Le paramètre Path spécifie que le Processes.csv fichier est enregistré dans le répertoire actif. Le paramètre délimiteur spécifie un point-virgule pour séparer les valeurs de chaîne. Le paramètre NoTypeInformation supprime l’en-tête d’informations #TYPE de la sortie CSV et n’est pas obligatoire dans PowerShell 6. L’applet Get-Content de commande utilise le paramètre Path pour afficher le fichier situé dans le répertoire actif.

Exemple 4 : Exporter des processus à l’aide du séparateur de liste de la culture actuelle

Cet exemple récupère les objets Process et les exporte dans un fichier. Le délimiteur est le séparateur de liste de la culture actuelle.

(Get-Culture).TextInfo.ListSeparator
Get-Process | Export-Csv -Path .\Processes.csv -UseCulture -NoTypeInformation
Get-Content -Path .\Processes.csv

"Name","SI","Handles","VM","WS","PM","NPM","Path","Parent","Company","CPU","FileVersion", ...
"ApplicationFrameHost","4","511","2203597099008","35364864","21979136","30048", ...

L’applet de commande Get-Culture utilise les propriétés imbriquées TextInfo et ListSeparator et affiche le séparateur de liste par défaut de la culture actuelle. L’applet Get-Process de commande récupère les objets Process . Les objets de processus sont envoyés dans le pipeline vers l’applet Export-Csv de commande. Export-Csv convertit les objets de processus en une série de chaînes CSV. Le paramètre Path spécifie que le Processes.csv fichier est enregistré dans le répertoire actif. Le paramètre UseCulture utilise le séparateur de liste par défaut de la culture actuelle comme séparateur. Le paramètre NoTypeInformation supprime l’en-tête d’informations #TYPE de la sortie CSV et n’est pas obligatoire dans PowerShell 6. L’applet Get-Content de commande utilise le paramètre Path pour afficher le fichier situé dans le répertoire actif.

Exemple 5 : Exporter des processus avec des informations de type

Cet exemple explique comment inclure les informations d’en-tête #TYPE dans un fichier CSV. L’en-tête #TYPE est l’en-tête par défaut dans les versions antérieures à PowerShell 6.0.

Get-Process | Export-Csv -Path .\Processes.csv
Get-Content -Path .\Processes.csv

#TYPE System.Diagnostics.Process
"Name","SI","Handles","VM","WS","PM","NPM","Path","Company","CPU","FileVersion", ...
"ApplicationFrameHost","4","507","2203595001856","35139584","20934656","29504", ...

L’applet Get-Process de commande récupère les objets Process . Les objets de processus sont envoyés dans le pipeline vers l’applet Export-Csv de commande. Export-Csv convertit les objets de processus en une série de chaînes CSV. Le paramètre Path spécifie que le Processes.csv fichier est enregistré dans le répertoire actif. L’applet Get-Content de commande utilise le paramètre Path pour afficher le fichier situé dans le répertoire actif.

Exemple 6 : Exporter et ajouter des objets à un fichier CSV

Cet exemple décrit comment exporter des objets dans un fichier CSV et utiliser le paramètre Ajouter pour ajouter des objets à un fichier existant.

$AppService = (Get-Service -DisplayName *Application* | Select-Object -Property DisplayName, Status)
$AppService | Export-Csv -Path .\Services.Csv -NoTypeInformation
Get-Content -Path .\Services.Csv
$WinService = (Get-Service -DisplayName *Windows* | Select-Object -Property DisplayName, Status)
$WinService | Export-Csv -Path .\Services.csv -NoTypeInformation -Append
Get-Content -Path .\Services.Csv

"DisplayName","Status"
"Application Layer Gateway Service","Stopped"
"Application Identity","Running"
"Windows Audio Endpoint Builder","Running"
"Windows Audio","Running"
"Windows Event Log","Running"

L’applet Get-Service de commande récupère les objets de service. Le paramètre DisplayName renvoie les services qui contiennent le mot Application. Les objets de service sont envoyés dans le pipeline vers l’applet Select-Object de commande. Select-Object utilise le paramètre Property pour spécifier les propriétés DisplayName et Status . La $AppService variable stocke les objets.

Les objets $AppService sont envoyés au pipeline à l’applet de commande Export-Csv. Export-Csv convertit les objets de service en une série de chaînes CSV. Le paramètre Path spécifie que le Services.csv fichier est enregistré dans le répertoire actif. Le paramètre NoTypeInformation supprime l’en-tête d’informations #TYPE de la sortie CSV et n’est pas obligatoire dans PowerShell 6. L’applet Get-Content de commande utilise le paramètre Path pour afficher le fichier situé dans le répertoire actif.

Les Get-Service applets de commande et Select-Object sont répétées pour les services qui contiennent le mot Windows. La $WinService variable stocke les objets de service. L’applet Export-Csv de commande utilise le paramètre Append pour spécifier que les $WinService objets sont ajoutés au fichier existant Services.csv . L’applet Get-Content de commande est répétée pour afficher le fichier mis à jour qui inclut les données ajoutées.

Exemple 7 : Mettre en forme l’applet de commande dans un pipeline crée des résultats inattendus

Cet exemple montre pourquoi il est important de ne pas utiliser d’applet de commande de format dans un pipeline. En cas de réception d’une sortie inattendue, résolvez la syntaxe du pipeline.

Get-Date | Select-Object -Property DateTime, Day, DayOfWeek, DayOfYear |
 Export-Csv -Path .\DateTime.csv -NoTypeInformation
Get-Content -Path .\DateTime.csv

"DateTime","Day","DayOfWeek","DayOfYear"
"Wednesday, January 2, 2019 14:59:34","2","Wednesday","2"

Get-Date | Format-Table -Property DateTime, Day, DayOfWeek, DayOfYear |
 Export-Csv -Path .\FTDateTime.csv -NoTypeInformation
Get-Content -Path .\FTDateTime.csv

"ClassId2e4f51ef21dd47e99d3c952918aff9cd","pageHeaderEntry","pageFooterEntry","autosizeInfo", ...
"033ecb2bc07a4d43b5ef94ed5a35d280",,,,"Microsoft.PowerShell.Commands.Internal.Format. ...
"9e210fe47d09416682b841769c78b8a3",,,,,
"27c87ef9bbda4f709f6b4002fa4af63c",,,,,
"4ec4f0187cb04f4cb6973460dfe252df",,,,,
"cf522b78d86c486691226b40aa69e95c",,,,,

L’applet Get-Date de commande récupère l’objet DateTime . L’objet est envoyé vers le bas du pipeline à l’applet Select-Object de commande. Select-Object utilise le paramètre Property pour sélectionner un sous-ensemble de propriétés d’objet. L’objet est envoyé vers le bas du pipeline à l’applet Export-Csv de commande. Export-Csv convertit l’objet au format CSV. Le paramètre Path spécifie que le DateTime.csv fichier est enregistré dans le répertoire actif. Le paramètre NoTypeInformation supprime l’en-tête d’informations #TYPE de la sortie CSV et n’est pas obligatoire dans PowerShell 6. L’applet Get-Content de commande utilise le paramètre Path pour afficher le fichier CSV situé dans le répertoire actif.

Lorsque l’applet Format-Table de commande est utilisée dans le pipeline pour sélectionner des propriétés, des résultats inattendus sont reçus. Format-Table envoie les objets de format de table dans le pipeline vers l’applet Export-Csv de commande plutôt que vers l’objet DateTime . Export-Csv convertit les objets de format de table en une série de chaînes CSV. L’applet Get-Content de commande affiche le fichier CSV qui contient les objets de format de table.

Exemple 8 : Utilisation du paramètre Force pour écraser des fichiers en lecture seule

Cet exemple crée un fichier vide en lecture seule et utilise le paramètre Force pour mettre à jour le fichier.

New-Item -Path .\ReadOnly.csv -ItemType File
Set-ItemProperty -Path .\ReadOnly.csv -Name IsReadOnly -Value $true
Get-Process | Export-Csv -Path .\ReadOnly.csv -NoTypeInformation

Export-Csv : Access to the path 'C:\ReadOnly.csv' is denied.
At line:1 char:15
+ Get-Process | Export-Csv -Path .\ReadOnly.csv -NoTypeInformation
+               ~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo          : OpenError: (:) [Export-Csv], UnauthorizedAccessException
+ FullyQualifiedErrorId : FileOpenFailure,Microsoft.PowerShell.Commands.ExportCsvCommand

Get-Process | Export-Csv -Path .\ReadOnly.csv -NoTypeInformation -Force
Get-Content -Path .\ReadOnly.csv

"Name";"SI";"Handles";"VM";"WS";"PM";"NPM";"Path";"Parent";"Company";"CPU";"FileVersion"; ...
"ApplicationFrameHost";"4";"509";"2203595321344";"34807808";"21770240";"29504"; ...

L’applet New-Item de commande utilise les paramètres Path et ItemType pour créer le ReadOnly.csv fichier dans le répertoire actif. L’applet Set-ItemProperty de commande utilise les paramètres Name et Value pour définir la propriété IsReadOnly du fichier sur true. L’applet Get-Process de commande récupère les objets Process . Les objets de processus sont envoyés dans le pipeline vers l’applet Export-Csv de commande. Export-Csv convertit les objets de processus en une série de chaînes CSV. Le paramètre Path spécifie que le ReadOnly.csv fichier est enregistré dans le répertoire actif. Le paramètre NoTypeInformation supprime l’en-tête d’informations #TYPE de la sortie CSV et n’est pas obligatoire dans PowerShell 6. Le résultat indique que le fichier n’est pas écrit, car l’accès est refusé.

Le paramètre Force est ajouté à l’applet Export-Csv de commande pour forcer l’exportation à écrire dans le fichier. L’applet Get-Content de commande utilise le paramètre Path pour afficher le fichier situé dans le répertoire actif.

Exemple 9 : Utilisation du paramètre Force avec Append

Cet exemple montre comment utiliser les paramètres Force et Append . Lorsque ces paramètres sont combinés, les propriétés d’objet non concordantes peuvent être écrites dans un fichier CSV.

$Content = [pscustomobject]@{Name = 'PowerShell'; Version = '7.0'}
$Content | Export-Csv -Path .\ParmFile.csv -NoTypeInformation
$AdditionalContent = [pscustomobject]@{Name = 'Windows PowerShell'; Edition = 'Desktop'}
$AdditionalContent | Export-Csv -Path .\ParmFile.csv -NoTypeInformation -Append

Export-Csv : Cannot append CSV content to the following file: ParmFile.csv.
The appended object does not have a property that corresponds to the following column:
Version. To continue with mismatched properties, add the -Force parameter, and then retry
 the command.
At line:1 char:22
+ $AdditionalContent | Export-Csv -Path .\ParmFile.csv -NoTypeInformation -Append
+                      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo          : InvalidData: (Version:String) [Export-Csv], InvalidOperationException
+ FullyQualifiedErrorId : CannotAppendCsvWithMismatchedPropertyNames,Microsoft.PowerShell. ...

$AdditionalContent | Export-Csv -Path .\ParmFile.csv -NoTypeInformation -Append -Force
Import-Csv -Path .\ParmFile.csv

Name               Version
----               -------
PowerShell         7.0
Windows PowerShell

Une expression crée le PSCustomObject avec les propriétés Name et Version . Les valeurs sont stockées dans la variable $Content. La variable $Content est envoyée au pipeline à l’applet de commande Export-Csv. Export-Csv utilise le paramètre Path et enregistre le ParmFile.csv fichier dans le répertoire actif. Le paramètre NoTypeInformation supprime l’en-tête d’informations #TYPE de la sortie CSV et n’est pas obligatoire dans PowerShell 6.

Une autre expression crée un PSCustomObject avec les propriétés Name et Edition . Les valeurs sont stockées dans la variable $AdditionalContent. La variable $AdditionalContent est envoyée au pipeline à l’applet de commande Export-Csv. Le paramètre Append permet d’ajouter les données au fichier. L’ajout échoue car il existe une incompatibilité de nom de propriété entre Version et Edition.

Le Export-Csv paramètre Force de l’applet de commande est utilisé pour forcer l’exportation à écrire dans le fichier. La propriété Edition est ignorée. L’applet Import-Csv de commande utilise le paramètre Path pour afficher le fichier situé dans le répertoire actif.

Paramètres

-Append

Utilisez ce paramètre pour ajouter Export-Csv une sortie CSV à la fin du fichier spécifié. Sans ce paramètre, Export-Csv remplace le contenu du fichier sans avertissement.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	cf

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Delimiter

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.

Propriétés du paramètre

Type:	Char
Valeur par défaut:	comma (,)
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

Delimiter

Position:	1
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Encoding

Spécifie l’encodage du fichier CSV exporté. La valeur par défaut est ASCII.

Les valeurs acceptables pour ce paramètre sont les suivantes :

• ASCII utilise le jeu de caractères ASCII (7 bits).
• BigEndianUnicode utilise UTF-16 avec l’ordre d’octet big-endian.
• Default Utilise l’encodage qui correspond à la page de codes active du système (généralement ANSI).
• OEM Utilise l’encodage qui correspond à la page de codes OEM actuelle du système.
• Unicode utilise UTF-16 avec l’ordre d’octet little-endian.
• UTF7 utilise UTF-7.
• UTF8 utilise UTF-8.
• UTF32 utilise UTF-32 avec l’ordre d’octet little-endian.

Propriétés du paramètre

Type:	String
Valeur par défaut:	ASCII
Valeurs acceptées:	ASCII, BigEndianUnicode, Default, OEM, Unicode, UTF7, UTF8, UTF32
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Force

Ce paramètre permet Export-Csv d’écraser les fichiers avec l’attribut Lecture seule .

Lorsque les paramètres Forcer et Ajouter sont combinés, les objets qui contiennent des propriétés incompatibles peuvent être écrits dans un fichier CSV. Seules les propriétés correspondantes sont écrites dans le fichier. Les propriétés non concordantes sont ignorées.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-InputObject

Spécifie les objets à exporter sous forme de chaînes CSV. Entrez une variable qui contient les objets ou tapez une commande ou une expression qui obtient les objets. Vous pouvez également diriger des objets vers Export-Csv.

Propriétés du paramètre

Type:	PSObject
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	True
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-LiteralPath

Spécifie le chemin d’accès au fichier de sortie CSV. Contrairement à Path, la valeur du paramètre LiteralPath est utilisée exactement comme il est typé. Aucun caractère n’est interprété en tant que caractère générique. Si le chemin d’accès comprend des caractères d’échappement, utilisez des guillemets simples. Les guillemets simples indiquent à PowerShell de ne pas interpréter de caractères comme séquences d’échappement.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	PSPath

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-NoClobber

Utilisez ce paramètre pour Export-Csv ne pas écraser un fichier existant. Par défaut, si le fichier existe dans le chemin d’accès spécifié, Export-Csv écrase le fichier sans avertissement.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	NoOverwrite

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-NoTypeInformation

Supprime l’en-tête d’information #TYPE du résultat. Ce paramètre est devenu la valeur par défaut dans PowerShell 6.0 et est inclus pour la compatibilité descendante.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	NTI

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Path

Paramètre obligatoire qui spécifie l’emplacement d’enregistrement du fichier de sortie CSV.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	0
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-UseCulture

Utilise le séparateur de liste de la culture actuelle comme délimiteur d’élément. Pour rechercher le séparateur de liste pour une culture, utilisez la commande suivante : (Get-Culture).TextInfo.ListSeparator.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

UseCulture

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-WhatIf

Empêche le traitement de l’applet de commande ou l’apport de modifications. La sortie montre ce qui se passerait si l’applet de commande était exécutée.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	Wi

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

PSObject

Vous pouvez diriger n’importe quel objet avec un adaptateur ETS (Extended Type System) vers cette applet de commande.

Sorties

None

Cette applet de commande ne retourne aucune sortie.

Notes

Windows PowerShell inclut les alias suivants pour Export-Csv:

• epcsv

L’applet Export-Csv de commande convertit les objets que vous soumettez en une série de chaînes CSV et les enregistre dans le fichier texte spécifié. Vous pouvez utiliser Export-Csv pour enregistrer des objets dans un fichier CSV, puis utiliser l’applet Import-Csv de commande pour créer des objets à partir du fichier CSV.

Dans le fichier CSV, chaque objet est représenté par une liste séparée par des caractères des valeurs de propriété de l’objet. Les valeurs de propriété sont converties en chaînes à l’aide de la méthode ToString( ). Les chaînes sont représentées par le nom de la valeur de propriété. 'Export-Csv n’exporte pas les méthodes de l’objet.

Les chaînes CSV sont sorties comme suit :

• Par défaut, la première chaîne contient l’en-tête d’informations #TYPE suivi du nom complet du type d’objet. Par exemple, #TYPE System.Diagnostics.Process.
• Si noTypeInformation est utilisé, la première chaîne inclut les en-têtes de colonne. Les en-têtes contiennent les noms de propriétés du premier objet sous la forme d’une liste séparée par des caractères.
• Les chaînes restantes contiennent des listes séparées par des caractères des valeurs de propriété de chaque objet.

Lorsque vous soumettez plusieurs objets à Export-Csv, Export-Csv organise le fichier en fonction des propriétés du premier objet que vous soumettez. Si les objets restants n’ont pas l’une des propriétés spécifiées, la valeur de propriété de cet objet est null, représentée par deux virgules consécutives. Si les objets restants ont des propriétés supplémentaires, ces valeurs de propriété ne sont pas incluses dans le fichier.

Vous pouvez utiliser l’applet Import-Csv de commande pour recréer des objets à partir des chaînes CSV dans les fichiers. Les objets résultants sont des versions CSV des objets d’origine qui se composent de représentations sous forme de chaîne des valeurs de propriété et d’aucune méthode.

Les ConvertTo-Csv applets de commande et ConvertFrom-Csv convertissent les objets en chaînes CSV et à partir de chaînes CSV. Export-Csv est identique à ConvertTo-Csv, sauf qu’il enregistre les chaînes CSV dans un fichier.

Liens associés

• ConvertFrom-Csv
• ConvertTo-Csv
• Format-Table
• Import-Csv
• Select-Object