ConvertFrom-Csv

ConvertFrom-Csv
    [-InputObject] <psobject[]>
    [[-Delimiter] <char>]
    [-Header <string[]>]
    [<CommonParameters>]

ConvertFrom-Csv
    [-InputObject] <psobject[]>
    -UseCulture
    [-Header <string[]>]
    [<CommonParameters>]

Das ConvertFrom-Csv Cmdlet erstellt Objekte aus CSV-Zeichenfolgen mit variabler Länge, die vom ConvertTo-Csv Cmdlet generiert werden.

Sie können die Parameter dieses Cmdlets verwenden, um die Spaltenüberschriftszeile anzugeben, die die Eigenschaftsnamen der resultierenden Objekte bestimmt, um das Elementtrennzeichen anzugeben oder um dieses Cmdlet anzuweisen, das Listentrennzeichen für die aktuelle Kultur als Trennzeichen zu verwenden.

Bei den Objekten, die erstellt werden, ConvertFrom-Csv handelt es sich um CSV-Versionen der ursprünglichen Objekte. Die Eigenschaftswerte der CSV-Objekte sind Zeichenfolgenversionen der Eigenschaftswerte der ursprünglichen Objekte. Die CSV-Versionen der Objekte verfügen über keine Methoden.

Sie können auch die Export-Csv Cmdlets und Import-Csv verwenden, um Objekte in CSV-Zeichenfolgen in einer Datei (und zurück) zu konvertieren. Diese Cmdlets sind mit dem ConvertTo-Csv und ConvertFrom-Csv Cmdlets identisch, mit der Ausnahme, dass sie die CSV-Zeichenfolgen in einer Datei speichern.

In diesem Beispiel wird gezeigt, wie die Prozesse auf dem lokalen Computer in das CSV-Format konvertiert und dann im Objektformular wiederhergestellt werden.

$P = Get-Process | ConvertTo-Csv
$P | ConvertFrom-Csv

Das Cmdlet Get-Process sendet die Prozesse an ConvertTo-Csv. Das Cmdlet ConvertTo-Csv konvertiert die Prozessobjekte in eine Reihe von CSV-Zeichenfolgen. Das Cmdlet ConvertFrom-Csv konvertiert die CSV-Zeichenfolgen in CSV-Versionen der ursprünglichen Prozessobjekte. Die CSV-Zeichenfolgen werden in der variablen $P gespeichert.

In diesem Beispiel wird gezeigt, wie ein Datenobjekt in das CSV-Format und dann in das CSV-Objektformat konvertiert wird.

$Date = Get-Date | ConvertTo-Csv -Delimiter ';'
ConvertFrom-Csv -InputObject $Date -Delimiter ';'

Der erste Befehl verwendet Get-Date, um das aktuelle Datum und die aktuelle Uhrzeit der Pipeline an ConvertTo-Csvzu senden. Das Cmdlet ConvertTo-Csv konvertiert das Datumsobjekt in eine Reihe von CSV-Zeichenfolgen. Der parameter Delimiter wird verwendet, um ein Semikolontrennzeichen anzugeben. Die Zeichenfolgen werden in der variablen $Date gespeichert.

In diesem Beispiel wird gezeigt, wie Sie den parameter Header von ConvertFrom-Csv verwenden, um die Namen der Eigenschaften im resultierenden importierten Objekt zu ändern.

$J = Start-Job -ScriptBlock { Get-Process } | ConvertTo-Csv  -NoTypeInformation
$Header = 'State', 'MoreData', 'StatusMessage', 'Location', 'Command', 'StateInfo', 'Finished', 'InstanceId', 'Id', 'Name', 'ChildJobs', 'BeginTime', 'EndTime', 'JobType', 'Output', 'Error', 'Progress', 'Verbose', 'Debug', 'Warning', 'Information'
# Delete the default header from $J
$J = $J[1..($J.count - 1)]
$J | ConvertFrom-Csv -Header $Header

