Import-Csv

Referentie

Module:: Microsoft.PowerShell.Utility

Hiermee maakt u tabelachtige aangepaste objecten van de items in een BESTAND met door tekens gescheiden waarden (CSV).

Syntax

Import-Csv
      [[-Delimiter] <Char>]
      [-Path] <String[]>
      [-Header <String[]>]
      [-Encoding <Encoding>]
      [<CommonParameters>]

Import-Csv
      [[-Delimiter] <Char>]
      -LiteralPath <String[]>
      [-Header <String[]>]
      [-Encoding <Encoding>]
      [<CommonParameters>]

Import-Csv
      [-Path] <String[]>
      -UseCulture
      [-Header <String[]>]
      [-Encoding <Encoding>]
      [<CommonParameters>]

Import-Csv
      -LiteralPath <String[]>
      -UseCulture
      [-Header <String[]>]
      [-Encoding <Encoding>]
      [<CommonParameters>]

Description

De Import-Csv cmdlet maakt tabelachtige aangepaste objecten van de items in CSV-bestanden. Elke kolom in het CSV-bestand wordt een eigenschap van het aangepaste object en de items in rijen worden de eigenschapswaarden. Import-Csv werkt op elk CSV-bestand, met inbegrip van bestanden die worden gegenereerd door de Export-Csv cmdlet.

U kunt de parameters van de Import-Csv cmdlet gebruiken om de kolomkoprij en het itemscheidingsteken op te geven, of direct Import-Csv om het lijstscheidingsteken voor de huidige cultuur te gebruiken als het itemscheidingsteken.

U kunt ook de ConvertTo-Csv cmdlets en ConvertFrom-Csv gebruiken om objecten te converteren naar CSV-tekenreeksen (en terug). Deze cmdlets zijn hetzelfde als de Export-CSV cmdlets en Import-Csv , behalve dat ze geen bestanden verwerken.

Als een veldnamenrijvermelding in een CSV-bestand een lege of null-waarde bevat, voegt PowerShell een standaardnaam voor de veldnamenrij in en wordt een waarschuwingsbericht weergegeven.

Vanaf PowerShell 6.0 Import-Csv wordt nu de W3C Extended Log File Format ondersteund.

Voorbeelden

Voorbeeld 1: Procesobjecten importeren

In dit voorbeeld ziet u hoe u een CSV-bestand met procesobjecten exporteert en vervolgens importeert.

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

De Get-Process cmdlet verzendt procesobjecten in de pijplijn naar de Export-Csv. De Export-Csv cmdlet converteert de procesobjecten naar CSV-tekenreeksen en slaat de tekenreeksen op in het Processes.csv-bestand. De Import-Csv cmdlet importeert de CSV-tekenreeksen uit het Processes.csv-bestand. De tekenreeksen worden opgeslagen in de $P variabele. De $P variabele wordt door de pijplijn verzonden naar de Get-Member cmdlet die de eigenschappen van de geïmporteerde CSV-tekenreeksen weergeeft. De $P variabele wordt door de pijplijn naar de Format-Table cmdlet verzonden en de objecten worden weergegeven.

Voorbeeld 2: het scheidingsteken opgeven

In dit voorbeeld ziet u hoe u de parameter Scheidingsteken van de Import-Csv cmdlet gebruikt.

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

De Get-Process cmdlet verzendt procesobjecten in de pijplijn naar Export-Csv. De Export-Csv cmdlet converteert de procesobjecten naar CSV-tekenreeksen en slaat de tekenreeksen op in het Processes.csv-bestand. De parameter Scheidingsteken wordt gebruikt om een dubbele punt op te geven. De Import-Csv cmdlet importeert de CSV-tekenreeksen uit het Processes.csv-bestand. De tekenreeksen worden opgeslagen in de $P variabele. Naar $P variabele wordt de pijplijn naar de Format-Table cmdlet verzonden.

Voorbeeld 3: de huidige cultuur voor het scheidingsteken opgeven

