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.

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-Htmlhü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-childgibi 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
-Fragmentkullanmadan 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-Filevarsayılan olarak UTF-16 yazar;-Encoding utf8belirtin. - Ham nesneyi tabloya vermek: Graph nesnelerinde onlarca sütun çıkar. Her zaman önce
Select-Objectveya[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.