State         : Running
MoreData      : True
StatusMessage :
Location      : localhost
Command       : Get-Process
StateInfo     : Running
Finished      : System.Threading.ManualResetEvent
InstanceId    : a259eb63-6824-4b97-a033-305108ae1c2e
Id            : 1
Name          : Job1
ChildJobs     : System.Collections.Generic.List`1[System.Management.Automation.Job]
BeginTime     : 12/20/2018 18:59:57
EndTime       :
JobType       : BackgroundJob
Output        : System.Management.Automation.PSDataCollection`1[System.Management.Automation.PSObject]
Error         : System.Management.Automation.PSDataCollection`1[System.Management.Automation.ErrorRecord]
Progress      : System.Management.Automation.PSDataCollection`1[System.Management.Automation.ProgressRecord]
Verbose       : System.Management.Automation.PSDataCollection`1[System.Management.Automation.VerboseRecord]
Debug         : System.Management.Automation.PSDataCollection`1[System.Management.Automation.DebugRecord]
Warning       : System.Management.Automation.PSDataCollection`1[System.Management.Automation.WarningRecord]
Information   : System.Management.Automation.PSDataCollection`1[System.Management.Automation.InformationRecord]

Das Cmdlet Start-Job startet einen Hintergrundauftrag, der Get-Processausgeführt wird. Ein Auftragsobjekt wird an ConvertTo-Csv die Pipeline gesendet und in eine CSV-Zeichenfolge konvertiert. Der NoTypeInformation-Parameter entfernt den Typinformationsheader aus der CSV-Ausgabe und ist in PowerShell Core optional. Die $Header Variable enthält einen benutzerdefinierten Header, der die folgenden Standardwerte ersetzt: HasMoreData, JobStateInfo, PSBeginTime, PSEndTime, und PSJobTypeName. Die $J Variable enthält die CSV-Zeichenfolge und wird verwendet, um den Standardheader zu entfernen. Das cmdlet ConvertFrom-Csv konvertiert die CSV-Zeichenfolge in eine PSCustomObject- und verwendet den parameter Header, um die variable $Header anzuwenden.

In diesem Beispiel wird gezeigt, wie Sie das cmdlet ConvertFrom-Csv mit dem Parameter UseCulture verwenden.

(Get-Culture).TextInfo.ListSeparator
$Services = (Get-Service | ConvertTo-Csv)
ConvertFrom-Csv -InputObject $Services -UseCulture

Das cmdlet Get-Culture verwendet die geschachtelten Eigenschaften TextInfo- und ListSeparator-, um das Standardlistentrennzeichen der aktuellen Kultur abzurufen. Das Cmdlet Get-Service sendet Dienstobjekte an ConvertTo-Csv. Die ConvertTo-Csv konvertiert die Dienstobjekte in eine Reihe von CSV-Zeichenfolgen. Die CSV-Zeichenfolgen werden in der variablen $Services gespeichert. Das cmdlet ConvertFrom-Csv verwendet den parameter InputObject und konvertiert die CSV-Zeichenfolgen aus der variablen $Services. Der parameter UseCulture verwendet das Standardlistentrennzeichen der aktuellen Kultur.

Wenn der UseCulture-Parameter verwendet wird, stellen Sie sicher, dass das Standardlistentrennzeichen der aktuellen Kultur dem in den CSV-Zeichenfolgen verwendeten Trennzeichen entspricht. Andernfalls ConvertFrom-Csv können keine Objekte aus den CSV-Zeichenfolgen generiert werden.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Sie können CSV-Zeichenfolgen an dieses Cmdlet weiterleiten.

Dieses Cmdlet gibt die von den Eigenschaften in den CSV-Zeichenfolgen beschriebenen Objekte zurück.

Da es sich bei den importierten Objekten um CSV-Versionen des Objekttyps handelt, werden sie von den PowerShell-Typformatierungseinträgen, die die Nicht-CSV-Versionen des Objekttyps formatieren, nicht erkannt und formatiert.

Im CSV-Format wird jedes Objekt durch eine durch Kommas getrennte Liste der Eigenschaftswerte des Objekts dargestellt. Die Eigenschaftswerte werden in Zeichenfolgen konvertiert (unter Verwendung der ToString()- Methode des Objekts), sodass sie durch den Namen des Eigenschaftswerts dargestellt werden. Mit diesem Cmdlet werden die Methoden des Objekts nicht exportiert.