info@teknoedu.com
PowerShell

PowerShell ile Şık HTML Raporlar: ConvertTo-Html, CSS ve Koşullu Renklendirme ile Yöneticilere Rapor

CSV dosyası teknik ekip için yeterli olabilir ama yöneticiler tek bakışta anlaşılan raporlar ister. ConvertTo-Html, gömülü CSS ve koşullu renklendirme ile M365 verilerinden e-postaya hazır HTML raporlar üretiyoruz.

PowerShell ile Şık HTML Raporlar: ConvertTo-Html, CSS ve Koşullu Renklendirme ile Yöneticilere Rapor

Graph, Exchange veya Azure’dan topladığınız verileri CSV’ye aktarmak teknik açıdan yeterlidir. Ancak raporu okuyan kişi bir müdür, bir okul yöneticisi ya da güvenlik kurulu üyesiyse, Excel’de sütun genişletmekle uğraşmak istemez. Tek bakışta “her şey yolunda mı?” sorusuna cevap veren, kritik satırları kırmızıyla vurgulayan bir sayfa ister. PowerShell’in yerleşik ConvertTo-Html cmdlet’i biraz CSS ile birleştiğinde bunu ek modül gerektirmeden yapar.

ConvertTo-Html’in temel kullanımı

Get-Service | Select-Object -First 5 Name, Status, StartType |
    ConvertTo-Html -Title "Servis Raporu" | Out-File .\servis.html -Encoding utf8

Bu komut tam bir HTML sayfası üretir, ama görünümü oldukça sadedir. Asıl gücü şu parametrelerde yatar:

Parametre İşlevi
-Fragment Yalnızca <table> parçası üretir; birden fazla tabloyu tek sayfada birleştirmek için kullanılır
-Head <head> içine CSS veya meta etiketleri ekler
-PreContent / -PostContent Tablonun önüne ve arkasına HTML ekler (başlık, açıklama, alt bilgi)
-Property Hangi sütunların yer alacağını belirler
-As List Tablo yerine dikey liste düzeni (tek kayıtlık özetler için ideal)
-Title Sayfa başlığı (-Head ile birlikte kullanılırsa yok sayılır)

Adım 1: Bir stil şablonu hazırlamak

Rapor e-postayla gönderilecekse harici CSS dosyası kullanamazsınız; stil sayfanın içinde olmalıdır:

