Private/Add-XmlChildElement.ps1

<#
    ProvisioningTools — Automates creation of Windows provisioning packages.
    Copyright (C) 2022 David Haymond.

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program. If not, see <https://www.gnu.org/licenses/>.
#>


function Add-XmlChildElement {
    [CmdletBinding()]
    [OutputType($null, [System.Xml.XmlNode])]
    param (
        [Parameter(
            Mandatory = $true,
            Position = 0
        )]
        [System.Xml.XmlNode] $Parent,

        [Parameter(
            Mandatory = $true,
            Position = 1
        )]
        [string] $Name,

        [Parameter(
            Position = 2
        )]
        [string] $InnerText,

        [string] $NamespaceUri,

        [switch] $PassThru
    )
    if (!$NamespaceUri) {
        $NamespaceUri = $Parent.NamespaceURI
    }
    if ($Parent -is [System.Xml.XmlDocument]) {
        $document = $Parent
    }
    else {
        $document = $Parent.OwnerDocument
    }
    $child = $document.CreateElement($Name, $NamespaceUri)
    if ($InnerText) {
        $child.InnerText = $InnerText
    }
    $Parent.AppendChild($child) | Out-Null
    if ($PassThru) {
        $child
    }
}