Import-Csv

Referentie

Module:: Microsoft.PowerShell.Utility

Hiermee maakt u tabelachtige aangepaste objecten van de items in een bestand met door komma's gescheiden waarden (CSV).

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>]

Description

Met de Import-Csv cmdlet worden aangepaste objecten gemaakt op basis 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 betrekking hebben op bestanden.

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

Import-Csv gebruikt de byte-order-mark (BOM) om de coderingsindeling van het bestand te detecteren. Als het bestand geen stuklijst heeft, wordt ervan uitgegaan dat de codering UTF8 is.

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 via de pijplijn naar de Format-Table cmdlet verzonden en geeft de objecten weer.

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 puntscheidingsteken op te geven. De Import-Csv cmdlet importeert de CSV-tekenreeksen uit het Processes.csv-bestand. De tekenreeksen worden opgeslagen in de $P variabele. De variabele Naar $P wordt door 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 in 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 Core. 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

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

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. In Get-Member de cmdlet worden de eigenschapsnamen van de parameter Header weergegeven. 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 wordt geretourneerd.

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 dat de eigenschapswaarden in het CSV-bestand scheidt. De standaardwaarde is een komma (,).

Voer een teken in, zoals een dubbele punt (:). Als u een puntkomma (;) plaatst u deze tussen enkele 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 het type codering voor het doelbestand. De standaardwaarde is Standaard.

De acceptabele waarden voor deze parameter zijn als volgt:

ASCII Maakt gebruik van ASCII-tekenset (7-bits).
BigEndianUnicode Gebruikt UTF-16 met de bytevolgorde big-endian.
Standaard Gebruikt de codering die overeenkomt met de actieve codepagina van het systeem (meestal ANSI).
OEM Gebruikt de codering die overeenkomt met de huidige OEM-codepagina van het systeem.
Unicode Gebruikt UTF-16 met de bytevolgorde little-endian.
UTF7 Maakt gebruik van UTF-7.
UTF8 Maakt gebruik van UTF-8.
UTF32 Gebruikt UTF-32 met de bytevolgorde little-endian.

Type:	Encoding
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

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

Voer kolomkoppen in als een door komma's 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 exact gebruikt zoals deze is getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escapetekens bevat, plaatst u het tussen enkele aanhalingstekens. Enkele aanhalingstekens vertellen PowerShell dat geen tekens als escape-reeksen worden geïnterpreteerd.

Type:	String[]
Aliases:	PSPath
Position:	Named
Default value:	None
Required:	False
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 doorsnijden naar Import-Csv.

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

-UseCulture

Hiermee gebruikt u het lijstscheidingsteken voor de huidige cultuur als het itemscheidingsteken. Als u het lijstscheidingsteken voor een cultuur wilt zoeken, gebruikt u de volgende opdracht: (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 Import-Csvbevat.

Uitvoerwaarden

Object

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

Notities

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

Het resultaat van een Import-Csv opdracht is een verzameling tekenreeksen die een tabelachtig aangepast object vormen. Elke rij is een afzonderlijke tekenreeks, dus u kunt de eigenschap Aantal van het object gebruiken om de tabelrijen te tellen. De kolommen zijn de eigenschappen van het object en 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, Import-Csv gebruikt u H gevolgd door een getal voor de ontbrekende kolomkop en eigenschapsnaam.

In het CSV-bestand wordt elk object vertegenwoordigd door een door komma's 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.

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