Add-XmlHeaderComment #

ÜBERSICHT #

Fügt einem XML-Dokument einen Kommentar direkt im Kopfbereich hinzu.

SYNTAX #

Add-XmlHeaderComment [[-XmlDoc] <System.Xml.XmlDocument>] [[-CommentText] <string>]
    [<CommonParameters>]

BESCHREIBUNG #

Diese Funktion ergänzt ein bestehendes XmlDocument-Objekt um einen XML-Kommentar. Falls eine XML-Deklaration <?xml version="1.0"?> vorhanden ist, wird der Kommentar direkt danach eingefügt. Andernfalls wird er als erstes Element eingefügt. Der Kommentartext wird vor dem Einfügen automatisch getrimmt. Die Funktion verändert das übergebene XmlDocument und gibt es als Ergebnis zurück.

PARAMETER #

-XmlDoc #

Type: System.Xml.XmlDocument

Das XML-Dokument vom Typ [System.Xml.XmlDocument], dem der Kommentar hinzugefügt werden soll.

-CommentText #

Type: string

Der Text, der als Kommentar im Kopfbereich des Dokuments eingefügt werden soll.

AUSGABEN #

System.Xml.XmlDocument

Das veränderte XML-Dokument mit eingefügtem Kommentar.

BEISPIELE #

# Fügt dem XML einen Kommentar direkt hinter der Deklaration hinzu.
$xml = [xml]'<?xml version="1.0"?><root></root>'
$xml = Add-XmlHeaderComment -XmlDoc $xml -CommentText "Erzeugt durch Export-Skript am 2025-05-15"