ConvertFrom-Csv

Referensi

Modul:: Microsoft.PowerShell.Utility

Mengonversi properti objek dalam format nilai yang dipisahkan karakter (CSV) menjadi versi CSV dari objek asli.

Sintaks

ConvertFrom-Csv
                [[-Delimiter] <Char>]
                [-InputObject] <PSObject[]>
                [-Header <String[]>]
                [<CommonParameters>]

ConvertFrom-Csv
                -UseCulture
                [-InputObject] <PSObject[]>
                [-Header <String[]>]
                [<CommonParameters>]

Deskripsi

Cmdlet ConvertFrom-Csv mengonversi data nilai yang dipisahkan karakter (CSV) menjadi objek jenis PSObject untuk setiap baris data CSV. Objek baru ditulis ke alur dalam urutan dibaca dari data CSV. Nilai dalam baris header kolom CSV menjadi nama properti yang ditambahkan ke setiap baru PSObject.

Objek yang ConvertFrom-Csv buat objek jenis PSObject untuk setiap baris dalam file CSV. Nilai properti objek CSV adalah versi string dari nilai properti objek asli. Versi CSV objek tidak memiliki metode apa pun.

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

Jenis PSObject mempertahankan urutan properti dalam urutan header kolom. Ini berarti Anda mendapatkan urutan kolom yang sama saat mengonversi objek kembali ke format CSV.

Contoh

Contoh 1: Mengonversi proses di komputer lokal ke format CSV

Contoh ini menunjukkan cara mengonversi proses di komputer lokal menjadi format CSV lalu memulihkannya ke formulir objek.

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

Cmdlet Get-Process mengirimkan proses ke alur ke ConvertTo-Csv. cmdlet ConvertTo-Csv mengonversi objek proses menjadi serangkaian string CSV. cmdlet ConvertFrom-Csv mengonversi string CSV menjadi versi CSV dari objek proses asli. String CSV disimpan dalam variabel $P.

Contoh 2: Mengonversi objek data ke format CSV lalu ke format objek CSV

Contoh ini menunjukkan cara mengonversi objek data ke format CSV lalu ke format objek CSV.

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

Perintah pertama menggunakan Get-Date untuk mengirim tanggal dan waktu saat ini ke alur ke ConvertTo-Csv. cmdlet ConvertTo-Csv mengonversi objek tanggal menjadi serangkaian string CSV. Parameter pemisah digunakan untuk menentukan pemisah titik koma. String disimpan dalam variabel $Date.

Contoh 3: Gunakan parameter header untuk mengubah nama properti

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

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

Cmdlet Start-Job memulai pekerjaan latar belakang yang berjalan Get-Process. Objek pekerjaan dikirimkan alur ke ConvertTo-Csv 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 $J berisi string CSV dan digunakan untuk menghapus header default. Cmdlet ConvertFrom-Csv mengonversi string CSV menjadi PSCustomObject dan menggunakan parameter Header untuk menerapkan variabel $Header.

Contoh 4: Mengonversi string CSV objek layanan

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

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

Cmdlet Get-Culture menggunakan properti berlapis TextInfo dan ListSeparator untuk mendapatkan pemisah daftar default budaya saat ini. Cmdlet Get-Service mengirim objek layanan ke bawah alur ke ConvertTo-Csv. ConvertTo-Csv mengonversi objek layanan menjadi serangkaian string CSV. String CSV disimpan dalam variabel $Services. Cmdlet ConvertFrom-Csv menggunakan parameter InputObject dan mengonversi string CSV dari variabel $Services. Parameter UseCulture menggunakan pemisah daftar default budaya saat ini.

Ketika parameter UseCulture digunakan, pastikan bahwa pemisah daftar default budaya saat ini cocok dengan pemisah yang digunakan dalam string CSV. Jika tidak, ConvertFrom-Csv tidak dapat menghasilkan objek dari string CSV.

Parameter

-Delimiter

Menentukan pemisah yang memisahkan nilai properti dalam string CSV. Defaultnya adalah koma (,). Masukkan karakter, seperti titik dua (:). Untuk menentukan titik koma (;) sertakan dalam tanda kutip tunggal.

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

Jenis:	Char
Position:	1
Nilai default:	comma (,)
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

Menentukan baris header kolom alternatif untuk string yang diimpor. Header kolom menentukan nama properti objek yang dibuat oleh ConvertFrom-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, hilangkan string header kolom dari string CSV. Jika tidak, cmdlet ini membuat objek tambahan dari item di baris header.

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-InputObject

Menentukan string CSV yang akan dikonversi ke objek. Masukkan variabel yang berisi string CSV atau ketik perintah atau ekspresi yang mendapatkan string CSV. Anda juga dapat menyalurkan string CSV ke ConvertFrom-Csv.

Jenis:	PSObject[]
Position:	0
Nilai default:	None
Diperlukan:	True
Terima input alur:	True
Terima karakter wildcard:	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.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

Input

String

Anda dapat menyalurkan string CSV ke cmdlet ini.

Output

PSObject

Cmdlet ini mengembalikan objek yang dijelaskan oleh properti dalam string CSV.

Catatan

Dalam format CSV, setiap objek diwakili oleh daftar nilai properti objek yang dipisahkan karakter. Nilai properti dikonversi menjadi string, menggunakan metode ToString() objek. Tidak ada cara untuk mengekspor metode objek.

Bagikan melalui