Freigeben über

Import-Csv

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Erstellt tabellenähnliche benutzerdefinierte Objekte aus den Elementen in einer CSV-Datei (Character-Separated Value).

Syntax

Import-Csv
      [[-Path] <string[]>]
      [[-Delimiter] <char>]
      [-LiteralPath <string[]>]
      [-Header <string[]>]
      [-Encoding <string>]
      [<CommonParameters>]
Import-Csv
      [[-Path] <string[]>]
      -UseCulture
      [-LiteralPath <string[]>]
      [-Header <string[]>]
      [-Encoding <string>]
      [<CommonParameters>]

Beschreibung

Das Import-Csv Cmdlet erstellt tabellenähnliche benutzerdefinierte Objekte aus den Elementen in CSV-Dateien. Jede Spalte in der CSV-Datei wird zu einer Eigenschaft des benutzerdefinierten Objekts, und die Elemente in den Zeilen werden zu Eigenschaftswerten. Import-Csv funktioniert für jede CSV-Datei, einschließlich Dateien, die vom Export-Csv Cmdlet generiert werden.

Sie können die Parameter des Import-Csv Cmdlets verwenden, um die Spaltenkopfzeile und das Elementtrennzeichen anzugeben, oder direkt Import-Csv , um das Listentrennzeichen für die aktuelle Kultur als Elementtrennzeichen zu verwenden.

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

Wenn ein Zeileneintrag in einer CSV-Datei einen leeren oder NULL-Wert enthält, fügt PowerShell einen Standardnamen für überschriftenzeilen ein und zeigt eine Warnmeldung an.

Import-Csv verwendet das Bytereihenfolgenzeichen (BOM), um das Codierungsformat der Datei zu erkennen. Wenn die Datei keine BOM aufweist, wird davon ausgegangen, dass die Codierung UTF8 ist.

Beispiele

Beispiel 1: Importieren von Prozessobjekten

In diesem Beispiel wird gezeigt, wie Sie eine CSV-Datei mit Prozessobjekten exportieren und dann importieren.

Get-Process | Export-Csv -Path .\Processes.csv
$P = Import-Csv -Path .\Processes.csv
$P | Get-Member

TypeName: System.Management.Automation.PSCustomObject

Name                       MemberType   Definition
----                       ----------   ----------
Equals                     Method       bool Equals(System.Object obj)
GetHashCode                Method       int GetHashCode()
GetType                    Method       type GetType()
ToString                   Method       string ToString()
BasePriority               NoteProperty string BasePriority=8
Company                    NoteProperty string Company=Microsoft Corporation
...

$P | Format-Table

Name                   SI Handles VM            WS        PM        NPM    Path
----                   -- ------- --            --        --        ---    ----
ApplicationFrameHost   4  407     2199293489152 15884288  15151104  23792  C:\WINDOWS\system32\ApplicationFrameHost.exe
...
wininit                0  157     2199112204288 4591616   1630208   10376
winlogon               4  233     2199125549056 7659520   2826240   10992  C:\WINDOWS\System32\WinLogon.exe
WinStore.App           4  846     873435136     33652736  26607616  55432  C:\Program Files\WindowsApps\Microsoft.WindowsStore_11712.1001.13.0_x64__8weky...
WmiPrvSE               0  201     2199100219392 8830976   3297280   10632  C:\WINDOWS\system32\wbem\wmiprvse.exe
WmiPrvSE               0  407     2199157727232 18509824  12922880  16624  C:\WINDOWS\system32\wbem\wmiprvse.exe
WUDFHost               0  834     2199310204928 51945472  87441408  24984  C:\Windows\System32\WUDFHost.exe

Das Get-Process Cmdlet sendet Prozessobjekte an die Export-CsvPipeline. Das Export-Csv Cmdlet konvertiert die Prozessobjekte in CSV-Zeichenfolgen und speichert die Zeichenfolgen in der datei Processes.csv. Das Import-Csv Cmdlet importiert die CSV-Zeichenfolgen aus der Processes.csv-Datei. Die Zeichenfolgen werden in der $P Variablen gespeichert. Die $P Variable wird an das Get-Member Cmdlet gesendet, das die Eigenschaften der importierten CSV-Zeichenfolgen anzeigt. Die $P Variable wird an das Format-Table Cmdlet gesendet und zeigt die Objekte an.

