PowerShell’de CSV ile Çalışmak: Import-Csv, Export-Csv ve Türkçe Excel Uyumluluğu
Excel'de tek sütuna yığılan veriler, bozuk Türkçe karakterler, metin olarak kalan sayılar... Import-Csv ve Export-Csv ile CSV dosyalarını doğru okumayı, dönüştürmeyi ve Türkçe Excel ile sorunsuz paylaşmayı anlattık.

CSV, sistem yöneticisinin ortak dilidir. İnsan kaynaklarından gelen kullanıcı listesi, muhasebeden gelen cihaz envanteri, başka bir sistemden alınan dışa aktarım… Çoğu zaman elinize bir CSV dosyası tutuşturulur. PowerShell’in CSV desteği çok güçlüdür, çünkü her satırı özellikleri olan bir nesneye dönüştürür. Ancak Türkçe Windows ve Excel ile çalışırken ayırıcı ve kodlama gibi birkaç tuzak vardır. Bu yazıda hepsini ele alıyoruz.
Import-Csv: Satırlar nesneye dönüşür
Aşağıdaki gibi bir personel.csv dosyamız olsun:
Ad,Soyad,Departman,Puan
Ayşe,Yılmaz,Muhasebe,87
Mehmet,Kaya,BT,92
Zeynep,Demir,BT,78
Import-Csv ilk satırı başlık olarak kullanır ve her satırı bir nesneye çevirir:
$personel = Import-Csv -Path .\personel.csv -Encoding UTF8
$personel | Format-Table
$personel | Where-Object Departman -eq 'BT'
$personel[0].Soyad # Yılmaz
$personel.Count # 3
Artık bu veriyle diğer PowerShell nesneleriyle çalışır gibi çalışabilirsiniz: filtreleyebilir, sıralayabilir, gruplayabilir ya da her satır için bir hesap oluşturabilirsiniz.
Ayırıcı sorunu: Virgül mü, noktalı virgül mü?
Türkçe bölge ayarlarında ondalık ayırıcı virgül olduğu için Excel, CSV dosyalarında liste ayırıcısı olarak noktalı virgül kullanır. Excel’den “CSV olarak kaydet” ile alınan bir dosyayı varsayılan ayarlarla içe aktarırsanız tüm satır tek bir sütuna yığılır.
İki çözüm vardır:
# 1. Ayırıcıyı açıkça belirtmek
Import-Csv -Path .\excelden.csv -Delimiter ';'
# 2. Sistemin bölge ayarlarındaki liste ayırıcısını kullanmak
Import-Csv -Path .\excelden.csv -UseCulture
Mevcut liste ayırıcısını görmek için (Get-Culture).TextInfo.ListSeparator komutunu çalıştırabilirsiniz. Ancak betik farklı bölge ayarlarına sahip bir sunucuda çalışacaksa -UseCulture yerine -Delimiter ile açıkça belirtmek daha öngörülebilirdir.
Başlıksız dosyalar ve sütun adları
Bazı sistemler başlık satırı olmadan veri üretir. Bu durumda -Header ile sütun adlarını siz verirsiniz:
Import-Csv -Path .\ham.csv -Header 'Sicil','AdSoyad','Eposta' -Delimiter ';'
Başlıklarda boşluk veya Türkçe karakter varsa özelliğe tırnakla erişmeniz gerekir: $satir.'Doğum Tarihi'. Daha temiz bir yol, içe aktarırken sütunları yeniden adlandırmaktır:
Import-Csv .\liste.csv -Delimiter ';' | Select-Object @{n='DogumTarihi'; e={$_.'Doğum Tarihi'}}, Ad, Soyad
Her şey metindir: Tür dönüşümü
Import-Csv ile gelen tüm değerler metin türündedir. Bu, sıralama ve karşılaştırmalarda sinsi hatalara yol açar:
$personel | Sort-Object Puan # "78","87","92" metin sıralaması
'100' -gt '92' # False! (metin karşılaştırması)
Sayısal işlem yapmadan önce dönüştürün:
$personel | Sort-Object { [int]$_.Puan } -Descending
$personel | ForEach-Object {
$_.Puan = [int]$_.Puan
$_
} | Measure-Object -Property Puan -Average -Maximum
Tarihleri dönüştürürken de dikkatli olun. "05.03.2026" gibi bir değer bölge ayarına göre 5 Mart ya da 3 Mayıs olarak yorumlanabilir. Biçim belliyse [datetime]::ParseExact() kullanın.
Export-Csv: Nesneleri dosyaya yazmak
Herhangi bir nesne koleksiyonunu CSV’ye yazmak tek satırdır:
Get-Service | Select-Object Name, DisplayName, Status, StartType |
Export-Csv -Path .\servisler.csv -NoTypeInformation -Encoding UTF8
Birkaç önemli ayrıntı:
-NoTypeInformation: Windows PowerShell 5.1, dosyanın ilk satırına#TYPE System.ServiceProcess.ServiceControllergibi bir satır ekler. Bu parametre o satırı engeller. PowerShell 6 ve sonrasında bu zaten varsayılan davranıştır, ancak iki sürümde de çalışacak betiklerde yazmanın zararı yoktur.Select-Objectkullanın: Nesneyi doğrudan aktarırsanız gereksiz onlarca özellik dosyaya girer. Hangi sütunları istediğinizi açıkça seçin.Format-Tableile birlikte kullanmayın:Get-Process | Format-Table | Export-Csvanlamsız biçimlendirme nesneleri üretir.Format-*cmdlet’leri pipeline’ın her zaman en sonunda olmalıdır.-Append: Var olan dosyanın sonuna ekler. Sütunların aynı olması gerekir; değilse hata alırsınız,-Forceeksik sütunları boş geçerek yazar.
Türkçe Excel’de düzgün açılan CSV üretmek
Ürettiğiniz dosya bir yöneticiye gidecek ve Excel’de çift tıklanarak açılacaksa iki koşulu sağlamalısınız: noktalı virgül ayırıcı ve BOM’lu UTF-8 kodlama.
# Windows PowerShell 5.1 (UTF8 zaten BOM'lu yazar)
$rapor | Export-Csv -Path .\rapor.csv -NoTypeInformation -Delimiter ';' -Encoding UTF8
# PowerShell 7 (varsayılan UTF-8 BOM'suzdur, açıkça belirtin)
$rapor | Export-Csv -Path .\rapor.csv -Delimiter ';' -Encoding utf8BOM
BOM olmadan Excel dosyayı yerel kod sayfasıyla açar ve “Ayşe” yerine “AyÅŸe” görürsünüz. Tek bir parametre farkı, raporu alan kişinin “bu betik bozuk” demesini engeller.
PowerShell 7’de tırnak denetimi
PowerShell 7’de Export-Csv ve ConvertTo-Csv için tırnakları denetleyen yeni parametreler vardır. Varsayılan olarak tüm alanlar çift tırnak içine alınır. Bunu değiştirmek için:
# Yalnızca gerektiğinde (ayırıcı, tırnak veya satır sonu içeren alanlarda) tırnak kullan
$rapor | Export-Csv .\rapor.csv -UseQuotes AsNeeded
# Yalnızca belirli sütunları tırnakla
$rapor | Export-Csv .\rapor.csv -QuoteFields 'Aciklama'
Bu, CSV’yi tırnak beklemeyen eski bir sisteme aktarırken işe yarar.
Dosya olmadan CSV: ConvertTo-Csv ve ConvertFrom-Csv
Bazen CSV verisi bir dosyada değil, bir değişkende ya da bir API yanıtında gelir. ConvertFrom-Csv metni nesneye, ConvertTo-Csv ise nesneyi metne çevirir:
$metin = @"
Sunucu;Rol
SRV01;DC
SRV02;Dosya
"@
$sunucular = $metin | ConvertFrom-Csv -Delimiter ';'
# Panoya CSV olarak kopyala, Excel'e yapıştır
Get-Process | Select-Object -First 5 Name, Id, CPU |
ConvertTo-Csv -Delimiter "`t" -NoTypeInformation | Set-Clipboard
Son örnekte sekme ayırıcı kullandığımız için Excel’e yapıştırılan veri doğrudan sütunlara ayrılır.
Uygulama: CSV’den rapor üretmek
Bir okulun öğrenci not dosyasından şube bazında ortalama çıkarıp yeni bir CSV oluşturalım:
$notlar = Import-Csv -Path .\notlar.csv -Delimiter ';' -Encoding UTF8
$ozet = $notlar | Group-Object Sube | ForEach-Object {
$puanlar = $_.Group | ForEach-Object { [double]$_.Not }
$olcum = $puanlar | Measure-Object -Average -Maximum -Minimum
[pscustomobject]@{
Sube = $_.Name
OgrenciSay = $_.Count
Ortalama = [math]::Round($olcum.Average, 1)
EnYuksek = $olcum.Maximum
EnDusuk = $olcum.Minimum
}
}
$ozet | Sort-Object Ortalama -Descending |
Export-Csv -Path .\sube-ozet.csv -NoTypeInformation -Delimiter ';' -Encoding UTF8
Not sütununda 85,5 gibi virgüllü ondalık değerler varsa [double] dönüşümü kültüre bağlı davranmayabilir. Bu durumda [double]::Parse($_.Not, [cultureinfo]'tr-TR') kullanmak güvenlidir.
Sık karşılaşılan sorunlar
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Tüm veri tek sütunda | Ayırıcı uyuşmuyor | -Delimiter ';' |
| Türkçe karakterler bozuk | Kodlama uyuşmuyor | -Encoding UTF8 / utf8BOM |
| Sıralama yanlış | Değerler metin | [int] veya [double] dönüşümü |
İlk satırda #TYPE |
5.1 varsayılanı | -NoTypeInformation |
| Özellik adı bulunamıyor | Başlıkta boşluk veya gizli BOM | Tırnakla erişin, kodlamayı kontrol edin |
Sonuç
CSV dosyaları PowerShell’de birinci sınıf vatandaştır: Import-Csv ile nesneye dönüşür, pipeline’da işlenir ve Export-Csv ile yeniden dosyaya yazılır. Türkçe ortamda başarının anahtarı üç parametrede gizlidir: -Delimiter, -Encoding ve 5.1 için -NoTypeInformation. Bunlara bir de sayı ve tarihlerin metin olarak geldiğini hatırlama alışkanlığını eklerseniz, CSV ile çalışan betikleriniz hem doğru sonuç verir hem de Excel kullanıcılarını memnun eder.