$stil = @"
<meta charset="utf-8">
<title>Uygulama Raporu</title>
<style>
  body  { font-family: Segoe UI, Arial, sans-serif; font-size: 13px; color: #222; margin: 20px; }
  h1    { font-size: 20px; color: #0f4c81; }
  h2    { font-size: 16px; color: #0f4c81; margin-top: 28px; }
  table { border-collapse: collapse; width: 100%; margin-bottom: 12px; }
  th    { background: #0f4c81; color: #fff; text-align: left; padding: 6px 8px; }
  td    { border-bottom: 1px solid #ddd; padding: 5px 8px; }
  tr:nth-child(even) { background: #f6f8fa; }
  .kritik { background: #fde2e1 !important; }
  .uyari  { background: #fff4ce !important; }
  .ozet td { font-weight: bold; }
  .alt  { color: #777; font-size: 11px; margin-top: 24px; }
</style>
"@

Here-string (@" ... "@) kullanmak, çok satırlı HTML’i rahatça yazmanızı sağlar. charset etiketi Türkçe karakterlerin doğru görünmesi için önemlidir.

Adım 2: Veriyi hazırlamak

Örnek olarak uygulama kayıtlarının gizli anahtar sürelerini raporlayalım (verinin nereden geldiği önemli değil; her türlü nesne listesi aynı şekilde çalışır):

Connect-MgGraph -Scopes "Application.Read.All" -NoWelcome
$bugun = Get-Date

$veri = Get-MgApplication -All -Property DisplayName, PasswordCredentials | ForEach-Object {
    $app = $_
    $app.PasswordCredentials | ForEach-Object {
        [pscustomobject]@{
            Uygulama = $app.DisplayName
            Aciklama = $_.DisplayName
            Bitis    = $_.EndDateTime.ToString("dd.MM.yyyy")
            KalanGun = [int]($_.EndDateTime - $bugun).TotalDays
        }
    }
} | Sort-Object KalanGun

Tarihi raporda okunur biçime çevirmek (dd.MM.yyyy) küçük ama fark yaratan bir ayrıntıdır.

Adım 3: Parçaları üretmek

Bir özet tablosu ve bir ayrıntı tablosu oluşturalım:

$ozet = [pscustomobject]@{
    "Toplam anahtar"       = $veri.Count
    "Süresi dolmuş"        = ($veri | Where-Object KalanGun -lt 0).Count
    "30 gün içinde dolacak"= ($veri | Where-Object { $_.KalanGun -ge 0 -and $_.KalanGun -le 30 }).Count
}

$ozetHtml = $ozet | ConvertTo-Html -As List -Fragment -PreContent "<h2>Özet</h2>"
$ozetHtml = $ozetHtml -replace '<table>', '<table class="ozet">'

$detayHtml = $veri | ConvertTo-Html -Fragment -PreContent "<h2>Ayrıntılar</h2>" |
    Out-String

ConvertTo-Html bir metin dizisi döndürür. Bir sonraki adımda satır satır işlem yapacağımız için ayrıntı tablosunu Out-String ile tek metne çevirdik.

Adım 4: Koşullu renklendirme

ConvertTo-Html satırlara sınıf eklemeyi doğrudan desteklemez. Yaygın ve güvenilir yöntem, üretilen HTML’i satır satır dolaşıp KalanGun hücresine göre <tr> etiketine sınıf eklemektir:

$satirlar = $detayHtml -split "`r?`n" | ForEach-Object {
    if ($_ -match '<tr><td>.*</td><td>(-?\d+)</td></tr>') {
        $gun = [int]$Matches[1]
        if     ($gun -lt 0)   { $_ -replace '^<tr>', '<tr class="kritik">' }
        elseif ($gun -le 30)  { $_ -replace '^<tr>', '<tr class="uyari">' }
        else                  { $_ }
    }
    else { $_ }
}
$detayHtml = $satirlar -join "`n"

Düzenli ifade, son hücredeki sayıyı yakalar; bu yüzden KalanGun sütununu nesnede en sona koymak işi kolaylaştırır. Daha karmaşık raporlarda her satır için HTML’i kendiniz üretmek (bir foreach ile <tr> dizesi oluşturmak) daha esnek bir alternatiftir.

Güvenlik notu: ConvertTo-Html hücre değerlerindeki <, > ve & karakterlerini kodlar. Kendi HTML’inizi elle üretirseniz kullanıcıdan gelen metinleri [System.Net.WebUtility]::HtmlEncode() ile kodlamayı unutmayın.

Adım 5: Sayfayı birleştirmek

$baslik = "<h1>Uygulama Kimlik Bilgisi Raporu</h1><p>Oluşturulma: $((Get-Date).ToString('dd.MM.yyyy HH:mm'))</p>"
$altBilgi = "<p class='alt'>Bu rapor otomatik olarak oluşturulmuştur. Sorular için BT ekibine yazın.</p>"

$sayfa = ConvertTo-Html -Head $stil `
    -Body ($baslik + ($ozetHtml -join "`n") + $detayHtml + $altBilgi)

$sayfa | Out-File .\uygulama-raporu.html -Encoding utf8
Invoke-Item .\uygulama-raporu.html

-Head kullanıldığında -Title parametresi yok sayılır; bu yüzden sayfa başlığını stil şablonunun içine <title> etiketiyle koyduk. -Body parametresi, parçaları birleştirip tek bir sayfa oluşturmanın en temiz yoludur. Invoke-Item dosyayı varsayılan tarayıcıda açar.

E-postada dikkat edilecekler

HTML raporu e-posta gövdesi olarak gönderecekseniz:

  • Outlook masaüstü CSS’in bir kısmını desteklemez. nth-child gibi seçiciler göz ardı edilebilir; kritik renklendirmeyi sınıf yerine satır üzerinde satır içi stil (style="background:#fde2e1") ile vermek daha güvenlidir.
  • Büyük tabloları gövdeye koymak yerine özet tabloyu gövdeye, ayrıntıyı ek olarak CSV dosyasına koyun.
  • Görselleri harici bağlantıyla değil, mümkünse hiç kullanmadan tasarlayın; birçok istemci harici görselleri varsayılan olarak engeller.

Alternatif: PSWriteHTML modülü

Sıralanabilir, aranabilir tablolar ve grafikler istiyorsanız topluluk tarafından geliştirilen PSWriteHTML modülü güçlü bir seçenektir. Ancak ürettiği sayfalar JavaScript kullandığı için e-posta gövdesinde çalışmaz; daha çok bir dosya paylaşımında veya SharePoint’te açılacak panolar için uygundur. Basit, e-posta dostu raporlarda yerleşik ConvertTo-Html hâlâ en az bağımlılıklı çözümdür.

Sık yapılan hatalar

  • -Fragment kullanmadan birleştirmek: Her tablo ayrı bir <html> sayfası olarak üretilir ve iç içe sayfalar oluşur.
  • Kodlama sorunu: Windows PowerShell 5.1’de Out-File varsayılan olarak UTF-16 yazar; -Encoding utf8 belirtin.
  • Ham nesneyi tabloya vermek: Graph nesnelerinde onlarca sütun çıkar. Her zaman önce Select-Object veya [pscustomobject] ile sütunları seçin.

Sonuç

Biraz CSS ve birkaç satır düzenli ifadeyle, PowerShell’in yerleşik ConvertTo-Html cmdlet’i yöneticilerin gerçekten okuduğu raporlar üretir. Özet tablo, renklendirilmiş ayrıntı ve açık bir alt bilgiyle hazırlanan bir HTML sayfası; zamanlanmış görev veya Azure Automation ile birleştiğinde, her hafta kendiliğinden gelen profesyonel bir durum raporuna dönüşür.