Beispiel 2: Angeben des Trennzeichens

In diesem Beispiel wird gezeigt, wie sie den Parameter "Delimiter " des Import-Csv Cmdlets verwenden.

Get-Process | Export-Csv -Path .\Processes.csv -Delimiter :
$P = Import-Csv -Path .\Processes.csv -Delimiter :
$P | Format-Table

Das Get-Process Cmdlet sendet Prozessobjekte nach unten an Export-Csv. Das Export-Csv Cmdlet konvertiert die Prozessobjekte in CSV-Zeichenfolgen und speichert die Zeichenfolgen in der datei Processes.csv. Der Parameter "Delimiter " wird verwendet, um ein Doppelpunkttrennzeichen anzugeben. Das Import-Csv Cmdlet importiert die CSV-Zeichenfolgen aus der Processes.csv-Datei. Die Zeichenfolgen werden in der $P Variablen gespeichert. Zur $P Variablen wird die Pipeline an das Format-Table Cmdlet gesendet.

Beispiel 3: Angeben der aktuellen Kultur für das Trennzeichen

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

(Get-Culture).TextInfo.ListSeparator
Get-Process | Export-Csv -Path .\Processes.csv -UseCulture
Import-Csv -Path .\Processes.csv -UseCulture

Das Get-Culture Cmdlet verwendet die geschachtelten Eigenschaften TextInfo und ListSeparator , um das Standardlistentrennzeichen der aktuellen Kultur abzurufen. Das Get-Process Cmdlet sendet Prozessobjekte nach unten an Export-Csv. Das Export-Csv Cmdlet konvertiert die Prozessobjekte in CSV-Zeichenfolgen und speichert die Zeichenfolgen in der datei Processes.csv. Der UseCulture-Parameter verwendet das Standardlistentrennzeichen der aktuellen Kultur. Das Import-Csv Cmdlet importiert die CSV-Zeichenfolgen aus der Processes.csv-Datei.

Beispiel 4: Ändern von Eigenschaftsnamen in einem importierten Objekt

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

Start-Job -ScriptBlock { Get-Process } | Export-Csv -Path .\Jobs.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 file
$A = Get-Content -Path .\Jobs.csv
$A = $A[1..($A.Count - 1)]
$A | Out-File -FilePath .\Jobs.csv
$J = Import-Csv -Path .\Jobs.csv -Header $Header
$J

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 Start-Job Cmdlet startet einen Hintergrundauftrag, der ausgeführt wird Get-Process. Ein Auftragsobjekt wird an das Export-Csv Cmdlet gesendet und in eine CSV-Zeichenfolge konvertiert. Der Parameter NoTypeInformation entfernt den Typinformationsheader aus der CSV-Ausgabe und ist in PowerShell v6 und höher optional. Die $Header Variable enthält einen benutzerdefinierten Header, der die folgenden Standardwerte ersetzt: HasMoreData, JobStateInfo, PSBeginTime, PSEndTime und PSJobTypeName. Die $A Variable verwendet das Get-Content Cmdlet, um die CSV-Zeichenfolge aus der datei Jobs.csv abzurufen. Die $A Variable wird verwendet, um den Standardheader aus der Datei zu entfernen. Das Out-File Cmdlet speichert die neue Version der Jobs.csv Datei in der $A Variablen. Das Import-Csv Cmdlet importiert die Jobs.csv-Datei und verwendet den Header-Parameter , um die $Header Variable anzuwenden. Die $J Variable enthält das importierte PSCustomObject und zeigt das Objekt in der PowerShell-Konsole an.

Beispiel 5: Erstellen eines benutzerdefinierten Objekts mithilfe einer CSV-Datei

In diesem Beispiel wird gezeigt, wie Sie ein benutzerdefiniertes Objekt in PowerShell mithilfe einer CSV-Datei erstellen.

Get-Content -Path .\Links.csv