In dit voorbeeld ziet u hoe u de Import-Csv cmdlet gebruikt met de parameter UseCulture .

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

De Get-Culture cmdlet gebruikt de geneste eigenschappen TextInfo en ListSeparator om het standaardlijstscheidingsteken van de huidige cultuur op te halen. De Get-Process cmdlet verzendt procesobjecten in de pijplijn naar Export-Csv. De Export-Csv cmdlet converteert de procesobjecten naar CSV-tekenreeksen en slaat de tekenreeksen op in het Processes.csv-bestand. De parameter UseCulture gebruikt het standaardlijstscheidingsteken van de huidige cultuur. De Import-Csv cmdlet importeert de CSV-tekenreeksen uit het Processes.csv-bestand.

Voorbeeld 4: eigenschapsnamen in een geïmporteerd object wijzigen

In dit voorbeeld ziet u hoe u de parameter Header van Import-Csv gebruikt om de namen van eigenschappen in het resulterende geïmporteerde object te wijzigen.

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]

De Start-Job cmdlet start een achtergrondtaak die wordt uitgevoerd Get-Process. Een taakobject wordt via de pijplijn naar de Export-Csv cmdlet verzonden en geconverteerd naar een CSV-tekenreeks. De parameter NoTypeInformation verwijdert de header van de typegegevens uit de CSV-uitvoer en is optioneel in PowerShell v6 en hoger. De $Header variabele bevat een aangepaste header die de volgende standaardwaarden vervangt: HasMoreData, JobStateInfo, PSBeginTime, PSEndTime en PSJobTypeName. De $A variabele gebruikt de Get-Content cmdlet om de CSV-tekenreeks op te halen uit het Jobs.csv-bestand. De $A variabele wordt gebruikt om de standaardheader uit het bestand te verwijderen. De Out-File cmdlet slaat de nieuwe versie van het Jobs.csv-bestand op in de $A variabele. De Import-Csv cmdlet importeert het Jobs.csv-bestand en gebruikt de parameter Header om de $Header variabele toe te passen. De $J variabele bevat het geïmporteerde PSCustomObject en geeft het object weer in de PowerShell-console.

Voorbeeld 5: een aangepast object Creatie met behulp van een CSV-bestand

In dit voorbeeld ziet u hoe u een aangepast object maakt in PowerShell met behulp van een CSV-bestand.

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

Gebruik de waarden die worden weergegeven in de Get-Content uitvoer om het Links.csv-bestand te maken.

De Get-Content cmdlet geeft het Links.csv-bestand weer. De Import-Csv cmdlet importeert het Links.csv-bestand. De parameter Header geeft de eigenschapsnamen LinkId en TopicTitle op. De objecten worden opgeslagen in de $A variabele. De Get-Member cmdlet toont de eigenschapsnamen van de headerparameter . De Where-Object cmdlet selecteert objecten met de eigenschap TopicTitle die alias bevat.

Voorbeeld 6: Een CSV importeren waarvoor een waarde ontbreekt

In dit voorbeeld ziet u hoe de Import-Csv cmdlet in PowerShell reageert wanneer de veldnamenrij in een CSV-bestand een null- of lege waarde bevat. Import-Csv vervangt een standaardnaam voor de ontbrekende veldnamenrij die de eigenschapsnaam wordt van het object dat Import-Csv retourneert.

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

Als u het Projects.csv-bestand wilt maken, gebruikt u de waarden die worden weergegeven in de uitvoer van Get-Content het voorbeeld.

De Get-Content cmdlet geeft het Projects.csv-bestand weer. In de veldnamenrij ontbreekt een waarde tussen ProjectName en Completed. De Import-Csv cmdlet importeert het Projects.csv-bestand en geeft een waarschuwingsbericht weer omdat H1 een standaardheadernaam is. Met de (Import-Csv -Path .\Projects.csv).H1 opdracht worden de H1-eigenschapswaarden opgehaald en wordt een waarschuwing weergegeven.

Parameters

-Delimiter

