Partager via


Export-Csv

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.

Syntax

Export-Csv
      [[-Path] <string>]
      [[-Delimiter] <char>]
      -InputObject <psobject>
      [-LiteralPath <string>]
      [-Force]
      [-NoClobber]
      [-Encoding <string>]
      [-Append]
      [-NoTypeInformation]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
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 envoyez. 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 Export-CSV de commande pour créer des feuilles de calcul et partager des données avec des programmes qui acceptent des fichiers CSV comme entrée.

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

Exemples

Exemple 1 : Exporter des propriétés de processus vers un fichier CSV

Cet exemple sélectionne les objets Process 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 obtient 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 au 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 de processus. Les objets de processus sont envoyés au pipeline à 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 obtient les objets Process et exporte les objets 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 obtient les objets Process . Les objets de processus sont envoyés au pipeline à 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 obtient les objets Process et exporte les objets 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 obtient les objets Process . Les objets de processus sont envoyés au pipeline à 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 obtient les objets Process et exporte les objets 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 Get-Culture de commande 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 obtient les objets Process . Les objets de processus sont envoyés au pipeline à 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 la valeur 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 obtient les objets Process . Les objets de processus sont envoyés au pipeline à 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 vers un fichier CSV et utiliser le paramètre Append 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 obtient des objets de service. Le paramètre DisplayName retourne des services qui contiennent le mot Application. Les objets de service sont envoyés au pipeline à 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 $AppService objets sont envoyés au pipeline vers l’applet Export-Csv de commande. 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 les applets de commande 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 une applet de commande de format dans un pipeline. Lorsque la sortie inattendue est reçue, résolvez les problèmes de 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 obtient 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 les résultats inattendus des propriétés sont reçues. Format-Table envoie des objets de format de tableau vers le bas du pipeline à l’applet Export-Csv de commande plutôt qu’à l’objet DateTime . Export-Csv convertit les objets de format de tableau 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 tableau.

Exemple 8 : Utilisation du paramètre Force pour remplacer les 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 Nom et Valeur pour remplacer la propriété IsReadOnly du fichier par true. L’applet Get-Process de commande obtient les objets Process . Les objets de processus sont envoyés au pipeline à 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. La sortie 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 incompatibles 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 $Content variable. La $Content variable est envoyée au pipeline à l’applet Export-Csv de commande. 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 $AdditionalContent variable. La $AdditionalContent variable est envoyée au pipeline à l’applet Export-Csv de commande. Le paramètre Append est utilisé pour ajouter les données au fichier. L’ajout échoue, car il existe une incompatibilité entre la version et l’édition du nom de propriété.

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 dis carte ed. 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 la 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.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Char
Position:1
Default value:comma (,)
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Encoding

Spécifie l'encodage pour le 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.
Type:String
Accepted values:ASCII, BigEndianUnicode, Default, OEM, Unicode, UTF7, UTF8, UTF32
Position:Named
Default value:ASCII
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Ce paramètre permet Export-Csv de remplacer les fichiers avec l’attribut Lecture seule .

Lorsque les paramètres Force et Append sont combinés, les objets qui contiennent des propriétés incompatibles peuvent être écrits dans un fichier CSV. Seules les propriétés qui correspondent sont écrites dans le fichier. Les propriétés incompatibles sont dis carte ed.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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 les obtient. Vous pouvez également diriger des objets vers Export-CSV.

Type:PSObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 elle est typée. Aucun caractère n’est interprété en tant que caractère générique. Si le chemin inclut 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.

Type:String
Aliases:PSPath
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoClobber

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

Type:SwitchParameter
Aliases:NoOverwrite
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoTypeInformation

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

Type:SwitchParameter
Aliases:NTI
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Paramètre obligatoire qui spécifie l’emplacement pour enregistrer le fichier de sortie CSV.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseCulture

Utilise le séparateur de liste pour 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.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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 pas de sortie.

Notes

Windows PowerShell inclut les alias suivants pour Export-Csv:

  • epcsv

L’applet Export-CSV de commande convertit les objets que vous envoyez 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 envoyez 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ésentation sous forme de 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 les versions CSV des objets d'origine qui se composent des représentations de chaînes des valeurs de propriété et d'aucune méthode.

Les ConvertTo-Csv applets de commande et ConvertFrom-Csv les applets de commande 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.