Import-Csv

Referensi

Modul:: Microsoft.PowerShell.Utility

Membuat objek kustom seperti tabel dari item dalam file nilai yang dipisahkan karakter (CSV).

Sintaks

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

Deskripsi

Import-Csv Cmdlet membuat objek kustom seperti tabel dari item dalam file CSV. Setiap kolom dalam file CSV menjadi properti objek kustom dan item dalam baris menjadi nilai properti. Import-Csv bekerja pada file CSV apa pun, termasuk file yang dihasilkan oleh Export-Csv cmdlet.

Anda dapat menggunakan parameter Import-Csv cmdlet untuk menentukan baris header kolom dan pemisah item, atau mengarahkan Import-Csv untuk menggunakan pemisah daftar untuk budaya saat ini sebagai pemisah item.

Anda juga dapat menggunakan ConvertTo-Csv cmdlet dan ConvertFrom-Csv untuk mengonversi objek ke string CSV (dan kembali). Cmdlet ini sama Export-CSV dengan cmdlet dan Import-Csv , kecuali bahwa mereka tidak berurusan dengan file.

Jika entri baris header dalam file CSV berisi nilai kosong atau null, PowerShell menyisipkan nama baris header default dan menampilkan pesan peringatan.

Dimulai dengan PowerShell 6.0, Import-Csv sekarang mendukung Format File Log Yang Diperluas W3C.

Contoh

Contoh 1: Mengimpor objek proses

Contoh ini menunjukkan cara mengekspor lalu mengimpor file CSV objek proses.

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

Get-Process Cmdlet mengirim objek proses ke alur ke Export-Csv. Export-Csv Cmdlet mengonversi objek proses menjadi string CSV dan menyimpan string dalam file Processes.csv. Import-Csv Cmdlet mengimpor string CSV dari file Processes.csv. String disimpan dalam $P variabel . Variabel $P dikirimkan alur ke Get-Member cmdlet yang menampilkan properti string CSV yang diimpor. Variabel $P dikirimkan alur ke Format-Table cmdlet dan menampilkan objek.

Contoh 2: Tentukan pemisah

Contoh ini menunjukkan cara menggunakan parameter Pemisah cmdlet Import-Csv .

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

Get-Process Cmdlet mengirim objek proses ke bawah alur ke Export-Csv. Export-Csv Cmdlet mengonversi objek proses menjadi string CSV dan menyimpan string dalam file Processes.csv. Parameter Pemisah digunakan untuk menentukan pemisah titik dua. Import-Csv Cmdlet mengimpor string CSV dari file Processes.csv. String disimpan dalam $P variabel . Untuk $P variabel dikirimkan alur ke Format-Table cmdlet.

Contoh 3: Tentukan budaya saat ini untuk pemisah

Contoh ini menunjukkan cara menggunakan Import-Csv cmdlet dengan parameter UseCulture .

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

Get-Culture Cmdlet menggunakan properti berlapis TextInfo dan ListSeparator untuk mendapatkan pemisah daftar default budaya saat ini. Get-Process Cmdlet mengirim objek proses ke bawah alur ke Export-Csv. Export-Csv Cmdlet mengonversi objek proses menjadi string CSV dan menyimpan string dalam file Processes.csv. Parameter UseCulture menggunakan pemisah daftar default budaya saat ini. Import-Csv Cmdlet mengimpor string CSV dari file Processes.csv.

Contoh 4: Mengubah nama properti dalam objek yang diimpor

Contoh ini menunjukkan cara menggunakan parameter Import-Csv Header untuk mengubah nama properti dalam objek yang diimpor yang dihasilkan.

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]

Start-Job Cmdlet memulai pekerjaan latar belakang yang berjalan Get-Process. Objek pekerjaan dikirimkan alur ke Export-Csv cmdlet dan dikonversi ke string CSV. Parameter NoTypeInformation menghapus header informasi jenis dari output CSV dan bersifat opsional di PowerShell v6 dan yang lebih tinggi. Variabel $Header berisi header kustom yang menggantikan nilai default berikut: HasMoreData, JobStateInfo, PSBeginTime, PSEndTime, dan PSJobTypeName. Variabel $A menggunakan Get-Content cmdlet untuk mendapatkan string CSV dari file Jobs.csv. Variabel $A digunakan untuk menghapus header default dari file. Out-File Cmdlet menyimpan versi baru file Jobs.csv dalam $A variabel. Import-Csv Cmdlet mengimpor file Jobs.csv dan menggunakan parameter Header untuk menerapkan $Header variabel. Variabel $J berisi PSCustomObject yang diimpor dan menampilkan objek di konsol PowerShell.

Contoh 5: Membuat objek kustom menggunakan file CSV

Contoh ini memperlihatkan cara membuat objek kustom di PowerShell dengan menggunakan file CSV.

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

Untuk membuat file Links.csv Anda, gunakan nilai yang ditunjukkan dalam Get-Content output.

Get-Content Cmdlet menampilkan file Links.csv. Import-Csv Cmdlet mengimpor file Links.csv. Parameter Header menentukan nama properti LinkId dan TopicTitle. Objek disimpan dalam $A variabel . Get-Member Cmdlet menunjukkan nama properti dari parameter Header. Where-Object Cmdlet memilih objek dengan properti TopicTitle yang menyertakan alias.

Contoh 6: Mengimpor CSV yang kehilangan nilai

Contoh ini memperlihatkan bagaimana Import-Csv cmdlet di PowerShell merespons saat baris header dalam file CSV menyertakan nilai null atau kosong. Import-Csv menggantikan nama default untuk baris header yang hilang yang menjadi nama properti objek yang Import-Csv dikembalikan.

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

Untuk membuat file Projects.csv Anda, gunakan nilai yang ditunjukkan dalam output contoh Get-Content .

Get-Content Cmdlet menampilkan file Projects.csv. Baris header tidak memiliki nilai antara ProjectName dan Completed. Import-Csv Cmdlet mengimpor file Projects.csv dan menampilkan pesan peringatan karena H1 adalah nama header default. Perintah (Import-Csv -Path .\Projects.csv).H1 mendapatkan nilai properti H1 dan menampilkan peringatan.

Parameter

-Delimiter

Menentukan pemisah yang memisahkan nilai properti dalam file CSV. Defaultnya adalah koma (,).