Hiermee geeft u het scheidingsteken op waarmee de eigenschapswaarden in het CSV-bestand worden gescheiden. De standaardwaarde is een komma (,).

Voer een teken in, zoals een dubbele punt (:). Als u een puntkomma (;) wilt opgeven, plaatst u deze tussen enkele aanhalingstekens. Als u speciale tekens met escape-tekens wilt opgeven, zoals tab (`t), plaatst u deze tussen dubbele aanhalingstekens.

Als u een ander teken opgeeft dan het werkelijke tekenreeksscheidingsteken in het bestand, Import-Csv kunnen de objecten niet worden gemaakt op basis van de CSV-tekenreeksen en worden de CSV-tekenreeksen geretourneerd.

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

-Encoding

Hiermee geeft u de codering voor het geïmporteerde CSV-bestand. De standaardwaarde is utf8NoBOM.

De acceptabele waarden voor deze parameter zijn als volgt:

ascii: maakt gebruik van de codering voor de ASCII-tekenset (7-bits).
bigendianunicode: Codeert in UTF-16-indeling met behulp van de bytevolgorde big-endian.
bigendianutf32: Codeert in UTF-32-indeling met behulp van de bytevolgorde big-endian.
oem: Maakt gebruik van de standaardcodering voor MS-DOS en consoleprogramma's.
unicode: Codeert in UTF-16-indeling met behulp van de bytevolgorde little-endian.
utf7: Codeert in UTF-7-indeling.
utf8: Codeert in UTF-8-indeling.
utf8BOM: Codeert in UTF-8-indeling met Byte Order Mark (BOM)
utf8NoBOM: Codeert in UTF-8-indeling zonder Byte Order Mark (BOM)
utf32: Codeert in UTF-32-indeling.

Vanaf PowerShell 6.2 staat de coderingsparameter ook numerieke id's toe van geregistreerde codepagina's (zoals -Encoding 1251) of tekenreeksnamen van geregistreerde codepagina's (zoals -Encoding "windows-1251"). Zie de .NET-documentatie voor Encoding.CodePage voor meer informatie.

Notitie

UTF-7* wordt niet meer aanbevolen om te gebruiken. Vanaf PowerShell 7.1 wordt er een waarschuwing geschreven als u opgeeft utf7 voor de coderingsparameter .

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

Hiermee geeft u een alternatieve kolomkoprij voor het geïmporteerde bestand. De kolomkop bepaalt de eigenschapsnamen van de objecten die door Import-Csvzijn gemaakt.

Kolomkoppen invoeren als een door tekens gescheiden lijst. Plaats de kopteksttekenreeks niet tussen aanhalingstekens. Plaats elke kolomkop tussen enkele aanhalingstekens.

Als u minder kolomkoppen invoert dan er gegevenskolommen zijn, worden de resterende gegevenskolommen verwijderd. Als u meer kolomkoppen invoert dan er gegevenskolommen zijn, worden de extra kolomkoppen gemaakt met lege gegevenskolommen.

Wanneer u de parameter Header gebruikt, verwijdert u de oorspronkelijke veldnamenrij uit het CSV-bestand. Import-Csv Anders maakt u een extra object van de items in de veldnamenrij.

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

-LiteralPath

Hiermee geeft u het pad naar het CSV-bestand te importeren. In tegenstelling tot Path wordt de waarde van de parameter LiteralPath precies gebruikt zoals deze is getypt. Geen tekens worden geïnterpreteerd als jokertekens. Als het pad escape-tekens bevat, plaatst u het tussen enkele aanhalingstekens. Enkele aanhalingstekens geven PowerShell aan dat geen tekens als escape-reeksen worden geïnterpreteerd.

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

-Path

Hiermee geeft u het pad naar het CSV-bestand te importeren. U kunt ook een pad doorspezen naar Import-Csv.

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

-UseCulture

Gebruikt het lijstscheidingsteken voor de huidige cultuur als het itemscheidingsteken. Gebruik de volgende opdracht om het lijstscheidingsteken voor een cultuur te vinden: (Get-Culture).TextInfo.ListSeparator.

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

Invoerwaarden

String

U kunt een tekenreeks doorsnijden die een pad naar deze cmdlet bevat.

Uitvoerwaarden

Object

Deze cmdlet retourneert de objecten die worden beschreven door de inhoud in het CSV-bestand.

Notities

PowerShell bevat de volgende aliassen voor Import-Csv:

Alle platformen:
- ipcsv

Omdat de geïmporteerde objecten CSV-versies van het objecttype zijn, worden ze niet herkend en opgemaakt door de PowerShell-opmaakvermeldingen waarmee de niet-CSV-versies van het objecttype worden opgemaakt.

Het resultaat van een Import-Csv opdracht is een verzameling tekenreeksen die een aangepast object vormen dat lijkt op een tabel. Elke rij is een afzonderlijke tekenreeks, dus u kunt de eigenschap Count van het object gebruiken om de tabelrijen te tellen. De kolommen zijn de eigenschappen van het object en de items in de rijen zijn de eigenschapswaarden.

De kolomkoprij bepaalt het aantal kolommen en de kolomnamen. De kolomnamen zijn ook de namen van de eigenschappen van de objecten. De eerste rij wordt geïnterpreteerd als de kolomkoppen, tenzij u de parameter Koptekst gebruikt om kolomkoppen op te geven. Als een rij meer waarden heeft dan de veldnamenrij, worden de extra waarden genegeerd.

Als in de kolomkoprij een waarde ontbreekt of een null- of lege waarde bevat, gebruikt u H gevolgd Import-Csv door een getal voor de ontbrekende kolomkop en de naam van de eigenschap.

In het CSV-bestand wordt elk object vertegenwoordigd door een door tekens gescheiden lijst met de eigenschapswaarden van het object. De eigenschapswaarden worden geconverteerd naar tekenreeksen met behulp van de methode ToString() van het object, zodat ze worden vertegenwoordigd door de naam van de eigenschapswaarde. Export-Csv exporteert de methoden van het object niet.

Import-Csv ondersteunt ook de W3C Extended Log-indeling. Regels die beginnen met # worden behandeld als opmerkingen en genegeerd, tenzij de opmerking begint met en een lijst met #Fields: kolomnamen met scheidingstekens bevat. In dat geval gebruikt de cmdlet deze kolomnamen. Dit is de standaardindeling voor Windows IIS en andere webserverlogboeken. Zie Uitgebreide logboekbestandsindeling voor meer informatie.

Delen via

Import-Csv

Syntax

Description

Voorbeelden

Voorbeeld 1: Procesobjecten importeren

Voorbeeld 2: het scheidingsteken opgeven

Voorbeeld 3: de huidige cultuur voor het scheidingsteken opgeven

Voorbeeld 4: eigenschapsnamen in een geïmporteerd object wijzigen

Voorbeeld 5: een aangepast object Creatie met behulp van een CSV-bestand

Voorbeeld 6: Een CSV importeren waarvoor een waarde ontbreekt

Parameters

-Delimiter

-Encoding

-Header

-LiteralPath

-Path

-UseCulture

Invoerwaarden

Uitvoerwaarden

Notities

Aanvullende resources

Delen via

Import-Csv

Syntax

Description

Voorbeelden

Voorbeeld 1: Procesobjecten importeren

Voorbeeld 2: het scheidingsteken opgeven

Voorbeeld 3: de huidige cultuur voor het scheidingsteken opgeven

Voorbeeld 4: eigenschapsnamen in een geïmporteerd object wijzigen

Voorbeeld 5: een aangepast object Creatie met behulp van een CSV-bestand

Voorbeeld 6: Een CSV importeren waarvoor een waarde ontbreekt

Parameters

-Delimiter

-Encoding

-Header

-LiteralPath

-Path

-UseCulture

Invoerwaarden

Uitvoerwaarden

Notities

Verwante koppelingen

Aanvullende resources