PowerShell: размещение глобальных значений в модуле?

Вероятно, у меня есть для вас решение, основанное на размещении переменных в области видимости модуля. Он основан на этой публикации в блоге

Вы создаете переменную в области модуля и помещаете в нее все необходимое для работы модуля:

$DynDnsSession = [ordered]@{
    ClientUrl           = 'https://api.dynect.net'
    ApiVersion          = $null
    AuthToken           = $null
    StartTime           = $null
    RefreshTime         = $null
}
New-Variable -Name DynDnsSession  -Value $DynDnsSession -Scope Script -Force

Поскольку переменная будет определена в области модуля, у вас не будет возможности изменить ее, напрямую обращаясь к ней из ваших скриптов — вам нужны оболочки (геттер и установщик) для этой переменной внутри вашего модуля. Например (это весь модуль .psm1; на основе того же поста в блоге)

$DynDnsSession = [ordered]@{
    ClientUrl   = 'https://api.dynect.net'
    ApiVersion  = $null
    AuthToken   = $null
    StartTime   = $null
    RefreshTime = $null
}

Function Get-DynDnsSession {
    return $DynDnsSession
}

Function Set-DynDnsSession {
    [CmdletBinding()]
    param(

    )

    DynamicParam {
        # define dictionary for dynamic parameters
        $ParamDictionary = [System.Management.Automation.RuntimeDefinedParameterDictionary]::new() 

        # get all the keys from the module variable; please note the .GetEnumerator()
        # it's to separate properties from each other, otherwise you just get all the values as a single object and not an array
        $DynProps = $DynDnsSession.Keys.GetEnumerator() 
        foreach ($Prop in $DynProps) {
            # type of the attribute. You probably can base this
            # on the type of variables you have in your dictionary
            $AttrType = "String"
            $AttrCollection = [System.Collections.ObjectModel.Collection[System.Attribute]]::new()
            $ParamAttr = [System.Management.Automation.ParameterAttribute]@{
                ParameterSetName = "DynamicFields"
                Mandatory        = $false
                HelpMessage      = $Prop # you can define this with a switch based on a property name if you want to 
            }
            $AttrCollection.Add($ParamAttr)
            $DynParam = [System.Management.Automation.RuntimeDefinedParameter]::new(
                $Prop, $AttrType, $AttrCollection
            )
    
            $ParamDictionary.Add($Prop, $DynParam)
        }
        return $ParamDictionary
    }

    PROCESS {
        foreach ($Param in $PSBoundParameters.GetEnumerator()) {
            if ($DynDnsSession.Contains($Param.Key)) {
                Write-Output $Param
                Write-Verbose "Setting $($Param.Key) to $($Param.Value)" -Verbose
                $DynDnsSession.$($Param.Key) = $Param.Value
            }
        }
    }
}

Я также определил динамические параметры для проверки того, что вы хотите установить. Но если вы хотите добавить или удалить свойства из этой переменной модуля, вам придется использовать другой подход (хотя он будет проще, чем DynamicParam). Я без проблем использую это в своих нескольких модулях RestAPI, и PSScriptAnalyzer никогда не жаловался.

DynamicParam основан на этом посте.

Вы можете определить переменные области действия на уровне модуля. Например:

$Script:WordList = 'cat', 'dog'

А затем ссылайтесь на эту переменную во всех функциях вашего модуля:

$Script:WordList