info@teknoedu.com
PowerShell

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.

PowerShell Betiklerinde Hata Yönetimi: try/catch/finally, ErrorAction ve Loglama

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 -WhatIf ve -Confirm desteğ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.