113207,about_Aliases
113208,about_Arithmetic_Operators
113209,about_Arrays
113210,about_Assignment_Operators
113212,about_Automatic_Variables
113213,about_Break
113214,about_Command_Precedence
113215,about_Command_Syntax
144309,about_Comment_Based_Help
113216,about_CommonParameters
113217,about_Comparison_Operators
113218,about_Continue
113219,about_Core_Commands
113220,about_Data_Section

$A = Import-Csv -Path .\Links.csv -Header 'LinkID', 'TopicTitle'
$A | Get-Member

TypeName: System.Management.Automation.PSCustomObject

Name        MemberType   Definition
----        ----------   ----------
Equals      Method       bool Equals(System.Object obj)
GetHashCode Method       int GetHashCode()
GetType     Method       type GetType()
ToString    Method       string ToString()
LinkID      NoteProperty string LinkID=113207
TopicTitle  NoteProperty string TopicTitle=about_Aliases

$A | Where-Object -Property TopicTitle -Like '*alias*'

LinkID TopicTitle
------ ----------
113207 about_Aliases

Verwenden Sie die in der Get-Content Ausgabe angezeigten Werte, um ihre Links.csv Datei zu erstellen.

Das Get-Content Cmdlet zeigt die Links.csv Datei an. Das Import-Csv Cmdlet importiert die Links.csv Datei. Der Header-Parameter gibt die Eigenschaftennamen LinkId und TopicTitle an. Die Objekte werden in der $A Variablen gespeichert. Das Get-Member Cmdlet zeigt die Eigenschaftennamen aus dem Header-Parameter an. Das Where-Object Cmdlet wählt Objekte mit der TopicTitle-Eigenschaft aus, die Alias enthält.

Beispiel 6: Importieren einer CSV,die einen Wert fehlt

In diesem Beispiel wird gezeigt, wie das Import-Csv Cmdlet in PowerShell reagiert, wenn die Kopfzeile in einer CSV-Datei einen Null- oder leeren Wert enthält. Import-Csv ersetzt einen Standardnamen für die fehlende Kopfzeile, die zum Eigenschaftennamen des zurückgegebenen Objekts Import-Csv wird.

Get-Content -Path .\Projects.csv

ProjectID,ProjectName,,Completed
13,Inventory,Redmond,True
440,,FarEast,True
469,Marketing,Europe,False

Import-Csv -Path .\Projects.csv

WARNING: One or more headers were not specified. Default names starting with "H" have been used in
place of any missing headers.

ProjectID ProjectName H1      Completed
--------- ----------- --      ---------
13        Inventory   Redmond True
440                   FarEast True
469       Marketing   Europe  False

(Import-Csv -Path .\Projects.csv).H1

WARNING: One or more headers were not specified. Default names starting with "H" have been used in
place of any missing headers.
Redmond
FarEast
Europe

Verwenden Sie die in der Ausgabe des Beispiels Get-Content angezeigten Werte, um ihre Projects.csv Datei zu erstellen.

Das Get-Content Cmdlet zeigt die Projects.csv Datei an. Die Kopfzeile fehlt ein Wert zwischen ProjectName und Completed. Das Import-Csv Cmdlet importiert die Projects.csv-Datei und zeigt eine Warnmeldung an, da H1 ein Standardheadername ist. Der (Import-Csv -Path .\Projects.csv).H1 Befehl ruft die H1-Eigenschaftswerte ab und zeigt eine Warnung an.

Parameter

-Delimiter

