PowerShell Betiklerinde Hata Yönetimi: try/catch/finally, ErrorAction ve Loglama
Gece çalışan bir betik hata verdiğinde sessizce devam etmesi mi, durması mı gerekir? PowerShell'de sonlandırıcı ve sonlandırıcı olmayan hataları, try/catch/finally yapısını, ErrorAction tercihlerini ve sağlam bir loglama düzenini örneklerle anlattık.

Elle çalıştırdığınız bir komut hata verdiğinde kırmızı yazıyı görür ve müdahale edersiniz. Ama gece 03:00’te zamanlanmış görev olarak çalışan bir betik hata verdiğinde kimse görmez. Kötü yazılmış bir betik ya hatayı yok sayıp yanlış verilerle devam eder ya da yarıda kalıp sistemi tutarsız bir durumda bırakır.
Bu yazıda PowerShell’de hataları doğru yakalamayı, yönetmeyi ve kayda geçirmeyi anlatıyorum.
İki tür hata
PowerShell’de hataların iki türü vardır ve bu ayrımı anlamak her şeyin temelidir:
| Sonlandırıcı olmayan (non-terminating) | Sonlandırıcı (terminating) | |
|---|---|---|
| Davranış | Hata yazılır, komut sonraki öğeyle devam eder | Komut/betik durur |
| Örnek | Get-ChildItem erişilemeyen bir klasörü atlar |
Söz dizimi hatası, throw, .NET istisnası |
| try/catch yakalar mı? | Hayır (varsayılan olarak) | Evet |
En sık yapılan hata şudur:
try {
Get-Item "C:\olmayan-dosya.txt"
}
catch {
Write-Host "Dosya bulunamadı" # BU ÇALIŞMAZ!
}
Get-Item sonlandırıcı olmayan bir hata ürettiği için catch bloğu tetiklenmez. Çözüm:
try {
Get-Item "C:\olmayan-dosya.txt" -ErrorAction Stop
}
catch {
Write-Host "Dosya bulunamadı: $($_.Exception.Message)"
}
-ErrorAction Stop, sonlandırıcı olmayan hatayı sonlandırıcıya dönüştürür ve catch çalışır.
ErrorAction seçenekleri
| Değer | Davranış |
|---|---|
Continue (varsayılan) |
Hatayı gösterir, devam eder |
Stop |
Hatayı sonlandırıcı yapar |
SilentlyContinue |
Hatayı göstermez, devam eder ($Error değişkenine yine de kaydeder) |
Ignore |
Hatayı göstermez ve kaydetmez |
Inquire |
Kullanıcıya sorar |
Betik genelinde varsayılanı değiştirmek için:
$ErrorActionPreference = 'Stop'
Otomasyon betiklerinde bu satırı en üste koymak, hataların sessizce geçilmesini önleyen iyi bir alışkanlıktır. Hatayı bilinçli olarak yok saymak istediğiniz tek komutta ise -ErrorAction SilentlyContinue kullanırsınız.
Dikkat:
SilentlyContinue‘yu her yere serpiştirmek, hataları “çözmez”, sadece gizler. Yalnızca hatanın beklendiği ve önemsiz olduğu durumlarda kullanın.
try / catch / finally
try {
# Hata çıkabilecek kod
$baglanti = Connect-Something -ErrorAction Stop
Do-Work -ErrorAction Stop
}
catch {
# Hata olursa
Write-Error "İşlem başarısız: $($_.Exception.Message)"
}
finally {
# Her durumda çalışır (hata olsa da olmasa da)
if ($baglanti) { Disconnect-Something }
}
finally, bağlantı kapatma, geçici dosya silme, kilit kaldırma gibi temizlik işleri için idealdir.
Hata nesnesi: $_
catch bloğunda $_ (ya da $PSItem) bir ErrorRecord nesnesidir:
catch {
$_.Exception.Message # Hata mesajı
$_.Exception.GetType().FullName # İstisna türü
$_.InvocationInfo.ScriptLineNumber # Hatanın oluştuğu satır
$_.InvocationInfo.Line # Hatalı satırın içeriği
$_.ScriptStackTrace # Çağrı yığını
}
PowerShell 7’de Get-Error komutu son hatayı tüm ayrıntılarıyla okunaklı şekilde gösterir.
Hata türüne göre farklı davranmak
try {
$icerik = Get-Content "\\sunucu\paylasim\rapor.csv" -ErrorAction Stop
}
catch [System.Management.Automation.ItemNotFoundException] {
Write-Warning "Dosya bulunamadı, boş rapor oluşturuluyor."
$icerik = @()
}
catch [System.UnauthorizedAccessException] {
Write-Error "Erişim reddedildi. Hizmet hesabının izinlerini kontrol edin."
throw
}
catch {
Write-Error "Beklenmeyen hata: $($_.Exception.Message)"
throw
}
throw ile hatayı yeniden fırlatmak, üst katmanın (ya da zamanlanmış görevin) hatayı fark etmesini sağlar.
Kendi hatalarınızı üretmek
function Get-KullaniciRaporu {
param([string]$Departman)
if ([string]::IsNullOrWhiteSpace($Departman)) {
throw "Departman parametresi boş olamaz."
}
# ...
}
Parametre doğrulamayı ise çoğu zaman öznitelikler daha temiz yapar:
param(
[Parameter(Mandatory)]
[ValidateNotNullOrEmpty()]
[string]$Departman,
[ValidateRange(1, 365)]
[int]$Gun = 30,
[ValidateSet("CSV", "HTML", "JSON")]
[string]$Bicim = "CSV"
)
Döngülerde hata yönetimi
Toplu işlemlerde bir öğedeki hata tüm işlemi durdurmamalı:
$sonuclar = foreach ($kullanici in $kullanicilar) {
try {
Set-Something -Identity $kullanici -ErrorAction Stop
[pscustomobject]@{ Kullanici = $kullanici; Durum = "Başarılı"; Hata = $null }
}
catch {
[pscustomobject]@{ Kullanici = $kullanici; Durum = "Hata"; Hata = $_.Exception.Message }
}
}
$hatalar = $sonuclar | Where-Object Durum -eq "Hata"
if ($hatalar) {
Write-Warning "$($hatalar.Count) kayıtta hata oluştu."
$hatalar | Export-Csv "hatalar.csv" -NoTypeInformation -Encoding utf8
}
Yeniden deneme (retry) mantığı
Ağ ve bulut API’lerinde geçici hatalar (zaman aşımı, kısıtlama) sık görülür. Basit bir yeniden deneme fonksiyonu:
function Invoke-WithRetry {
param(
[Parameter(Mandatory)][scriptblock]$Islem,
[int]$Deneme = 3,
[int]$BeklemeSaniye = 5
)
for ($i = 1; $i -le $Deneme; $i++) {
try {
return & $Islem
}
catch {
if ($i -eq $Deneme) { throw }
Write-Warning "Deneme $i başarısız: $($_.Exception.Message). $BeklemeSaniye sn sonra tekrar denenecek."
Start-Sleep -Seconds ($BeklemeSaniye * $i) # Artan bekleme
}
}
}
$veri = Invoke-WithRetry -Islem { Invoke-RestMethod "https://api.ornek.com/veri" -ErrorAction Stop }
Loglama: Ne oldu, ne zaman, neden?
Basit log fonksiyonu
$LogDosyasi = "C:\Scripts\Logs\{0}-{1:yyyyMMdd}.log" -f $MyInvocation.MyCommand.Name, (Get-Date)
function Write-Log {
param(
[Parameter(Mandatory)][string]$Mesaj,
[ValidateSet("BILGI","UYARI","HATA")][string]$Seviye = "BILGI"
)
$satir = "{0:yyyy-MM-dd HH:mm:ss} [{1}] {2}" -f (Get-Date), $Seviye, $Mesaj
Add-Content -Path $LogDosyasi -Value $satir -Encoding utf8
switch ($Seviye) {
"UYARI" { Write-Warning $Mesaj }
"HATA" { Write-Host $Mesaj -ForegroundColor Red }
default { Write-Verbose $Mesaj }
}
}
Write-Log "Betik başladı"
Write-Log "3 kullanıcı bulunamadı" -Seviye UYARI
Transcript
Tüm konsol çıktısını kayda almak için:
Start-Transcript -Path "C:\Scripts\Logs\transcript-$(Get-Date -Format yyyyMMdd-HHmm).txt"
# ... betik ...
Stop-Transcript
Transcript, hata ayıklama için çok değerlidir; ancak çıktıda parola ya da kişisel veri varsa log dosyalarının da korunması gerektiğini unutmayın.
Eski logları temizlemek
Get-ChildItem "C:\Scripts\Logs" -Filter *.log | Where-Object LastWriteTime -lt (Get-Date).AddDays(-30) | Remove-Item
Çıkış kodları
Zamanlanmış görevler ve diğer otomasyon araçları, betiğin başarılı olup olmadığını çıkış koduna bakarak anlar:
try {
# ... ana işlem ...
exit 0 # Başarılı
}
catch {
Write-Log "Kritik hata: $($_.Exception.Message)" -Seviye HATA
exit 1 # Başarısız
}
Sağlam bir betik şablonu
#Requires -Version 7.0
[CmdletBinding(SupportsShouldProcess)]
param(
[Parameter(Mandatory)][string]$Hedef
)
$ErrorActionPreference = 'Stop'
Set-StrictMode -Version Latest
# Write-Log fonksiyonu burada...
try {
Write-Log "Başladı. Hedef: $Hedef"
if ($PSCmdlet.ShouldProcess($Hedef, "İşlem yap")) {
# ... asıl iş ...
}
Write-Log "Başarıyla tamamlandı."
exit 0
}
catch {
Write-Log "HATA (satır $($_.InvocationInfo.ScriptLineNumber)): $($_.Exception.Message)" -Seviye HATA
exit 1
}
finally {
# Bağlantıları kapat, geçici dosyaları sil
}
Set-StrictMode -Version Latest: Tanımlanmamış değişken kullanımı gibi hataları yakalar.SupportsShouldProcess: Betiğinize otomatik olarak-WhatIfve-Confirmdesteği ekler.
Sonuç
Sağlam bir PowerShell betiği, işlerin yolunda gittiği durumdan çok, ters gittiği durum için tasarlanır. -ErrorAction Stop ile hataları yakalanabilir hale getirin, try/catch/finally ile yönetin, döngülerde bir hatanın her şeyi durdurmasına izin vermeyin ve her şeyi zaman damgalı loglara yazın. Gece çalışan betiğinizin sabah size ne olduğunu anlatabilmesi, iyi hata yönetiminin en somut ölçüsüdür.


