info@teknoedu.com
PowerShell

PowerShell’de XML ile Çalışmak: [xml] Türü, XPath, Select-Xml ve Export-Clixml

Yapılandırma dosyaları, olay günlükleri ve eski sistem dışa aktarımları hâlâ XML konuşuyor. PowerShell'in [xml] türüyle okumayı, XPath ile sorgulamayı, düğüm eklemeyi ve nesneleri Export-Clixml ile saklamayı öğrenin.

PowerShell'de XML ile Çalışmak: [xml] Türü, XPath, Select-Xml ve Export-Clixml

JSON’un yükselişine rağmen XML, kurumsal dünyada hâlâ her yerdedir: web.config dosyaları, Görev Zamanlayıcı dışa aktarımları, olay günlüğü kayıtları, Windows yanıt dosyaları (unattend.xml), Group Policy raporları ve pek çok kurumsal yazılımın yapılandırması. PowerShell, XML ile çalışmayı şaşırtıcı derecede kolaylaştıran yerleşik bir [xml] türüne sahiptir. Bu yazıda XML okumayı, sorgulamayı, değiştirmeyi ve PowerShell’e özgü CliXml biçimini ele alıyoruz.

XML dosyası yüklemek

Örnek olarak şu sunucular.xml dosyasını kullanalım:

<?xml version="1.0" encoding="utf-8"?>
<Envanter>
  <Sunucu Ad="SRV-DC01" Rol="DC">
    <IP>10.0.0.10</IP>
    <Isletim>Windows Server 2025</Isletim>
  </Sunucu>
  <Sunucu Ad="SRV-FS01" Rol="Dosya">
    <IP>10.0.0.15</IP>
    <Isletim>Windows Server 2022</Isletim>
  </Sunucu>
</Envanter>

Dosyayı [xml] tür hızlandırıcısıyla yükleyin:

[xml]$xml = Get-Content -Path .\sunucular.xml -Raw

Kodlama bildirimi olan veya büyük XML dosyalarında .NET’in kendi yükleyicisini kullanmak daha doğrudur, çünkü XML’in kendi encoding bildirimine uyar:

$xml = New-Object -TypeName System.Xml.XmlDocument
$xml.Load((Resolve-Path .\sunucular.xml).Path)

Nokta gösterimiyle gezinmek

PowerShell, XML öğelerini ve özniteliklerini sanki nesnenin özellikleriymiş gibi sunar:

$xml.Envanter.Sunucu                 # iki sunucu düğümü
$xml.Envanter.Sunucu[0].Ad           # SRV-DC01 (öznitelik)
$xml.Envanter.Sunucu[0].IP           # 10.0.0.10 (alt öğe)

$xml.Envanter.Sunucu | Select-Object Ad, Rol, IP, Isletim

Son satır, XML’i doğrudan tablo hâlinde görmenizi sağlar. Nokta gösterimi hızlı keşif için mükemmeldir; ancak bir öğe adı .NET’in kendi özellik adlarıyla çakışırsa (örneğin Name veya Item) beklenmedik sonuçlar alabilirsiniz. Bu durumlarda XPath daha güvenilirdir.

XPath ile sorgulamak

XPath, XML belgelerinde yol tarif etmek için kullanılan bir sorgu dilidir. En sık kullanılan ifadeler:

İfade Anlamı
/Envanter/Sunucu Kökten itibaren tam yol
//Sunucu Belgenin herhangi bir yerindeki Sunucu öğeleri
//Sunucu[@Rol='DC'] Rol özniteliği DC olanlar
//Sunucu/@Ad Tüm Ad öznitelikleri
//Sunucu[IP='10.0.0.15'] Alt öğe değerine göre filtre
//Sunucu[contains(Isletim,'2025')] Metin içeren

XPath’i iki şekilde kullanabilirsiniz:

# 1. XmlDocument metotlarıyla
$xml.SelectNodes("//Sunucu[@Rol='DC']")
$xml.SelectSingleNode("//Sunucu[@Ad='SRV-FS01']/IP").InnerText