Gibt das Trennzeichen für die Eigenschaftswerte in der CSV-Datei an. 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. Wenn Sie Escapezeichen wie Tabstoppzeichen (`t) angeben möchten, schließen Sie sie in doppelte Anführungszeichen ein.

Wenn Sie ein anderes Zeichen als das tatsächliche Zeichenfolgentrennzeichen in der Datei angeben, Import-Csv können die Objekte nicht aus den CSV-Zeichenfolgen erstellt werden und geben die CSV-Zeichenfolgen zurück.

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

-Encoding

Gibt den Typ der Codierung für die Zieldatei an. Der Standardwert ist Default.

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

  • ASCII Verwendet einen ASCII-Zeichensatz (7-Bit).
  • BigEndianUnicode Verwendet UTF-16 mit der Big-End-Byte-Reihenfolge.
  • Default Verwendet die Codierung, die der aktiven Codeseite des Systems (in der Regel ANSI) entspricht.
  • OEM Verwendet die Codierung, die der aktuellen OEM-Codeseite des Systems entspricht.
  • Unicode Verwendet UTF-16 mit der Little-Endian Byte-Reihenfolge.
  • UTF7 Verwendet UTF-7.
  • UTF8 Verwendet UTF-8.
  • UTF32 Verwendet UTF-32 mit der Little-Endian Byte-Reihenfolge.
Type:String
Accepted values:ASCII, BigEndianUnicode, Default, OEM, Unicode, UTF7, UTF8, UTF32
Position:Named
Default value:Default
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Header

Gibt eine alternative Spaltenkopfzeile für die importierte Datei an. Die Spaltenüberschrift bestimmt die Eigenschaftennamen der objekte, die von Import-Csv.

Geben Sie Spaltenüberschriften als durch Zeichen getrennte Liste ein. Die Kopfzeichenfolge darf nicht in Anführungszeichen eingeschlossen werden. Schließen Sie jede Spaltenüberschrift in einfache Anführungszeichen ein.

Wenn Sie weniger Spaltenüberschriften eingeben, als Datenspalten vorhanden sind, werden die datenspalten wieder Standard nicht Karte. Wenn Sie mehr Spaltenüberschriften eingeben, als Datenspalten vorhanden sind, werden die zusätzlichen Spaltenüberschriften mit leeren Datenspalten erstellt.

Löschen Sie bei Verwendung des Header-Parameters die ursprüngliche Kopfzeile aus der CSV-Datei. Import-Csv Andernfalls wird ein zusätzliches Objekt aus den Elementen in der Kopfzeile erstellt.

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

-LiteralPath

Gibt den Pfad zu der zu importierenden CSV-Datei an. Im Gegensatz zu Path wird der Wert des LiteralPath-Parameters genau so verwendet, wie er eingegeben wird. Es werden keine Zeichen als Platzhalter interpretiert. Wenn der Pfad Escapezeichen enthält, müssen Sie ihn in einfache Anführungszeichen einschließen. Einfache Anführungszeichen weisen PowerShell an, keine Zeichen als Escapesequenzen zu interpretieren.

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

-Path

Gibt den Pfad zu der zu importierenden CSV-Datei an. Sie können auch einen Pfad an Import-Csv.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
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:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

String

Sie können eine Zeichenfolge weiterleiten, die einen Pfad zu diesem Cmdlet enthält.

Ausgaben

Object

Dieses Cmdlet gibt die durch den Inhalt in der CSV-Datei beschriebenen Objekte zurück.

Hinweise

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

  • ipcsv

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.

Das Ergebnis eines Import-Csv Befehls ist eine Auflistung von Zeichenfolgen, die ein tabellenähnliches benutzerdefiniertes Objekt bilden. Jede Zeile ist eine separate Zeichenfolge, sodass Sie die Count-Eigenschaft des Objekts verwenden können, um die Tabellenzeilen zu zählen. Die Spalten sind die Eigenschaften des Objekts, und die Elemente in den Zeilen sind die Eigenschaftswerte.

Die Spaltenkopfzeile bestimmt die Anzahl der Spalten und die Spaltennamen. Die Spaltennamen dienen auch als Namen der Objekteigenschaften . Die erste Zeile wird als Spaltenüberschriften interpretiert, es sei denn, Sie verwenden den Header-Parameter , um Spaltenüberschriften anzugeben. Weist eine beliebige Zeile mehr Werte als die Kopfzeile auf, werden die zusätzlichen Werte ignoriert.

Wenn die Spaltenüberschriftzeile einen Wert fehlt oder einen Null- oder leeren Wert enthält, Import-Csv wird H gefolgt von einer Zahl für die fehlende Spaltenüberschrift und den Eigenschaftennamen verwendet.

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 des Objekts in Zeichenfolgen konvertiert, sodass sie durch den Namen des Eigenschaftswerts dargestellt werden. Export-Csv exportiert die Methoden des Objekts nicht.