Freigeben über


Export-Csv

Konvertiert Objekte in eine Reihe von CSV-Zeichenfolgen (Zeichentrennzeichen) und speichert die Zeichenfolgen in einer Datei.

Syntax

Export-Csv
      -InputObject <PSObject>
      [[-Path] <String>]
      [-LiteralPath <String>]
      [-Force]
      [-NoClobber]
      [-Encoding <Encoding>]
      [-Append]
      [[-Delimiter] <Char>]
      [-IncludeTypeInformation]
      [-NoTypeInformation]
      [-QuoteFields <String[]>]
      [-UseQuotes <QuoteKind>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Export-Csv
      -InputObject <PSObject>
      [[-Path] <String>]
      [-LiteralPath <String>]
      [-Force]
      [-NoClobber]
      [-Encoding <Encoding>]
      [-Append]
      [-UseCulture]
      [-IncludeTypeInformation]
      [-NoTypeInformation]
      [-QuoteFields <String[]>]
      [-UseQuotes <QuoteKind>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Export-CSV Cmdlet erstellt eine CSV-Datei der von Ihnen übermittelten Objekte. Jedes Objekt ist eine Zeile, die eine durch Zeichen getrennte Liste der Eigenschaftswerte des Objekts enthält. Sie können das Export-CSV Cmdlet verwenden, um Tabellenkalkulationen zu erstellen und Daten mit Programmen zu teilen, die CSV-Dateien als Eingabe akzeptieren.

Formatieren Sie keine Objekte, bevor Sie sie an das Export-CSV Cmdlet senden. Wenn Export-CSV formatierte Objekte empfangen, enthält die CSV-Datei die Formateigenschaften und nicht die Objekteigenschaften. Verwenden Sie das Select-Object Cmdlet, um nur ausgewählte Eigenschaften eines Objekts zu exportieren.

Beispiele

Beispiel 1: Exportieren von Prozesseigenschaften in eine CSV-Datei

In diesem Beispiel werden Objekte mit bestimmten Eigenschaften verarbeiten ausgewählt und die Objekte in eine CSV-Datei exportiert.

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

Das Get-Process Cmdlet ruft die Process-Objekte ab. Der Parameter Name filtert die Ausgabe so, dass nur die WmiPrvSE-Prozessobjekte eingeschlossen werden. Die Prozessobjekte werden von der Pipeline an das Select-Object Cmdlet gesendet. Select-Object verwendet den Property-Parameter , um eine Teilmenge der Prozessobjekteigenschaften auszuwählen. Die Prozessobjekte werden von der Pipeline an das Export-Csv Cmdlet gesendet. Export-Csv konvertiert die Prozessobjekte in eine Reihe von CSV-Zeichenfolgen. Der Path-Parameter gibt an, dass die WmiData.csv Datei im aktuellen Verzeichnis gespeichert wird. Der Parameter NoTypeInformation entfernt den #TYPE-Informationsheader aus der CSV-Ausgabe und ist in PowerShell 6 nicht erforderlich. Das Import-Csv Cmdlet verwendet den Path-Parameter , um die Datei im aktuellen Verzeichnis anzuzeigen.

Beispiel 2: Exportieren von Prozessen in eine durch Trennzeichen getrennte Datei

In diesem Beispiel werden Process-Objekte abgerufen und die Objekte in eine CSV-Datei exportiert.

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

Das Get-Process Cmdlet ruft Process-Objekte ab. Die Prozessobjekte werden von der Pipeline an das Export-Csv Cmdlet gesendet. Export-Csv konvertiert die Prozessobjekte in eine Reihe von CSV-Zeichenfolgen. Der Path-Parameter gibt an, dass die Processes.csv Datei im aktuellen Verzeichnis gespeichert wird. Der Parameter NoTypeInformation entfernt den #TYPE-Informationsheader aus der CSV-Ausgabe und ist in PowerShell 6 nicht erforderlich. Das Get-Content Cmdlet verwendet den Path-Parameter , um die Datei im aktuellen Verzeichnis anzuzeigen.

Beispiel 3: Exportieren von Prozessen in eine durch Semikolon getrennte Datei

In diesem Beispiel werden Process-Objekte abgerufen und die Objekte mit einem Semikolontrennzeichen in eine Datei exportiert.

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

Das Get-Process Cmdlet ruft Process-Objekte ab. Die Prozessobjekte werden von der Pipeline an das Export-Csv Cmdlet gesendet. Export-Csv konvertiert die Prozessobjekte in eine Reihe von CSV-Zeichenfolgen. Der Path-Parameter gibt an, dass die Processes.csv Datei im aktuellen Verzeichnis gespeichert wird. Der Parameter Delimiter gibt ein Semikolon an, um die Zeichenfolgenwerte zu trennen. Der Parameter NoTypeInformation entfernt den #TYPE-Informationsheader aus der CSV-Ausgabe und ist in PowerShell 6 nicht erforderlich. Das Get-Content Cmdlet verwendet den Path-Parameter , um die Datei im aktuellen Verzeichnis anzuzeigen.

Beispiel 4: Exportieren von Prozessen mithilfe des Listentrennzeichens der aktuellen Kultur

In diesem Beispiel werden Process-Objekte abgerufen und die Objekte in eine Datei exportiert. Das Trennzeichen ist das Listentrennzeichen der aktuellen Kultur.

(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", ...

Das Get-Culture Cmdlet verwendet die geschachtelten Eigenschaften TextInfo und ListSeparator und zeigt das Standardlistentrennzeichen der aktuellen Kultur an. Das Get-Process Cmdlet ruft Process-Objekte ab. Die Prozessobjekte werden von der Pipeline an das Export-Csv Cmdlet gesendet. Export-Csv konvertiert die Prozessobjekte in eine Reihe von CSV-Zeichenfolgen. Der Path-Parameter gibt an, dass die Processes.csv Datei im aktuellen Verzeichnis gespeichert wird. Der UseCulture-Parameter verwendet das Standardlistentrennzeichen der aktuellen Kultur als Trennzeichen. Der Parameter NoTypeInformation entfernt den #TYPE-Informationsheader aus der CSV-Ausgabe und ist in PowerShell 6 nicht erforderlich. Das Get-Content Cmdlet verwendet den Path-Parameter , um die Datei im aktuellen Verzeichnis anzuzeigen.

Beispiel 5: Exportieren von Prozessen mit Typinformationen

In diesem Beispiel wird erläutert, wie die #TYPE-Headerinformationen in eine CSV-Datei eingeschlossen werden. Der #TYPE-Header ist die Standardeinstellung in Versionen vor PowerShell 6.0.

Get-Process | Export-Csv -Path .\Processes.csv -IncludeTypeInformation
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", ...

Das Get-Process Cmdlet ruft Process-Objekte ab. Die Prozessobjekte werden von der Pipeline an das Export-Csv Cmdlet gesendet. Export-Csv konvertiert die Prozessobjekte in eine Reihe von CSV-Zeichenfolgen. Der Path-Parameter gibt an, dass die Processes.csv Datei im aktuellen Verzeichnis gespeichert wird. IncludeTypeInformation enthält den #TYPE-Informationsheader in der CSV-Ausgabe. Das Get-Content Cmdlet verwendet den Path-Parameter , um die Datei im aktuellen Verzeichnis anzuzeigen.

Beispiel 6: Exportieren und Anfügen von Objekten an eine CSV-Datei

In diesem Beispiel wird beschrieben, wie Sie Objekte in eine CSV-Datei exportieren und den Append-Parameter verwenden, um einer vorhandenen Datei Objekte hinzuzufügen.

$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"

Das Get-Service Cmdlet ruft Dienstobjekte ab. Der DisplayName-Parameter gibt Dienste zurück, die das Wort Application enthalten. Die Dienstobjekte werden über die Pipeline an das Select-Object Cmdlet gesendet. Select-Object verwendet den Property-Parameter , um die Eigenschaften DisplayName und Status anzugeben. Die $AppService -Objekte werden in der Variablen gespeichert.

Die $AppService Objekte werden über die Pipeline an das Export-Csv Cmdlet gesendet. Export-Csv konvertiert die Dienstobjekte in eine Reihe von CSV-Zeichenfolgen. Der Path-Parameter gibt an, dass die Services.csv Datei im aktuellen Verzeichnis gespeichert wird. Der Parameter NoTypeInformation entfernt den #TYPE-Informationsheader aus der CSV-Ausgabe und ist in PowerShell 6 nicht erforderlich. Das Get-Content Cmdlet verwendet den Path-Parameter , um die Datei im aktuellen Verzeichnis anzuzeigen.

Die Get-Service Cmdlets und Select-Object werden für Dienste wiederholt, die das Wort Windows enthalten. Die $WinService -Variable speichert die Dienstobjekte. Das Export-Csv Cmdlet verwendet den Append-Parameter , um anzugeben, dass die $WinService Objekte der vorhandenen Services.csv Datei hinzugefügt werden. Das Get-Content Cmdlet wird wiederholt, um die aktualisierte Datei anzuzeigen, die die angefügten Daten enthält.

Beispiel 7: Format-Cmdlet innerhalb einer Pipeline führt zu unerwarteten Ergebnissen

Dieses Beispiel zeigt, warum es wichtig ist, kein Format-Cmdlet innerhalb einer Pipeline zu verwenden. Wenn eine unerwartete Ausgabe empfangen wird, beheben Sie die Pipelinesyntax.

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",,,,,

Das Get-Date Cmdlet ruft das DateTime-Objekt ab. Das Objekt wird in der Pipeline an das Select-Object Cmdlet gesendet. Select-Object verwendet den Property-Parameter , um eine Teilmenge der Objekteigenschaften auszuwählen. Das Objekt wird in der Pipeline an das Export-Csv Cmdlet gesendet. Export-Csv konvertiert das -Objekt in ein CSV-Format. Der Path-Parameter gibt an, dass die DateTime.csv Datei im aktuellen Verzeichnis gespeichert wird. Der Parameter NoTypeInformation entfernt den #TYPE-Informationsheader aus der CSV-Ausgabe und ist in PowerShell 6 nicht erforderlich. Das Get-Content Cmdlet verwendet den Path-Parameter , um die CSV-Datei im aktuellen Verzeichnis anzuzeigen.

Wenn das Format-Table Cmdlet innerhalb der Pipeline verwendet wird, um Eigenschaften auszuwählen, werden unerwartete Ergebnisse empfangen. Format-Table sendet Tabellenformatobjekte nach unten in der Pipeline an das Export-Csv Cmdlet und nicht an das DateTime-Objekt . Export-Csv konvertiert die Tabellenformatobjekte in eine Reihe von CSV-Zeichenfolgen. Das Get-Content Cmdlet zeigt die CSV-Datei an, die die Tabellenformatobjekte enthält.

Beispiel 8: Verwenden des Force-Parameters zum Überschreiben schreibgeschützter Dateien

In diesem Beispiel wird eine leere schreibgeschützte Datei erstellt und der Force-Parameter verwendet, um die Datei zu aktualisieren.

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

Das New-Item Cmdlet verwendet die Parameter Path und ItemType , um die ReadOnly.csv Datei im aktuellen Verzeichnis zu erstellen. Das Set-ItemProperty Cmdlet verwendet die Parameter Name und Value , um die IsReadOnly-Eigenschaft der Datei in true zu ändern. Das Get-Process Cmdlet ruft Process-Objekte ab. Die Prozessobjekte werden von der Pipeline an das Export-Csv Cmdlet gesendet. Export-Csv konvertiert die Prozessobjekte in eine Reihe von CSV-Zeichenfolgen. Der Path-Parameter gibt an, dass die ReadOnly.csv Datei im aktuellen Verzeichnis gespeichert wird. Der Parameter NoTypeInformation entfernt den #TYPE-Informationsheader aus der CSV-Ausgabe und ist in PowerShell 6 nicht erforderlich. Die Ausgabe zeigt, dass die Datei nicht geschrieben wird, weil der Zugriff verweigert wird.

Der Force-Parameter wird dem Export-Csv Cmdlet hinzugefügt, um zu erzwingen, dass der Export in die Datei schreibt. Das Get-Content Cmdlet verwendet den Path-Parameter , um die Datei im aktuellen Verzeichnis anzuzeigen.

Beispiel 9: Verwenden des Force-Parameters mit Append

In diesem Beispiel wird gezeigt, wie die Parameter Force und Append verwendet werden. Wenn diese Parameter kombiniert werden, können nicht übereinstimmende Objekteigenschaften in eine CSV-Datei geschrieben werden.

$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

Ein Ausdruck erstellt das PSCustomObject mit den Eigenschaften Name und Version . Die Werte werden in der $Content Variablen gespeichert. Die $Content Variable wird an das Export-Csv Cmdlet gesendet. Export-Csv verwendet den Path-Parameter und speichert die ParmFile.csv Datei im aktuellen Verzeichnis. Der NoTypeInformation-Parameter entfernt den #TYPE-Informationsheader aus der CSV-Ausgabe und ist in PowerShell 6 nicht erforderlich.

Ein anderer Ausdruck erstellt ein PSCustomObject mit den Eigenschaften Name und Edition . Die Werte werden in der $AdditionalContent Variablen gespeichert. Die $AdditionalContent Variable wird an das Export-Csv Cmdlet gesendet. Der Append-Parameter wird verwendet, um die Daten zur Datei hinzuzufügen. Der Anfügevorgang schlägt fehl, da zwischen Version und Edition ein Eigenschaftsnamekonflikt besteht.

Das Export-Csv Cmdlet Force-Parameter wird verwendet, um zu erzwingen, dass der Export in die Datei schreibt. Die Edition-Eigenschaft wird verworfen. Das Import-Csv Cmdlet verwendet den Parameter Path , um die Datei anzuzeigen, die sich im aktuellen Verzeichnis befindet.

Beispiel 10: Exportieren in CSV mit Anführungszeichen um zwei Spalten

In diesem Beispiel wird ein DateTime-Objekt in eine CSV-Zeichenfolge konvertiert.

Get-Date | Export-Csv  -QuoteFields "DateTime","Date" -Path .\FTDateTime.csv
Get-Content -Path .\FTDateTime.csv

DisplayHint,"DateTime","Date",Day,DayOfWeek,DayOfYear,Hour,Kind,Millisecond,Minute,Month,Second,Ticks,TimeOfDay,Year
DateTime,"Thursday, August 22, 2019 11:27:34 AM","8/22/2019 12:00:00 AM",22,Thursday,234,11,Local,569,27,8,34,637020700545699784,11:27:34.5699784,2019

Beispiel 11: Exportieren in CSV mit Anführungszeichen nur bei Bedarf

In diesem Beispiel wird ein DateTime-Objekt in eine CSV-Zeichenfolge konvertiert.

Get-Date | Export-Csv  -UseQuotes AsNeeded -Path .\FTDateTime.csv
Get-Content -Path .\FTDateTime.csv

DisplayHint,DateTime,Date,Day,DayOfWeek,DayOfYear,Hour,Kind,Millisecond,Minute,Month,Second,Ticks,TimeOfDay,Year
DateTime,"Thursday, August 22, 2019 11:31:00 AM",8/22/2019 12:00:00 AM,22,Thursday,234,11,Local,713,31,8,0,637020702607132640,11:31:00.7132640,2019

Beispiel 12: Konvertieren von Hashtabellen in CSV

Wenn Sie In PowerShell 7.2 und höher Hashtabellen in CSV exportieren, werden die Schlüssel der ersten Hashtabelle serialisiert und als Header in der CSV-Dateiausgabe verwendet.

$person1 = @{
    Name = 'John Smith'
    Number = 1
}

$person2 = @{
    Name = 'Jane Smith'
    Number = 1
}

$allPeople = $person1, $person2
$allPeople | Export-Csv -Path .\People.csv

Get-Content -Path .\People.csv

"Name","Number"
"John Smith","1"
"Jane Smith","2"

Beispiel 13: Konvertieren von Hashtabellen in CSV mit zusätzlichen Eigenschaften

Wenn Sie in PowerShell 7.2 und höher eine Hashtabelle exportieren, die zusätzliche Eigenschaften mit Add-Member hinzugefügt hat, oder Select-Object die zusätzlichen Eigenschaften auch als Header in der CSV-Datei hinzugefügt werden.

$allPeople | Add-Member -Name ExtraProp -Value 42 -MemberType NoteProperty
$allPeople | Export-Csv -Path .\People.csv

Get-Content -Path .\People.csv

"Name","Number","ExtraProp"
"John Smith","1","42"
"Jane Smith","2","42"

Jede Hashtabelle hat eine Eigenschaft namens von ExtraPropAdd-Member hinzugefügt und anschließend in CSV exportiert. Sie können sehen, dass ExtraProp jetzt ein Header in der CSV-Dateiausgabe ist.

Wenn eine hinzugefügte Eigenschaft denselben Namen wie ein Schlüssel aus der Hashtabelle hat, hat der Schlüssel Vorrang, und nur der Schlüssel wird in CSV exportiert.

Parameter

-Append

Verwenden Sie diesen Parameter, Export-CSV damit die CSV-Ausgabe am Ende der angegebenen Datei hinzugefügt wird. Ohne diesen Parameter Export-CSV ersetzt der Dateiinhalt ohne Warnung.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-Delimiter

Gibt ein Trennzeichen zum Trennen der Eigenschaftswerte an. Der Standardwert ist ein Komma (,). Geben Sie ein Zeichen ein, z. B. einen Doppelpunkt (:). Um ein Semikolon (;) anzugeben, schließen Sie es in Anführungszeichen ein.

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

-Encoding

Gibt die Codierung für die exportierte CSV-Datei an. Standardwert: utf8NoBOM.

Die zulässigen Werte für diesen Parameter sind wie folgt:

  • ascii: Verwendet die Codierung für den ASCII-Zeichensatz (7-Bit).
  • bigendianunicode: Codiert im UTF-16-Format mit der Big-Endian-Bytereihenfolge.
  • bigendianutf32: Codiert im UTF-32-Format mit der Big-Endian-Bytereihenfolge.
  • oem: Verwendet die Standardcodierung für MS-DOS- und Konsolenprogramme.
  • unicode: Codiert im UTF-16-Format mit der Bytereihenfolge little-endian.
  • utf7: Codiert im UTF-7-Format.
  • utf8: Codiert im UTF-8-Format.
  • utf8BOM: Codiert im UTF-8-Format mit Byte Order Mark (BOM)
  • utf8NoBOM: Codiert im UTF-8-Format ohne Byte Order Mark (BOM)
  • utf32: Codiert im UTF-32-Format.

Ab PowerShell 6.2 lässt der Codierungsparameter auch numerische IDs registrierter Codeseiten (z. B -Encoding 1251. ) oder Zeichenfolgennamen registrierter Codeseiten (z. B -Encoding "windows-1251". ) zu. Weitere Informationen finden Sie in der .NET-Dokumentation für Encoding.CodePage.

Hinweis

UTF-7* wird nicht mehr empfohlen. Ab PowerShell 7.1 wird eine Warnung geschrieben, wenn Sie für den Encoding-Parameter angebenutf7.

Type:Encoding
Accepted values:ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32
Position:Named
Default value:UTF8NoBOM
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Mit diesem Parameter können Export-Csv Dateien mit dem schreibgeschützten Attribut überschrieben werden.

Wenn die Parameter Force und Append kombiniert werden, können Objekte, die nicht übereinstimmende Eigenschaften enthalten, in eine CSV-Datei geschrieben werden. Nur die Eigenschaften, die übereinstimmen, werden in die Datei geschrieben. Die nicht übereinstimmende Eigenschaften werden verworfen.

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

-IncludeTypeInformation

Wenn dieser Parameter verwendet wird, enthält #TYPE die erste Zeile der CSV-Ausgabe den vollqualifizierten Namen des Objekttyps. Beispiel: #TYPE System.Diagnostics.Process.

Dieser Parameter wurde in PowerShell 6.0 eingeführt.

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

-InputObject

Gibt die als CSV-Zeichenfolgen zu exportierenden Objekte an. Geben Sie eine Variable ein, die die Objekte enthält, oder geben Sie einen Befehl oder einen Ausdruck ein, durch den die Objekte abgerufen werden. Sie können objekte auch an pipen Export-CSV.

Type:PSObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-LiteralPath

Gibt den Pfad zur CSV-Ausgabedatei an. Im Gegensatz zu Path wird der Wert des LiteralPath-Parameters genauso verwendet, wie er eingegeben wurde. Es werden keine Zeichen als Platzhalter interpretiert. Wenn der Pfad Escapezeichen enthält, verwenden Sie einzelne Anführungszeichen. Einzelne Anführungszeichen weisen PowerShell an, keine Zeichen als Escapesequenzen zu interpretieren.

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

-NoClobber

Verwenden Sie diesen Parameter, Export-CSV damit eine vorhandene Datei nicht überschrieben wird. Wenn die Datei im angegebenen Pfad vorhanden ist, Export-CSV wird die Datei standardmäßig ohne Warnung überschrieben.

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

-NoTypeInformation

Entfernt den #TYPE Informationsheader aus der Ausgabe. Dieser Parameter wurde zur Standardeinstellung in PowerShell 6.0 und ist aus Gründen der Abwärtskompatibilität enthalten.

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

-Path

Ein erforderlicher Parameter, der den Speicherort angibt, an dem die CSV-Ausgabedatei gespeichert werden soll.

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

-QuoteFields

Gibt die Namen der Spalten an, die in Anführungszeichen gesetzt werden sollen. Wenn dieser Parameter verwendet wird, werden nur die angegebenen Spalten in Anführungszeichen gesetzt. Dieser Parameter wurde in PowerShell 7.0 hinzugefügt.

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

-UseCulture

Verwendet das Listentrennzeichen für die aktuelle Kultur als Elementtrennzeichen. Verwenden Sie den folgenden Befehl, um das Listentrennzeichen für eine Kultur zu suchen: (Get-Culture).TextInfo.ListSeparator.

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

-UseQuotes

Gibt an, wann Anführungszeichen in den CSV-Dateien verwendet werden. Mögliche Werte:

  • Nie - nichts zitieren
  • Immer – Anführungszeichen (Standardverhalten)
  • AsNeeded: Nur Anführungszeichenfelder, die ein Trennzeichen, ein doppeltes Anführungszeichen oder zeilenumbruchiges Zeichen enthalten

Dieser Parameter wurde in PowerShell 7.0 hinzugefügt.

Type:Microsoft.PowerShell.Commands.BaseCsvWritingCommand+QuoteKind
Aliases:UQ
Position:Named
Default value:Always
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Verhindert, dass das Cmdlet verarbeitet wird oder Änderungen vornimmt. Die Ausgabe zeigt, was passieren würde, wenn das Cmdlet ausgeführt würde.

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

Eingaben

PSObject

Sie können jedes Objekt mit einem ETS-Adapter (Extended Type System) an dieses Cmdlet weiterleiten.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

PowerShell enthält die folgenden Aliase für Export-Csv:

  • Alle Plattformen:
    • epcsv

Das Export-CSV Cmdlet konvertiert die von Ihnen übermittelten Objekte in eine Reihe von CSV-Zeichenfolgen und speichert sie in der angegebenen Textdatei. Sie können verwenden Export-CSV -IncludeTypeInformation , um Objekte in einer CSV-Datei zu speichern und dann mit dem Import-Csv Cmdlet Objekte aus dem Text in der CSV-Datei zu erstellen.

In der CSV-Datei wird jedes Objekt durch eine durch Zeichen getrennte Liste der Eigenschaftswerte des Objekts dargestellt. Die Eigenschaftswerte werden mithilfe der ToString() -Methode in Zeichenfolgen konvertiert. Die Zeichenfolgen werden durch den Eigenschaftenwertnamen dargestellt. Export-CSV -IncludeTypeInformation exportiert die Methoden des -Objekts nicht.

Die CSV-Zeichenfolgen werden wie folgt ausgegeben:

  • Wenn IncludeTypeInformation verwendet wird, enthält die erste Zeichenfolge den #TYPE Informationsheader gefolgt vom vollqualifizierten Namen des Objekttyps. Beispielsweise #TYPE System.Diagnostics.Process.
  • Wenn IncludeTypeInformation nicht verwendet wird, enthält die erste Zeichenfolge die Spaltenheader. Die Header enthalten die Eigenschaftennamen des ersten Objekts als durch Zeichen getrennte Liste.
  • Die restlichen Zeichenfolgen enthalten durch Zeichen getrennte Listen der Eigenschaftenwerte jedes Objekts.

Ab PowerShell 6.0 besteht das Standardverhalten von Export-CSV darin, die #TYPE Informationen nicht in die CSV-Datei einzuschließen, und NoTypeInformation ist impliziert. IncludeTypeInformation kann verwendet werden, um die #TYPE Informationen einzuschließen und das Standardverhalten von Export-CSV vor PowerShell 6.0 zu emulieren.

Wenn Sie mehrere Objekte an Export-CSVübermitteln, Export-CSV wird die Datei basierend auf den Eigenschaften des ersten Von Ihnen übermittelten Objekts organisiert. Wenn die übrigen Objekte nicht über eine der angegebenen Eigenschaften verfügen, ist der Eigenschaftswert dieses Objekts NULL, was durch zwei aufeinander folgende Kommas dargestellt wird. Wenn die übrigen Objekte zusätzliche Eigenschaften aufweisen, sind diese Eigenschaftenwerte nicht in der Datei enthalten.

Sie können das Import-Csv Cmdlet verwenden, um Objekte aus den CSV-Zeichenfolgen in den Dateien neu zu erstellen. Die resultierenden Objekte sind CSV-Versionen der ursprünglichen Objekte, die aus den Zeichenfolgendarstellungen der Eigenschaftswerte bestehen und die keine Methoden haben.

Die ConvertTo-Csv Cmdlets und ConvertFrom-Csv konvertieren Objekte in CSV-Zeichenfolgen und aus CSV-Zeichenfolgen. Export-CSV ist identisch mit ConvertTo-CSV, mit dem Unterschied, dass die CSV-Zeichenfolgen in einer Datei gespeichert werden.