如何在PowerShell模块中配置全局可用的字典/哈希表（规避全局对象）

方案一：模块级私有变量（最简便推荐） #

直接在PSM1文件的顶层作用域定义配置哈希表，模块内的所有函数都能直接访问这个变量，且模块加载后该变量会持久存在，完全不需要全局对象。

示例代码（在你的PSM1文件中）：

# 模块顶层定义私有配置哈希表，仅模块内部可访问
$ModuleConfig = @{
    FilePath = 'C:\Your\Default\Path'
    FileName = 'DefaultLog.txt'
    MaxFileSize = 10MB
}

# 模块内的函数直接使用该配置
function Get-TargetFilePath {
    return Join-Path -Path $ModuleConfig.FilePath -ChildPath $ModuleConfig.FileName
}

# 可选：如果需要允许外部脚本修改配置，可提供专门的修改函数
function Set-ModuleConfig {
    param(
        [string]$Key,
        $Value
    )
    if ($ModuleConfig.ContainsKey($Key)) {
        $ModuleConfig[$Key] = $Value
    }
    else {
        Write-Warning "配置项 $Key 不存在"
    }
}

# 导出需要外部调用的函数（不需要导出配置变量）
Export-ModuleMember -Function Get-TargetFilePath, Set-ModuleConfig

关键说明： #

• 模块顶层的变量属于模块作用域，只要模块未被卸载，变量就会保持持久化。
• 外部脚本无法直接访问$ModuleConfig，只能通过你提供的函数操作，避免意外修改配置。
• 更新配置时，只需修改PSM1里的$ModuleConfig，重新导入模块（Import-Module .\YourModule.psm1 -Force）即可生效。

方案二：闭包封装配置（更安全，限制直接修改） #

通过脚本块闭包捕获配置变量，仅暴露访问/修改的函数，进一步隔离配置的直接访问权限。

示例代码：

# 用脚本块封装配置和操作函数
$configClosure = {
    # 闭包内的私有配置，外部无法直接访问
    $privateConfig = @{
        FilePath = 'C:\Your\Default\Path'
        FileName = 'DefaultLog.txt'
    }

    # 定义访问函数
    function Get-ConfigValue {
        param([string]$Key)
        return $privateConfig[$Key]
    }

    # 定义修改函数
    function Update-ConfigValue {
        param(
            [string]$Key,
            $Value
        )
        if ($privateConfig.ContainsKey($Key)) {
            $privateConfig[$Key] = $Value
        }
        else {
            throw "无效的配置项：$Key"
        }
    }
}

# 执行脚本块，让模块内的函数能访问闭包中的配置
& $configClosure

# 导出操作函数
Export-ModuleMember -Function Get-ConfigValue, Update-ConfigValue

方案三：静态类存储配置（结构化管理） #

用PowerShell类的静态属性存储配置，适合配置项较多、需要结构化管理的场景。

示例代码：

# 定义静态类存储配置
class ModuleSettings {
    # 静态哈希表存储配置项
    static [hashtable]$Config = @{
        FilePath = 'C:\Your\Default\Path'
        FileName = 'DefaultLog.txt'
        RetentionDays = 7
    }

    # 静态方法：获取配置值
    static [object] GetConfig([string]$Key) {
        return [ModuleSettings]::Config[$Key]
    }

    # 静态方法：更新配置值
    static [void] SetConfig([string]$Key, $Value) {
        if ([ModuleSettings]::Config.ContainsKey($Key)) {
            [ModuleSettings]::Config[$Key] = $Value
        }
        else {
            Write-Error "配置项 $Key 不存在"
        }
    }
}

# 模块内函数调用类的静态成员
function Get-LogFileFullPath {
    $path = [ModuleSettings]::GetConfig('FilePath')
    $name = [ModuleSettings]::GetConfig('FileName')
    return Join-Path -Path $path -ChildPath $name
}

# 导出函数
Export-ModuleMember -Function Get-LogFileFullPath

为什么之前全局变量才能持久？ #

你之前遇到的问题，是因为如果配置变量定义在函数内部，函数执行完毕后变量会被销毁；而把变量放在模块顶层/闭包/类中，它们属于模块作用域（或闭包作用域），模块加载后这个作用域会一直存在，直到模块被卸载，因此变量自然持久化，完全不需要依赖全局对象。

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