info@teknoedu.com
PowerShell

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.

PowerShell'de CSV ile Çalışmak: Import-Csv, Export-Csv ve Türkçe Excel Uyumluluğu

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.ServiceController gibi 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-Object kullanın: Nesneyi doğrudan aktarırsanız gereksiz onlarca özellik dosyaya girer. Hangi sütunları istediğinizi açıkça seçin.
  • Format-Table ile birlikte kullanmayın: Get-Process | Format-Table | Export-Csv anlamsı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, -Force eksik 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.