Freigeben über

ConvertTo-Csv

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Konvertiert .NET-Objekte in eine Reihe von zeichentrennten Zeichenfolgen (CSV).

Syntax

ConvertTo-Csv
              [-InputObject] <psobject>
              [[-Delimiter] <char>]
              [-NoTypeInformation]
              [<CommonParameters>]
ConvertTo-Csv
              [-InputObject] <psobject>
              [-UseCulture]
              [-NoTypeInformation]
              [<CommonParameters>]

Beschreibung

Das ConvertTo-CSV Cmdlet gibt eine Reihe von CSV-Zeichenfolgen (Character Separated Value) zurück, die die von Ihnen übermittelten Objekte darstellen. Anschließend können Sie mithilfe des ConvertFrom-Csv Cmdlets Objekte aus den CSV-Zeichenfolgen neu erstellen. Die aus CSV konvertierten Objekte sind Zeichenfolgenwerte der ursprünglichen Objekte, die Eigenschaftswerte und keine Methoden enthalten.

Sie können das Export-Csv Cmdlet verwenden, um Objekte in CSV-Zeichenfolgen zu konvertieren. Export-CSVConvertTo-CSVähnelt , mit der Ausnahme, dass die CSV-Zeichenfolgen in einer Datei gespeichert werden.

Das ConvertTo-CSV Cmdlet weist Parameter auf, um ein anderes Trennzeichen als ein Komma anzugeben oder die aktuelle Kultur als Trennzeichen zu verwenden.

Beispiele

Beispiel 1: Konvertieren eines Objekts in CSV

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

Get-Process -Name 'PowerShell' | ConvertTo-Csv -NoTypeInformation

"Name","SI","Handles","VM","WS","PM","NPM","Path","Company","CPU","FileVersion", ...
"powershell","11","691","2204036739072","175943680","132665344","33312", ...

Das Get-Process Cmdlet ruft das Process-Objekt ab und verwendet den Parameter Name , um den PowerShell-Prozess anzugeben. Das Prozessobjekt wird an das ConvertTo-CSV Cmdlet gesendet. Das ConvertTo-CSV Cmdlet konvertiert das Objekt in CSV-Zeichenfolgen. Der Parameter NoTypeInformation entfernt den #TYPE Informationsheader aus der CSV-Ausgabe.

Beispiel 2: Konvertieren eines DateTime-Objekts in CSV

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

$Date = Get-Date
ConvertTo-Csv -InputObject $Date -Delimiter ';' -NoTypeInformation

"DisplayHint";"DateTime";"Date";"Day";"DayOfWeek";"DayOfYear";"Hour";"Kind";"Millisecond";"Minute";"Month";"Second";"Ticks";"TimeOfDay";"Year"
"DateTime";"Friday, January 4, 2019 14:40:51";"1/4/2019 00:00:00";"4";"Friday";"4";"14";"Local";"711";"40";"1";"51";"636822096517114991";"14:40:51.7114991";"2019"

Das Get-Date Cmdlet ruft das DateTime-Objekt ab und speichert es in der $Date Variablen. Das ConvertTo-Csv Cmdlet konvertiert das DateTime-Objekt in Zeichenfolgen. Der InputObject-Parameter verwendet das dateTime-Objekt, das in der $Date Variablen gespeichert ist. Der Parameter Delimiter gibt ein Semikolon an, um die Zeichenfolgenwerte zu trennen. Der Parameter NoTypeInformation entfernt den #TYPE Informationsheader aus der CSV-Ausgabe.

Beispiel 3: Konvertieren des PowerShell-Ereignisprotokolls in CSV

In diesem Beispiel wird das Windows-Ereignisprotokoll für PowerShell in eine Reihe von CSV-Zeichenfolgen konvertiert.

(Get-Culture).TextInfo.ListSeparator
Get-WinEvent -LogName 'Windows PowerShell' | ConvertTo-Csv -UseCulture -NoTypeInformation

,
"Message","Id","Version","Qualifiers","Level","Task","Opcode","Keywords","RecordId", ...
"Error Message = System error","403",,"0","4","4",,"36028797018963968","46891","PowerShell", ...

Das Get-Culture Cmdlet verwendet die geschachtelten Eigenschaften TextInfo und ListSeparator und zeigt das Standardlistentrennzeichen der aktuellen Kultur an. Das Get-WinEvent Cmdlet ruft die Ereignisprotokollobjekte ab und verwendet den LogName-Parameter , um den Namen der Protokolldatei anzugeben. Die Ereignisprotokollobjekte werden an das ConvertTo-Csv Cmdlet gesendet. Das ConvertTo-Csv Cmdlet konvertiert die Ereignisprotokollobjekte in eine Reihe von CSV-Zeichenfolgen. Der UseCulture-Parameter verwendet das Standardlistentrennzeichen der aktuellen Kultur als Trennzeichen. Der Parameter NoTypeInformation entfernt den #TYPE Informationsheader aus der CSV-Ausgabe.

Parameter

-Delimiter

Gibt das Trennzeichen an, um die Eigenschaftswerte in CSV-Zeichenfolgen zu trennen. Der Standardwert ist ein Komma (,). Geben Sie ein Zeichen ein, z. B. einen Doppelpunkt (:). Um ein Semikolon (;) anzugeben, schließen Sie es in einfache Anführungszeichen ein.

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

-InputObject

Gibt die Objekte an, die in CSV-Zeichenfolgen konvertiert werden. 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 ConvertTo-CSV.

Type:PSObject
Position:0
Default value:None
Required:True
Accept pipeline input:True
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

-UseCulture

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

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

Eingaben

PSObject

Sie können jedes Objekt, das über einen ETS-Adapter (Extended Type System) verfügt, an dieses Cmdlet weiterleiten.

Ausgaben

String

Dieses Cmdlet gibt eine oder mehrere Zeichenfolgen zurück, die jedes konvertierte Objekt darstellen.

Hinweise

Im CSV-Format wird jedes Objekt durch eine durch Zeichen getrennte Liste seines Eigenschaftswerts dargestellt. Die Eigenschaftswerte werden mithilfe der ToString()-Methode des Objekts in Zeichenfolgen konvertiert. Die Zeichenfolgen werden durch den Eigenschaftswertnamen dargestellt. ConvertTo-CSV exportiert die Methoden des Objekts nicht.

Die CSV-Zeichenfolgen werden wie folgt ausgegeben:

  • Standardmäßig enthält die erste Zeichenfolge den #TYPE Informationsheader gefolgt vom vollqualifizierten Namen des Objekttyps. Beispiel: #TYPE System.Diagnostics.Process.
  • Wenn NoTypeInformation verwendet wird, enthält die erste Zeichenfolge die Spaltenüberschriften. Die Kopfzeilen enthalten die Eigenschaftennamen des ersten Objekts als durch Trennzeichen getrennte Liste.
  • Die neu Standard Zeichenfolgen enthalten durch Kommas getrennte Listen der Eigenschaftswerte jedes Objekts.

Wenn Sie mehrere Objekte ConvertTo-CSVübermitteln, ConvertTo-CSV werden die Zeichenfolgen basierend auf den Eigenschaften des ersten objekts sortiert, das Sie übermitteln. Wenn die neu Standard Objekte keine der angegebenen Eigenschaften aufweisen, ist der Eigenschaftswert dieses Objekts Null, wie durch zwei aufeinander folgende Kommas dargestellt. Wenn die übrigen Objekte zusätzliche Eigenschaften aufweisen, werden diese Eigenschaftswerte ignoriert.