Masukkan karakter, seperti titik dua (:). Untuk menentukan titik koma (;) mengapitnya dalam tanda kutip tunggal. Untuk menentukan karakter khusus yang lolos seperti tab (`t), sertakan dalam tanda kutip ganda.

Jika Anda menentukan karakter selain pemisah string aktual dalam file, Import-Csv tidak dapat membuat objek dari string CSV dan akan mengembalikan string CSV.

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

-Encoding

Menentukan pengodean untuk file CSV yang diimpor. Nilai defaultnya adalah utf8NoBOM.

Nilai yang dapat diterima untuk parameter ini adalah sebagai berikut:

ascii: Menggunakan pengodean untuk set karakter ASCII (7-bit).
bigendianunicode: Mengodekan dalam format UTF-16 menggunakan urutan byte big-endian.
bigendianutf32: Mengodekan dalam format UTF-32 menggunakan urutan byte big-endian.
oem: Menggunakan pengodean default untuk MS-DOS dan program konsol.
unicode: Mengodekan dalam format UTF-16 menggunakan urutan byte little-endian.
utf7: Mengodekan dalam format UTF-7.
utf8: Mengodekan dalam format UTF-8.
utf8BOM: Mengodekan dalam format UTF-8 dengan Byte Order Mark (BOM)
utf8NoBOM: Mengodekan dalam format UTF-8 tanpa Byte Order Mark (BOM)
utf32: Mengodekan dalam format UTF-32.

Dimulai dengan PowerShell 6.2, parameter Pengodean juga memungkinkan ID numerik halaman kode terdaftar (seperti -Encoding 1251) atau nama string halaman kode terdaftar (seperti -Encoding "windows-1251"). Untuk informasi selengkapnya, lihat dokumentasi .NET untuk Encoding.CodePage.

Catatan

UTF-7* tidak lagi disarankan untuk digunakan. Pada PowerShell 7.1, peringatan ditulis jika Anda menentukan utf7 untuk parameter Pengodean .

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

Menentukan baris header kolom alternatif untuk file yang diimpor. Header kolom menentukan nama properti objek yang dibuat oleh Import-Csv.

Masukkan header kolom sebagai daftar yang dipisahkan karakter. Jangan sertakan string header dalam tanda kutip. Sertakan setiap header kolom dalam tanda kutip tunggal.

Jika Anda memasukkan lebih sedikit header kolom daripada kolom data, kolom data yang tersisa akan dibuang. Jika Anda memasukkan lebih banyak header kolom daripada kolom data, header kolom tambahan dibuat dengan kolom data kosong.

Saat menggunakan parameter Header , hapus baris header asli dari file CSV. Jika tidak, Import-Csv membuat objek tambahan dari item di baris header.

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

-LiteralPath

Menentukan jalur ke file CSV yang akan diimpor. Tidak seperti Path, nilai parameter LiteralPath digunakan persis seperti yang ditik. Tidak ada karakter yang ditafsirkan sebagai kartubebas. Jika jalur menyertakan karakter escape, sertakan dalam tanda kutip tunggal. Tanda kutip tunggal memberi tahu PowerShell untuk tidak menginterpretasikan karakter apa pun sebagai urutan escape.

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

-Path

Menentukan jalur ke file CSV yang akan diimpor. Anda juga dapat menyalurkan jalur ke Import-Csv.

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

-UseCulture

Menggunakan pemisah daftar untuk budaya saat ini sebagai pemisah item. Untuk menemukan pemisah daftar untuk budaya, gunakan perintah berikut: (Get-Culture).TextInfo.ListSeparator.

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

Input

String

Anda dapat menyalurkan string yang berisi jalur ke cmdlet ini.

Output

Object

Cmdlet ini mengembalikan objek yang dijelaskan oleh konten dalam file CSV.

Catatan

PowerShell menyertakan alias berikut untuk Import-Csv:

Semua platform:
- ipcsv

Karena objek yang diimpor adalah versi CSV dari jenis objek, objek tersebut tidak dikenali dan diformat oleh entri pemformatan jenis PowerShell yang memformat versi non-CSV dari jenis objek.

Hasil perintah Import-Csv adalah kumpulan string yang membentuk objek kustom seperti tabel. Setiap baris adalah string terpisah, sehingga Anda dapat menggunakan properti Hitung objek untuk menghitung baris tabel. Kolom adalah properti objek dan item dalam baris adalah nilai properti.

Baris header kolom menentukan jumlah kolom dan nama kolom. Nama kolom juga merupakan nama properti objek. Baris pertama ditafsirkan menjadi header kolom, kecuali Anda menggunakan parameter Header untuk menentukan header kolom. Jika ada baris yang memiliki lebih banyak nilai daripada baris header, nilai tambahan akan diabaikan.

Jika baris header kolom kehilangan nilai atau berisi nilai null atau kosong, Import-Csv gunakan H diikuti dengan angka untuk header kolom dan nama properti yang hilang.

Dalam file CSV, setiap objek diwakili oleh daftar nilai properti objek yang dipisahkan karakter. Nilai properti dikonversi ke string dengan menggunakan metode ToString() objek, sehingga diwakili dengan nama nilai properti. Export-Csv tidak mengekspor metode objek.

Import-Csv juga mendukung format W3C Extended Log. Baris yang dimulai diperlakukan # sebagai komentar dan diabaikan kecuali komentar dimulai dengan #Fields: dan berisi daftar nama kolom yang dibatasi. Dalam hal ini, cmdlet menggunakan nama kolom tersebut. Ini adalah format standar untuk Windows IIS dan log server web lainnya. Untuk informasi selengkapnya, lihat Format File Log yang Diperluas.

Import-Csv

Sintaks

Deskripsi

Contoh

Contoh 1: Mengimpor objek proses

Contoh 2: Tentukan pemisah

Contoh 3: Tentukan budaya saat ini untuk pemisah

Contoh 4: Mengubah nama properti dalam objek yang diimpor

Contoh 5: Membuat objek kustom menggunakan file CSV

Contoh 6: Mengimpor CSV yang kehilangan nilai

Parameter

-Delimiter

-Encoding

-Header

-LiteralPath

-Path

-UseCulture

Input

Output

Catatan

Saran dan Komentar

Sumber Daya Tambahan:

Import-Csv

Sintaks

Deskripsi

Contoh

Contoh 1: Mengimpor objek proses

Contoh 2: Tentukan pemisah

Contoh 3: Tentukan budaya saat ini untuk pemisah

Contoh 4: Mengubah nama properti dalam objek yang diimpor

Contoh 5: Membuat objek kustom menggunakan file CSV

Contoh 6: Mengimpor CSV yang kehilangan nilai

Parameter

-Delimiter

-Encoding

-Header

-LiteralPath

-Path

-UseCulture

Input

Output

Catatan

Link Terkait

Saran dan Komentar

Sumber Daya Tambahan: