functions/Get-DBOConfig.ps1

function Get-DBOConfig {
    <#
    .SYNOPSIS
    Returns a DBOpsConfig object
     
    .DESCRIPTION
    Returns a DBOpsConfig object from an existing json file. If file was not specified, returns a blank DBOpsConfig object.
    Values of the config can be overwritten by the hashtable parameter -Configuration.
     
    .PARAMETER Path
    Path to the JSON config file.
         
    .PARAMETER Configuration
    Overrides for the configuration values. Will replace existing configuration values.
 
    .PARAMETER Confirm
        Prompts to confirm certain actions
 
    .PARAMETER WhatIf
        Shows what would happen if the command would execute, but does not actually perform the command
 
    .EXAMPLE
    # Returns empty configuration
    Get-DBOConfig
     
    .EXAMPLE
    # Returns configuration from existing file
    Get-DBOConfig c:\package\dbops.config.json
 
    .EXAMPLE
    # Saves empty configuration to a file
    (Get-DBOConfig).SaveToFile('c:\package\dbops.config.json')
 
    #>

    [CmdletBinding()]
    param
    (
        [string]$Path,
        [hashtable]$Configuration
    )
    if ($Path) {
        Write-Verbose "Reading configuration from $Path"
        $config = [DBOpsConfig]::FromFile($Path)
    }
    else {
        Write-Verbose "Generating blank configuration object"
        $config = [DBOpsConfig]::new()
    }
    if ($Configuration) {
        Write-Verbose "Overwriting configuration keys $($Configuration.Keys -join ', ') with new values"
        foreach ($property in $Configuration.Keys) {
            $config.SetValue($property, $Configuration.$property)
        }
    }
    $config
}