FudgePop

1.0.17

Private/Set-FPControlModules.ps1

function Set-FPControlModules {
    <#
    .SYNOPSIS
    Install PowerShell Modules
    .DESCRIPTION
    Install Specified PowerShell Modules
    .PARAMETER DataSet
    XML data
    .EXAMPLE
    Set-FPControlModules -DataSet $xmldata
    .NOTES
    #>
    [CmdletBinding(SupportsShouldProcess=$True)]
    param (
        [parameter(Mandatory = $True, HelpMessage="XML data")] 
        [ValidateNotNullOrEmpty()] 
        $DataSet
    )
    Write-FPLog "--------- module assignments: begin ---------"
    foreach ($module in $DataSet) {
        $device     = $module.device
        $collection = $module.collection
        $modname    = $module.name
        $modver     = $module.version
        $runtime    = $module.when
        $comment    = $module.comment
        Write-FPLog "device................ $device"
        Write-FPLog "collection............ $collection"
        Write-FPLog "module................ $modname"
        Write-FPLog "version............... $modver"
        Write-FPLog "runtime............... $runtime"
        Write-FPLog "comment............... $comment"
        if (Test-FPControlRuntime -RunTime $runtime) {
            Write-FPLog "Runtime is now or overdue"
            if ($m = Get-Module -Name $modname -ListAvailable) {
                $lv = $m.Version -join '.'
                Write-FPLog "Module version $lv is already installed"
                if ($r = Find-Module -Name $modname) {
                    $rv = $r.Version -join '.'
                    if ($modver -eq 'latest') {
                        Write-FPLog 'Latest version is requested via control policy.'
                        if ($lv -lt $rv) {
                            try {
                                Write-FPLog "Updating module to $rv"
                                Update-Module -Name $modname -Force -ErrorAction Stop
                            }
                            catch {
                            }
                        }
                        else {
                            Write-FPLog "Local version is the latest. No update required."
                        }
                    }
                    else {
                        Write-FPLog 'Specific version is requested via control policy.'
                        if ($lv -lt $modver) {
                            try {
                                Write-FPLog "Updating module to $modver"
                                Update-Module -Name $modname -RequiredVersion $modver -ErrorAction Stop
                            }
                            catch {
                                Write-FPLog -Category 'Error' -Message $_.Exception.Message
                                break
                            }
                        }
                        else {
                            Write-FPLog "Local version is the latest. No update required."
                        }
                    }
                }
            }
            else {
                Write-FPLog "Module is not installed. Installing it now."
                try {
                    if (!($TestMode)) {
                        Install-Module -Name $modname -Force -ErrorAction Stop
                        Write-FPLog "Module has been installed successfully."
                    }
                    else {
                        Write-FPLog "TESTMODE: Would have been installed"
                    }
                }
                catch {
                    Write-FPLog -Category 'Error' -Message "Installation failed: "+$_.Exception.Message
                }
            }
        }
        else {
            Write-FPLog 'skip: not yet time to run this assignment'
        }
    } # foreach
    Write-FPLog '--------- module assignments: finish ---------'
}