ConvertFrom-Csv
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
ConvertFrom-Csv Cmdlet 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 PSObject baru.
Objek yang ConvertFrom-Csv dibuat adalah 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 Export-Csv cmdlet dan Import-Csv untuk mengonversi objek ke string CSV dalam file dan kembali. Cmdlet ini sama ConvertTo-Csv dengan cmdlet dan ConvertFrom-Csv , kecuali bahwa mereka 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-CsvGet-Process Cmdlet mengirimkan proses ke alur ke ConvertTo-Csv. ConvertTo-Csv Cmdlet mengonversi objek proses menjadi serangkaian string CSV. ConvertFrom-Csv Cmdlet mengonversi string CSV menjadi versi CSV dari objek proses asli.
String CSV disimpan dalam $P variabel .
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. ConvertTo-Csv Cmdlet mengonversi objek tanggal menjadi serangkaian string CSV. Parameter Pemisah digunakan untuk menentukan pemisah titik koma. String disimpan dalam $Date variabel .
Contoh 3: Gunakan parameter header untuk mengubah nama properti
Contoh ini menunjukkan cara menggunakan parameter ConvertFrom-Csv Header 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]Start-Job Cmdlet 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. ConvertFrom-Csv Cmdlet mengonversi string CSV menjadi PSCustomObject dan menggunakan parameter Header untuk menerapkan $Header variabel.
Contoh 4: Mengonversi string CSV objek layanan
Contoh ini menunjukkan cara menggunakan ConvertFrom-Csv cmdlet dengan parameter UseCulture .
(Get-Culture).TextInfo.ListSeparator
$Services = (Get-Service | ConvertTo-Csv)
ConvertFrom-Csv -InputObject $Services -UseCultureGet-Culture Cmdlet menggunakan properti berlapis TextInfo dan ListSeparator untuk mendapatkan pemisah daftar default budaya saat ini. Get-Service Cmdlet mengirim objek layanan ke alur ke ConvertTo-Csv. mengonversi ConvertTo-Csv objek layanan menjadi serangkaian string CSV. String CSV disimpan dalam $Services variabel . ConvertFrom-Csv Cmdlet menggunakan parameter InputObject dan mengonversi string CSV dari $Services variabel. Parameter UseCulture menggunakan pemisah daftar default budaya saat ini.
Saat 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 (;) mengapitnya 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.
| Type: | Char |
| Position: | 1 |
| Default value: | comma (,) |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Header
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.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | PSObject[] |
| 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
Anda dapat menyalurkan string CSV ke cmdlet ini.
Output
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 ToString() metode objek. Tidak ada cara untuk mengekspor metode objek.
Link Terkait
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk