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.

“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.txtdosyayı boşaltabilir veya hata verir. İçeriği önce parantez içinde tamamen okuyun:(Get-Content a.txt) -replace 'x','y' | Set-Content a.txt. -NoNewlineihtiyacı:Set-Contentsona satır sonu ekler. Bazı yapılandırma dosyaları veya imza kontrolleri için-NoNewlinekullanın.- Satır sonları: Windows
CRLF, LinuxLFkullanı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 BFUTF-8 BOM’unu,FF FEUTF-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.


