info@teknoedu.com
PowerShell

PowerShell’de Metin Dosyası Okuma ve Yazma: Get-Content, Set-Content ve Kodlama Sorunları

Türkçe karakterler neden "ç" gibi görünüyor? Get-Content, Set-Content, Add-Content ve Out-File ile metin dosyalarını doğru okumayı, büyük dosyalarla verimli çalışmayı ve UTF-8 kodlama karmaşasını çözmeyi anlattık.

PowerShell'de Metin Dosyası Okuma ve Yazma: Get-Content, Set-Content ve Kodlama Sorunları

“Betik çalıştı ama dosyadaki Türkçe karakterler bozuk çıktı.” PowerShell forumlarında belki de en sık rastlanan şikâyet budur. Sorunun kaynağı genellikle dosya kodlamasıdır (encoding) ve Windows PowerShell 5.1 ile PowerShell 7’nin bu konuda farklı varsayılanlara sahip olması işleri daha da karıştırır. Bu yazıda metin dosyalarını okuma ve yazma cmdlet’lerini, büyük dosyalarla verimli çalışmayı ve kodlama sorunlarını kalıcı olarak çözmeyi ele alıyoruz.

Dosya okumak: Get-Content

Get-Content varsayılan olarak dosyayı satır satır okur ve her satırı ayrı bir metin olarak pipeline’a gönderir. Sonuç bir dizi olduğu için satır sayısını almak ya da belirli bir satıra ulaşmak kolaydır.

$satirlar = Get-Content -Path 'C:\Logs\app.log'
$satirlar.Count        # satır sayısı
$satirlar[0]           # ilk satır
$satirlar[-1]          # son satır

Sık kullanılan parametreler:

# İlk 20 satır
Get-Content -Path .\app.log -TotalCount 20

# Son 50 satır
Get-Content -Path .\app.log -Tail 50

# Dosyayı canlı izle (tail -f benzeri), Ctrl+C ile çık
Get-Content -Path .\app.log -Tail 10 -Wait

# Dosyanın tamamını tek bir metin olarak oku
$icerik = Get-Content -Path .\sablon.html -Raw

-Raw parametresi özellikle önemlidir. JSON veya HTML gibi bütün hâlinde işlenmesi gereken içerikleri okurken, ya da çok satırlı bir regex çalıştıracaksanız -Raw kullanın. Aksi hâlde elinizde tek bir metin değil, satırlardan oluşan bir dizi olur.

Dosya yazmak: Set-Content, Add-Content ve Out-File

Yazma için üç temel seçenek vardır:

Cmdlet Davranış Ne zaman?
Set-Content Dosyayı yeniden yazar, nesneleri metne çevirir Düz metin, yapılandırma dosyası
Add-Content Dosyanın sonuna ekler Log satırı eklemek
Out-File Konsolda gördüğünüz biçimlendirilmiş çıktıyı yazar Tablo görünümündeki raporlar
Set-Content -Path .\liste.txt -Value 'Ankara', 'İzmir', 'Bursa'
Add-Content -Path .\liste.txt -Value 'Eskişehir'

Get-Service | Where-Object Status -eq 'Stopped' |
    Out-File -FilePath .\durmus-servisler.txt

Set-Content ile Out-File arasındaki fark ince ama önemlidir. Get-Process | Set-Content dosya.txt her nesnenin ToString() karşılığını yazar ve genellikle işe yaramaz bir sonuç üretir. Out-File ise konsoldaki tablo görünümünü yazar. Yapısal veri saklamak istiyorsanız ikisi de doğru araç değildir; Export-Csv veya ConvertTo-Json kullanın.

> ve >> yönlendirme operatörleri de aslında Out-File ve Out-File -Append gibi davranır.

Kodlama (encoding) neden bu kadar önemli?

Bir metin dosyası diskte baytlar olarak saklanır. “ş” harfinin hangi baytlarla temsil edileceğini kodlama belirler. Dosyayı yazan ve okuyan programlar aynı kodlamada anlaşamazsa “ş” harfi “ÅŸ” gibi görünür.

Karışıklığın asıl nedeni, iki PowerShell sürümünün farklı varsayılanlara sahip olmasıdır:

Durum Windows PowerShell 5.1 PowerShell 7
Set-Content / Add-Content varsayılanı Sistem ANSI kod sayfası (Türkçe Windows’ta windows-1254) UTF-8 (BOM’suz)
Out-File ve > varsayılanı UTF-16 LE (“Unicode”) UTF-8 (BOM’suz)
-Encoding UTF8 sonucu BOM’lu UTF-8 BOM’suz UTF-8
BOM’suz dosya okurken varsayım ANSI UTF-8

Yani 5.1’de > ile oluşturduğunuz bir dosya UTF-16’dır; aynı dosyayı başka bir araç UTF-8 sanarak açarsa her karakterin arasında boşluk görürsünüz. 5.1’de BOM’suz bir UTF-8 dosyayı okursanız Türkçe karakterler bozulur, çünkü 5.1 bu dosyayı ANSI sanır.

Kodlamayı açıkça belirtmek

En güvenli yaklaşım, okurken de yazarken de -Encoding parametresini açıkça yazmaktır.

