Export-Csv
Wandelt Objekte in eine Reihe von kommatrennten Wertzeichenfolgen (CSV) um 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]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Export-Csv
-InputObject <PSObject>
[[-Path] <String>]
[-LiteralPath <String>]
[-Force]
[-NoClobber]
[-Encoding <Encoding>]
[-Append]
[-UseCulture]
[-IncludeTypeInformation]
[-NoTypeInformation]
[-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 Kommas getrennte Liste der Eigenschaftswerte des Objekts enthält. Mit dem Export-CSV
Cmdlet können Sie Tabellenkalkulationen erstellen und Daten für Programme freigeben, 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 werden, enthält die CSV-Datei die Formateigenschaften anstelle der 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 Prozessobjekte mit bestimmten Eigenschaften ausgewählt, die Objekte werden 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, um nur die WmiPrvSE-Prozessobjekte einzuschließen. Die Prozessobjekte werden an das Select-Object
Cmdlet gesendet. Select-Object
verwendet den Eigenschaftsparameter , um eine Teilmenge von Prozessobjekteigenschaften auszuwählen. Die Prozessobjekte werden an das Export-Csv
Cmdlet gesendet. Export-Csv
konvertiert die Prozessobjekte in eine Reihe von CSV-Zeichenfolgen. Der Parameter Path 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 Parameter "Path ", um die Datei im aktuellen Verzeichnis anzuzeigen.
Beispiel 2: Exportieren von Prozessen in eine durch Trennzeichen getrennte Datei
In diesem Beispiel werden Process-Objekte aufgerufen 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 an das Export-Csv
Cmdlet gesendet. Export-Csv
konvertiert die Prozessobjekte in eine Reihe von CSV-Zeichenfolgen.
Der Parameter Path 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 Parameter "Path ", um die Datei im aktuellen Verzeichnis anzuzeigen.
Beispiel 3: Exportieren von Prozessen in eine durch Semikolon getrennte Datei
In diesem Beispiel werden Process-Objekte und exportiert die Objekte in eine Datei mit einem Semikolontrennzeichen.
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 an das Export-Csv
Cmdlet gesendet. Export-Csv
konvertiert die Prozessobjekte in eine Reihe von CSV-Zeichenfolgen.
Der Parameter Path 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 Parameter "Path ", um die Datei im aktuellen Verzeichnis anzuzeigen.
Beispiel 4: Exportieren von Prozessen mithilfe des Listentrennzeichens der aktuellen Kultur
In diesem Beispiel werden Process-Objekte angezeigt 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 an das Export-Csv
Cmdlet gesendet. Export-Csv
konvertiert die Prozessobjekte in eine Reihe von CSV-Zeichenfolgen. Der Parameter Path 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 Parameter "Path ", um die Datei im aktuellen Verzeichnis anzuzeigen.
Beispiel 5: Exportieren von Prozessen mit Typinformationen
In diesem Beispiel wird erläutert, wie die #TYPE Kopfzeileninformationen in eine CSV-Datei eingeschlossen werden. Der #TYPE-Header ist die Standardversion 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 an das Export-Csv
Cmdlet gesendet. Export-Csv
konvertiert die Prozessobjekte in eine Reihe von CSV-Zeichenfolgen.
Der Parameter Path gibt an, dass die Processes.csv-Datei im aktuellen Verzeichnis gespeichert wird. Die IncludeTypeInformation enthält den #TYPE Informationsheader in der CSV-Ausgabe. Das Get-Content
Cmdlet verwendet den Parameter "Path ", 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 "Anwendung" enthalten. Die Dienstobjekte werden an das Select-Object
Cmdlet gesendet. Select-Object
verwendet den Parameter "Property ", um die Eigenschaften "DisplayName " und "Status " anzugeben. Die $AppService
Variable speichert die Objekte.
Die $AppService
Objekte werden an das Export-Csv
Cmdlet gesendet. Export-Csv
konvertiert die Dienstobjekte in eine Reihe von CSV-Zeichenfolgen. Der Parameter Path 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 Parameter "Path ", um die Datei im aktuellen Verzeichnis anzuzeigen.
Die Get-Service
Und Select-Object
Cmdlets 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: Cmdlet formatieren in einer Pipeline erstellt unerwartete Ergebnisse
In diesem Beispiel wird gezeigt, warum es wichtig ist, kein Format-Cmdlet in einer Pipeline zu verwenden. Wenn unerwartete Ausgabe empfangen wird, behandeln 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 an das Select-Object
Cmdlet gesendet. Select-Object
verwendet den Eigenschaftsparameter , um eine Teilmenge von Objekteigenschaften auszuwählen. Das Objekt wird an das Export-Csv
Cmdlet gesendet. Export-Csv
konvertiert das Objekt in ein CSV-Format. Der Parameter Path 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 Pfadparameter , um die CSV-Datei im aktuellen Verzeichnis anzuzeigen.
Wenn das Format-Table
Cmdlet in der Pipeline verwendet wird, um unerwartete Ergebnisse auszuwählen, werden unerwartete Ergebnisse empfangen. Format-Table
sendet Tabellenformatobjekte 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 zum Aktualisieren der Datei verwendet.
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 " Wert ", um die IsReadOnly-Eigenschaft der Datei in "true" zu ändern. Das Get-Process
Cmdlet ruft Process-Objekte ab. Die Prozessobjekte werden an das Export-Csv
Cmdlet gesendet. Export-Csv
konvertiert die Prozessobjekte in eine Reihe von CSV-Zeichenfolgen. Der Parameter Path 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 Parameter Force wird dem Export-Csv
Cmdlet hinzugefügt, um zu erzwingen, dass der Export in die Datei geschrieben wird. Das Get-Content
Cmdlet verwendet den Parameter "Path ", um die Datei im aktuellen Verzeichnis anzuzeigen.
Beispiel 9: Verwenden des Force-Parameters mit Append
In diesem Beispiel wird gezeigt, wie Sie die Parameter "Force " und " Anfügen " verwenden. Wenn diese Parameter kombiniert werden, können falsch übereinstimmende Objekteigenschaften in eine CSV-Datei geschrieben werden.
$Content = [PSCustomObject]@{Name = 'PowerShell Core'; Version = '6.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 Core 6.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 Pfadparameter 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 weiterer 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 Parameter "Append " wird verwendet, um die Daten zur Datei hinzuzufügen. Das Anfügen schlägt fehl, da zwischen Version und Edition ein Eigenschaftsname fehlschlägt.
Der Export-Csv
Cmdlet Force-Parameter wird verwendet, um den Export zum Schreiben in die Datei zu erzwingen. Die Edition-Eigenschaft wird verworfen. Das Import-Csv
Cmdlet verwendet den Pfadparameter , um die Datei im aktuellen Verzeichnis anzuzeigen.
Parameter
-Append
Verwenden Sie diesen Parameter, Export-CSV
sodass 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: | None |
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. Die Standardeinstellung 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- Zeichensatz).bigendianunicode
: Codiert im UTF-16-Format mithilfe der Groß-End-Bytereihenfolge.oem
: Verwendet die Standardcodierung für MS-DOS- und Konsolenprogramme.unicode
: Codiert im UTF-16-Format mithilfe der Klein-Endian-Bytereihenfolge.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 ermöglicht der Codierungsparameter auch numerische IDs von registrierten Codeseiten (z. B. ) oder Zeichenfolgennamen registrierter Codeseiten (wie -Encoding 1251
z -Encoding "windows-1251"
. B. ). Weitere Informationen finden Sie in der .NET-Dokumentation für Encoding.CodePage.
Type: | Encoding |
Accepted values: | ASCII, BigEndianUnicode, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32 |
Position: | Named |
Default value: | UTF8NoBOM |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Dieser Parameter ermöglicht Export-Csv
das Überschreiben von Dateien mit dem Read Only-Attribut .
Wenn Force- und Append-Parameter kombiniert werden, können Objekte, die übereinstimmende Eigenschaften enthalten, in eine CSV-Datei geschrieben werden. Nur die Eigenschaften, die mit der Datei übereinstimmen, werden in die Datei geschrieben. Die übereinstimmende Eigenschaften werden verworfen.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeTypeInformation
Wenn dieser Parameter verwendet wird, enthält die erste Zeile der CSV-Ausgabe #TYPE gefolgt vom vollqualifizierten Namen des Objekttyps. Beispielsweise #TYPE System.Diagnostics.Process.
Dieser Parameter wurde in PowerShell 6.0 eingeführt.
Type: | SwitchParameter |
Aliases: | ITI |
Position: | Named |
Default value: | #TYPE <Object> |
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 auch Objekte 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 darauf hin, 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 standardmäßig im angegebenen Pfad vorhanden ist, Export-CSV
überschreibt die Datei ohne Warnung.
Type: | SwitchParameter |
Aliases: | NoOverwrite |
Position: | Named |
Default value: | None |
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 für die Abwärtskompatibilität enthalten.
Type: | SwitchParameter |
Aliases: | NTI |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Ein erforderlicher Parameter, der den Speicherort angibt, um die CSV-Ausgabedatei zu speichern.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseCulture
Verwendet das Listentrennzeichen für die aktuelle Kultur als Elementdelimiter. Um das Listentrennzeichen für eine Kultur zu finden, verwenden Sie den folgenden Befehl: (Get-Culture).TextInfo.ListSeparator
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Verhindert, dass das Cmdlet verarbeitet oder Änderungen vorgenommen wird. Die Ausgabe zeigt, was geschieht, wenn das Cmdlet ausgeführt wurde.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Sie können ein beliebiges Objekt mit einem Extended Type System (ETS)-Adapter an Export-CSV
.
Ausgaben
Die CSV-Liste wird an die im Path-Parameter festgelegte Datei gesendet.
Hinweise
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 Export-CSV -IncludeTypeInformation
Objekte in einer CSV-Datei speichern und dann das Import-Csv
Cmdlet verwenden, um Objekte aus dem Text in der CSV-Datei zu erstellen.
In der CSV-Datei wird jedes Objekt durch eine durch Trennzeichen getrennte Liste der Eigenschaftswerte des Objekts dargestellt. Die Eigenschaftenwerte 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 Spaltenüberschriften. Die Kopfzeilen enthalten die Eigenschaftennamen des ersten Objekts als kommatrennte Liste.
- Die verbleibenden Zeichenfolgen enthalten kommatrennte Listen der Eigenschaftenwerte jedes Objekts.
Ab PowerShell 6.0 ist das Standardverhalten Export-CSV
nicht enthalten, dass die #TYPE Informationen in die CSV- und NoTypeInformation einbezogen werden. IncludeTypeInformation kann verwendet werden, um die #TYPE Informationen einzuschließen und das Standardverhalten vor Export-CSV
PowerShell 6.0 zu emulieren.
Wenn Sie mehrere Objekte Export-CSV
an senden, Export-CSV
organisiert die Datei basierend auf den Eigenschaften des ersten Objekts, das Sie übermitteln. 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 und ConvertFrom-Csv
Cmdlets ConvertTo-Csv
konvertieren Objekte in CSV-Zeichenfolgen und aus CSV-Zeichenfolgen. Export-CSV
ist identisch mit ConvertTo-CSV
, außer dass die CSV-Zeichenfolgen in einer Datei gespeichert werden.