# 2. Select-Xml cmdlet'iyle (dosyadan doğrudan da çalışır)
Select-Xml -Path .\sunucular.xml -XPath "//Sunucu[contains(Isletim,'2022')]" |
    ForEach-Object { $_.Node.Ad }

Select-Xml her eşleşme için bir sonuç nesnesi döndürür; asıl XML düğümüne .Node özelliğiyle ulaşılır. Birden fazla dosyada arama yapmak için -Path parametresine joker karakter verebilirsiniz.

XPath’in büyük/küçük harfe duyarlı olduğunu unutmayın. //sunucu yazarsanız hiçbir şey bulamazsınız.

Ad alanları (namespace) içeren XML

Gerçek dünyadaki XML dosyalarının çoğu bir ad alanı tanımlar. Örneğin Görev Zamanlayıcı dışa aktarımları xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task" içerir. Bu durumda düz XPath sorguları sonuç döndürmez; ad alanını bir önekle eşlemeniz gerekir:

$ns = @{ t = 'http://schemas.microsoft.com/windows/2004/02/mit/task' }
Select-Xml -Path .\gorev.xml -XPath '//t:Command' -Namespace $ns |
    ForEach-Object { $_.Node.InnerText }

Önek (t) sizin seçtiğiniz herhangi bir addır; önemli olan URI’nin XML’deki ile birebir aynı olmasıdır.

XML’i değiştirmek ve kaydetmek

Var olan bir değeri değiştirmek, yeni düğüm eklemek ve silmek:

# Değer değiştirme
$fs = $xml.SelectSingleNode("//Sunucu[@Ad='SRV-FS01']")
$fs.IP = '10.0.0.16'
$fs.SetAttribute('Rol', 'Dosya-Yazdirma')

# Yeni düğüm ekleme
$yeni = $xml.CreateElement('Sunucu')
$yeni.SetAttribute('Ad', 'SRV-WEB01')
$yeni.SetAttribute('Rol', 'Web')
$ip = $xml.CreateElement('IP')
$ip.InnerText = '10.0.0.20'
[void]$yeni.AppendChild($ip)
[void]$xml.Envanter.AppendChild($yeni)

# Düğüm silme
$dc = $xml.SelectSingleNode("//Sunucu[@Ad='SRV-DC01']")
[void]$dc.ParentNode.RemoveChild($dc)

# Kaydetme (tam yol verin)
$xml.Save((Join-Path -Path $PWD -ChildPath 'sunucular.xml'))

İki önemli not: AppendChild eklenen düğümü döndürdüğü için çıktıyı [void] ile bastırıyoruz, yoksa konsolda gereksiz çıktı görürsünüz. Save() bir .NET metodu olduğundan göreli yolları PowerShell’in bulunduğunuz klasörüne göre değil, işlemin çalışma dizinine göre çözer; her zaman tam yol verin.

XML’i oluşturmanın kısa yolu: Here-string

Küçük ve sabit yapıdaki XML belgeleri için düğüm düğüm oluşturmak yerine bir here-string şablonu kullanmak daha okunurdur:

$ad = 'SRV-APP01'
[xml]$yeniBelge = @"
<Envanter>
  <Sunucu Ad="$ad" Rol="Uygulama"><IP>10.0.0.30</IP></Sunucu>
</Envanter>
"@

Değişken değerleri <, & gibi XML’e özgü karakterler içeriyorsa bu yöntem bozuk XML üretir. Kullanıcı girdisi içeren durumlarda CreateElement ve InnerText kullanmak güvenlidir, çünkü kaçırma işlemini .NET sizin yerinize yapar.

PowerShell nesnelerini saklamak: Export-Clixml

Export-Clixml, herhangi bir PowerShell nesnesini türü ve özellikleriyle birlikte XML olarak seri hâle getirir. Import-Clixml ise geri yükler. CSV’nin aksine iç içe yapılar ve veri türleri korunur.

