Public/Get-ScriptMessageConfig.ps1
|
function Get-ScriptMessageConfig { <# .LINK https://github.com/Sekers/ScriptMessage/wiki .SYNOPSIS Get the configuration and secrets to connect to the messaging service(s). .DESCRIPTION Get the configuration and secrets to connect to the messaging service(s). .PARAMETER ConfigPath Optional. If not provided, the function will use the path used in the current session (if set). .PARAMETER Service Optional. Return only the info related to a specific service. .EXAMPLE Get-ScriptMessageConfig .EXAMPLE Get-ScriptMessageConfig -Path '.\Config\config_scriptmessage.json' .EXAMPLE Get-ScriptMessageConfig -Service MicrosoftGraph #> [CmdletBinding()] param( [Parameter( Position=0, ValueFromPipeline=$true, ValueFromPipelineByPropertyName=$true)] [string]$Path = $ScriptMessage_Global_ConfigFilePath, # If not entered will see if it can pull path from this variable. [Parameter( Position=1, Mandatory = $false, ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true)] [MessagingService]$Service ) # Make Sure Requested Path Isn't Null or Empty (better to catch it here than validating on the parameter of this function) if ([string]::IsNullOrEmpty($Path)) { throw "`'`$ScriptMessage_Global_ConfigFilePath`' is not specified. Don't forget to first use the `'Set-ScriptMessageConfigFilePath`' cmdlet!" } # Get Config and Secrets try { # .NET resolves a relative path against the process directory, not PowerShell's current location. $FullPath = $PSCmdlet.GetUnresolvedProviderPathFromPSPath($Path) # A byte order mark sets the encoding when the file has one. Otherwise the file is read as UTF-8, or in the # system's legacy code page when it is not valid UTF-8. See section 5 of # Research_Notes/File-Encoding-And-Line-Endings.md. $Reader = [System.IO.StreamReader]::new($FullPath, [System.Text.UTF8Encoding]::new($false, $true), $true) try { $ConfigText = $Reader.ReadToEnd() } catch [System.Text.DecoderFallbackException] { $ConfigText = [System.IO.File]::ReadAllText($FullPath, [System.Text.Encoding]::GetEncoding(0)) } finally { $Reader.Dispose() } $ScriptMessageConfig = $ConfigText | ConvertFrom-Json if (-not ($null -eq $Service)) { return $ScriptMessageConfig.$Service } else { return $ScriptMessageConfig } } catch { throw "Can't find the JSON configuration file. Use 'Set-ScriptMessageConfigFilePath' to create one." } } |