PowerShell V5脚本模块中如何引用FileList内的XDT文件？

嘿，针对你这个问题，我刚好在做类似的PowerShell配置模块时踩过坑，给你几个靠谱的解决方案，完全适配PowerShell 5的脚本模块场景：

方法1：利用模块的ModuleBase属性获取根路径（推荐） #

这是最可靠的方式，不管你的模块是安装在本地文件夹、PowerShell Gallery目录还是其他位置，ModuleBase都会准确指向模块清单（.psd1）所在的根目录。你只需要提前规划好XDT文件在模块内的相对路径，然后用Join-Path拼接成绝对路径即可。

举个例子，假设你的模块结构是这样的：

MyConfigModule/
├─ MyConfigModule.psd1
├─ MyConfigModule.psm1
└─ XDTTransforms/
   ├─ AppConfig.xdt
   └─ WebConfig.xdt

在模块的函数里可以这么写：

function Invoke-AppConfigTransformation {
    param(
        [Parameter(Mandatory)]
        [string]$TargetXmlPath
    )

    # 获取模块的根目录
    $moduleRoot = $MyInvocation.MyCommand.Module.ModuleBase

    # 拼接XDT文件的绝对路径（根据你的实际相对路径调整）
    $xdtFile = Join-Path -Path $moduleRoot -ChildPath "XDTTransforms\AppConfig.xdt"

    # 执行XDT转换逻辑（这里假设你已经加载了Microsoft.Web.XmlTransform库）
    $xmlDoc = New-Object System.Xml.XmlDocument
    $xmlDoc.Load($TargetXmlPath)
    
    $transform = New-Object Microsoft.Web.XmlTransform.XmlTransformation($xdtFile)
    if ($transform.Apply($xmlDoc)) {
        $xmlDoc.Save($TargetXmlPath)
        Write-Host "XML转换成功完成"
    }
    else {
        Write-Error "XML转换失败"
    }
}

这个方法的优势在于完全不受模块安装位置的影响，而且逻辑简单直接，不需要额外维护动态变量。

方法2：结合模块清单的FileList属性筛选文件 #

既然你已经把XDT文件加到了FileList里，也可以通过模块对象的FileList属性来获取这些文件的相对路径，再结合ModuleBase拼接成绝对路径。这个方法适合需要批量处理多个XDT文件的场景：

function Get-ModuleXdtFiles {
    # 获取当前模块的对象
    $currentModule = Get-Module -Name MyConfigModule

    # 从FileList中筛选出所有XDT文件，拼接绝对路径
    $xdtFiles = $currentModule.FileList | Where-Object { $_ -match '\.xdt$' } | ForEach-Object {
        Join-Path -Path $currentModule.ModuleBase -ChildPath $_
    }

    return $xdtFiles
}

不过要注意，FileList里的路径是相对于模块根目录的相对路径，所以必须和ModuleBase结合才能得到正确的绝对路径。

关键提醒 #

• 你之前在模块清单的FileList中添加XDT文件的操作是正确的！这样当你用Publish-Module打包模块时，这些XDT文件会被自动包含进去，不会遗漏。
• 绝对不要使用硬编码的绝对路径，因为模块可能被安装在不同用户的不同目录下，硬编码路径会导致脚本在其他环境失效。
• 在PowerShell 5中，$PSScriptRoot在模块的.psm1文件里指向的是.psm1所在的目录，如果你的.psm1和模块清单在同一根目录，那它和ModuleBase是等价的，但如果.psm1在子文件夹里，ModuleBase依然是模块根目录，所以用ModuleBase更通用。

内容的提问来源于stack exchange，提问作者Mickey Cohen