Functions/Get-ScriptConfig.ps1
|
<#
.SYNOPSIS Load a script configuration from a config file. .DESCRIPTION Load a script configuration from a config file. By default, the config file next to the script is loaded. So for the script MyScript.ps1, the config file MyScript.ps1.config will be loaded. The config file format will be detected by it's extension (.xml, .ini, .json). If the file format can't be detected, the default format (JSON) will be used. .EXAMPLE PS C:\> $config = Get-ScriptConfig Loads the default JSON formatted configuration file. .EXAMPLE PS C:\> $config = Get-ScriptConfig -Path 'C:\MyApp\global.config' Loads a custom configuration file, with default JSON format. .EXAMPLE PS C:\> $config = Get-ScriptConfig -Format XML Loads the default configuration file but in XML format. .NOTES Author : Claudio Spizzi License : MIT License .LINK https://github.com/claudiospizzi/ScriptConfig #> function Get-ScriptConfig { [CmdletBinding()] param ( # Specify the path to the configuration file. By default, the current # script file path will be used with an appended '.config' extension. [Parameter(Mandatory = $false)] [System.String] $Path, # Override the format detection and default value. [Parameter(Mandatory = $false)] [ValidateSet('XML', 'JSON', 'INI')] [System.String] $Format ) # If the Path parameter was not specified, add a default value. If possible, # use the last script called this function. Else throw an exception. if (-not $PSBoundParameters.ContainsKey('Path')) { $lastScriptPath = Get-PSCallStack | Select-Object -Skip 1 -First 1 -ExpandProperty 'ScriptName' if (-not [System.String]::IsNullOrEmpty($lastScriptPath)) { $Path = $lastScriptPath + '.config' } else { throw "Configuration file not specified" } } # Now check, if the configuration file exists if (-not (Test-Path -Path $Path)) { throw "Configuration file not found: $Path" } # If the Format parameter was not specified, try to detect by the file # extension or use the default format JSON. if (-not $PSBoundParameters.ContainsKey('Format')) { switch -Wildcard ($Path) { '*.xml' { $Format = 'XML' } '*.json' { $Format = 'JSON' } '*.ini' { $Format = 'INI' } default { $Format = 'JSON' } } } Write-Verbose "Load script configuration from file $Path with format $Format" # Load raw content, parse it later $content = Get-Content -Path $Path -ErrorAction Stop # Use custom functions to parse the files and return the config object switch ($Format) { 'XML' { ConvertFrom-ScriptConfigXml -Content $content } 'JSON' { ConvertFrom-ScriptConfigJson -Content $content } 'INI' { ConvertFrom-ScriptConfigIni -Content $content } } } |