MvRAdaptiveCards

0.6.1.1

Public/Application/Set-CardDefaultSmtpSetting.ps1

function Set-CardDefaultSmtpSetting {
    [CmdletBinding(SupportsShouldProcess = $true)]
    [OutputType([void])]
    param (
        [string]$From,
        [string]$Server,
        [int]$Port,
        [string]$Username,
        [securestring]$Password
    )

    if ($null -eq $_MvRACSettings) {
        $_MvRACSettings = @{}
    }
    if ($null -eq $_MvRACSettings.Context) {
        $_MvRACSettings.Context = @{}
    }
    if ($null -eq $_MvRACSettings.Smtp) {
        $_MvRACSettings.Smtp = @{}
    }

    $_MvRACSettings.Smtp.From = $From
    $_MvRACSettings.Smtp.Server = $Server
    $_MvRACSettings.Smtp.Port = $Port

    if ($SmtpUsername) {
        $_MvRACSettings.Smtp.Username = $Username
    }
    else {
        $_MvRACSettings.Smtp.Username = $null
    }

    if ($null -ne $Password) {
        #Since the securestring is strictly bound to the current user/machine, we can store it as plain text
        $_MvRACSettings.Smtp.Password = ConvertFrom-SecureString $Password
    }
    else {
        $_MvRACSettings.Smtp.Password = $null
    }



    #Create settings file if it doesn't exist
    if (-not (Test-Path $_SettingsFile)) {

        $_MvRACSettings = @{
            Context = @{
                User = $env:USERNAME
                Host = $env:COMPUTERNAME
            }
        }

        $_MvRACSettingsJson = $_MvRACSettings | ConvertTo-Json -Depth 5

        if ( $PSCmdlet.ShouldProcess("Creating module settings file at '$_SettingsFile' because it does not exist")) {
            $_MvRACSettingsJson | Set-Content -Path $_SettingsFile -Encoding UTF8
        }
    }

    #Get the now existing settings file
    $_CurrentMvRACSettings = Get-Content -Path $_SettingsFile -Raw | ConvertFrom-JsonAsHashtable

    # If the settings were not found, initialize them
    if ($null -eq $_MvRACSettings) {
        $_MvRACSettings = @{
            Context = @{
                User = $env:USERNAME
                Host = $env:COMPUTERNAME
            }
        }
    }

    #Validate the context to ensure it matches the current user/machine
    if ($_CurrentMvRACSettings.Context.User -ne $env:USERNAME -or $_CurrentMvRACSettings.Context.Host -ne $env:COMPUTERNAME) {
        Write-Warning "The existing settings file was created for user '$($_CurrentMvRACSettings.Context.User)' on host '$($_CurrentMvRACSettings.Context.Host)'. The current user is '$env:USERNAME' on host '$env:COMPUTERNAME'. Settings will be updated to match the current context. But additional steps may be required to ensure proper operation."
        $_MvRACSettings.Context.User = $env:USERNAME
        $_MvRACSettings.Context.Host = $env:COMPUTERNAME
    }

    #Save the updated settings
    if ( $PSCmdlet.ShouldProcess("Saving SMTP settings to module settings file at '$_SettingsFile'")) {
        $_MvRACSettings | ConvertTo-Json -Depth 5 | Set-Content -Path $_SettingsFile -Encoding UTF8 -Force
    }
}

# Add an alias for plural form (Reverse compatibility)
Set-Alias -Name Set-CardDefaultSmtpSettings -Value Set-CardDefaultSmtpSetting