# Windows PowerShell 5.1: UTF-8 dosya okumak ve yazmak
$veri = Get-Content -Path .\ogrenciler.txt -Encoding UTF8
$veri | Set-Content -Path .\cikti.txt -Encoding UTF8

# PowerShell 7: BOM'lu veya BOM'suz seçmek
Set-Content -Path .\cikti.txt -Value $veri -Encoding utf8BOM
Set-Content -Path .\cikti.txt -Value $veri -Encoding utf8NoBOM

PowerShell 7’de -Encoding parametresi kayıtlı kod sayfalarının adını veya numarasını da kabul eder. Eski bir sistemden gelen Türkçe ANSI dosyayı okumak için:

# PowerShell 7
Get-Content -Path .\eski-sistem.txt -Encoding 1254

Hangi kodlamayı seçmeli? Kısa bir rehber:

  • Excel’de açılacak CSV dosyaları: BOM’lu UTF-8. Excel, BOM yoksa dosyayı yerel kod sayfasıyla açar.
  • Linux araçları, Git depoları, web: BOM’suz UTF-8.
  • Windows PowerShell 5.1’de çalışacak .ps1 dosyaları: Türkçe karakter içeriyorsa BOM’lu UTF-8. 5.1, BOM’suz betikleri ANSI olarak okur ve metin içindeki Türkçe karakterler bozulur.

Varsayılanı tek seferde değiştirmek

Her komuta -Encoding yazmak yerine $PSDefaultParameterValues ile oturum boyunca varsayılan belirleyebilirsiniz. Bunu profil dosyanıza eklemek iyi bir fikirdir.

$PSDefaultParameterValues['Out-File:Encoding']    = 'utf8'
$PSDefaultParameterValues['Set-Content:Encoding'] = 'utf8'
$PSDefaultParameterValues['Add-Content:Encoding'] = 'utf8'
$PSDefaultParameterValues['Export-Csv:Encoding']  = 'utf8'

Konsolda ekrana gelen Türkçe karakterler bozuksa bu dosya kodlamasından farklı bir sorundur; konsolun çıktı kodlamasıyla ilgilidir. [Console]::OutputEncoding ve $OutputEncoding değişkenleri bu davranışı belirler.

Büyük dosyalarla verimli çalışmak

Birkaç gigabaytlık bir log dosyasını Get-Content ile bir değişkene atamak belleği doldurabilir ve çok yavaştır. Birkaç seçenek vardır:

# 1. Pipeline ile akış hâlinde işle (değişkene atama)
Get-Content -Path .\buyuk.log | Where-Object { $_ -like '*ERROR*' } |
    Set-Content -Path .\hatalar.log

# 2. Satırları 1000'lik paketler hâlinde oku (daha hızlı)
Get-Content -Path .\buyuk.log -ReadCount 1000 | ForEach-Object {
    $_ -match 'ERROR'      # $_ burada 1000 satırlık bir dizi
}

# 3. .NET ile satır satır, düşük bellekle
foreach ($satir in [System.IO.File]::ReadLines('C:\Logs\buyuk.log')) {
    if ($satir.Contains('ERROR')) { $satir }
}

[System.IO.File]::ReadLines göreli yolları PowerShell’in değil, işlemin çalışma dizinine göre çözer. Bu yüzden .NET metotlarına her zaman tam yol verin; gerekirse (Resolve-Path .\dosya.log).Path ile tam yolu alın.

Arama yapacaksanız Select-String de büyük dosyalarda Get-Content | Where-Object zincirinden genellikle daha hızlıdır.

Sık yapılan hatalar

  • Dosyayı okurken aynı dosyaya yazmak: Get-Content a.txt | Set-Content a.txt dosyayı boşaltabilir veya hata verir. İçeriği önce parantez içinde tamamen okuyun: (Get-Content a.txt) -replace 'x','y' | Set-Content a.txt.
  • -NoNewline ihtiyacı: Set-Content sona satır sonu ekler. Bazı yapılandırma dosyaları veya imza kontrolleri için -NoNewline kullanın.
  • Satır sonları: Windows CRLF, Linux LF kullanır. Platformlar arası dosyalarda bu fark Git ve bazı araçlarda sorun çıkarabilir.
  • Kodlamayı tahmin etmek: Bir dosyanın kodlamasından emin değilseniz ilk baytlara bakın: Get-Content .\dosya.txt -AsByteStream -TotalCount 3 (PowerShell 7). EF BB BF UTF-8 BOM’unu, FF FE UTF-16 LE’yi gösterir.

Sonuç

Metin dosyalarıyla çalışmak PowerShell’in en temel işlerinden biridir ve doğru yapıldığında oldukça basittir. Get-Content ile okurken -Raw, -Tail ve -ReadCount gibi parametreleri ihtiyaca göre seçin; yazarken içeriğin türüne göre Set-Content, Add-Content veya Out-File kullanın. Kodlama konusunda tek altın kural şudur: varsayılana güvenmeyin, -Encoding parametresini açıkça yazın. Özellikle hem 5.1 hem 7 ortamında çalışan betiklerde bu küçük alışkanlık, Türkçe karakter sorunlarının neredeyse tamamını ortadan kaldırır.