Get-Service | Export-Clixml -Path .\servisler-dun.xml

# Ertesi gün karşılaştırma
$dun   = Import-Clixml -Path .\servisler-dun.xml
$bugun = Get-Service
Compare-Object -ReferenceObject $dun -DifferenceObject $bugun -Property Name, Status

Geri yüklenen nesneler “seri durumdan çıkarılmış” (deserialized) kopyalardır: özellikleri vardır ama metotları yoktur. Örneğin geri yüklenen bir servis nesnesinde .Stop() çağıramazsınız.

Kimlik bilgisini güvenli saklamak

Export-Clixml‘in Windows’taki önemli bir kullanımı PSCredential nesnelerini saklamaktır. Parola, Windows Veri Koruma API’si (DPAPI) ile şifrelenir:

Get-Credential | Export-Clixml -Path "$env:USERPROFILE\servis-hesabi.xml"
$kimlik = Import-Clixml -Path "$env:USERPROFILE\servis-hesabi.xml"

Bu dosya yalnızca onu oluşturan kullanıcı tarafından, aynı bilgisayarda çözülebilir. Bu yüzden zamanlanmış görevler için dosyayı görevin çalışacağı hesapla oluşturmanız gerekir. Bu yöntem yalnızca Windows’ta şifreleme sağlar; daha esnek bir çözüm için SecretManagement modülüne bakmanızı öneririz.

Olay günlüğü kayıtlarını XML ile okumak

XML bilgisi, Windows olay günlükleriyle çalışırken de işe yarar. Get-WinEvent ile alınan kayıtların Message özelliği okunur bir metindir, ancak içindeki tek tek alanlara ulaşmak zordur. Her olay kaydının ToXml() metodu ise kaydı yapısal XML olarak verir:

$olaylar = Get-WinEvent -FilterHashtable @{ LogName = 'Security'; Id = 4625 } -MaxEvents 20

foreach ($olay in $olaylar) {
    [xml]$x = $olay.ToXml()
    $veri = @{}
    foreach ($d in $x.Event.EventData.Data) { $veri[$d.Name] = $d.'#text' }
    [pscustomobject]@{
        Zaman     = $olay.TimeCreated
        Kullanici = $veri['TargetUserName']
        Kaynak    = $veri['IpAddress']
    }
}

Bu örnek, başarısız oturum açma olaylarından kullanıcı adı ve kaynak IP adresini ayıklar. #text özelliği, bir XML öğesinin metin içeriğine ulaşmanın PowerShell’deki yoludur. Güvenlik günlüğünü okumak için yönetici yetkisi gerektiğini unutmayın.

Sık yapılan hatalar

  • Kodlamayı yok saymak: Get-Content ile okunan XML, dosyanın kendi encoding bildirimini dikkate almayabilir. Türkçe karakterli dosyalarda XmlDocument.Load() daha güvenlidir.
  • Göreli yolla kaydetmek: $xml.Save('.\dosya.xml') beklediğiniz klasöre yazmayabilir.
  • Tek düğümü dizi sanmak: Belgede yalnızca bir Sunucu öğesi varsa $xml.Envanter.Sunucu dizi değil tek nesne döner. @($xml.Envanter.Sunucu).Count ile güvenle sayın.

Sonuç

PowerShell’in [xml] türü, XML belgelerini nokta gösterimiyle keşfetmeyi neredeyse JSON kadar kolay hâle getirir. Daha karmaşık sorgular için XPath’i SelectNodes veya Select-Xml ile kullanın, ad alanı içeren belgelerde -Namespace parametresini unutmayın. Değişiklik yaptıktan sonra Save() metoduna tam yol verin. PowerShell nesnelerini türleriyle saklamak istediğinizde ise Export-Clixml ve Import-Clixml ikilisi, CSV’nin karşılayamadığı ihtiyaçları karşılar.