DriverManagement

1.3.0

DriverManagement.psm1

#Requires -Version 5.1

<#
.SYNOPSIS
    PSDriverManagement PowerShell Module
    
.DESCRIPTION
    Enterprise driver and Windows update management for Dell and Lenovo endpoints.
    Designed for deployment via Intune, FleetDM, Chef, Ansible, SCCM, or any orchestration platform.
    
.NOTES
    Module: DriverManagement
    Author: Thomas Tyson
    Version: 1.0.0
#>

#region Module Variables

# Module-scoped configuration object
$script:ModuleConfig = $null

# Module root path
$script:ModuleRoot = $PSScriptRoot

# Correlation ID for current session
$script:CorrelationId = $null

# Logging initialized flag
$script:LoggingInitialized = $false

#endregion

#region Module Initialization

function Initialize-ModuleConfiguration {
    <#
    .SYNOPSIS
        Initializes module configuration from manifest and environment
    #>
    [CmdletBinding()]
    param()
    
    # Load defaults from manifest PrivateData
    $manifestPath = Join-Path $script:ModuleRoot 'DriverManagement.psd1'
    $manifest = Import-PowerShellDataFile -Path $manifestPath
    
    $defaults = $manifest.PrivateData.ModuleConfig
    
    # Expand environment variables in paths
    $script:ModuleConfig = @{
        LogPath              = $ExecutionContext.InvokeCommand.ExpandString($defaults.LogPath)
        CompliancePath       = $ExecutionContext.InvokeCommand.ExpandString($defaults.CompliancePath)
        EventLogName         = $defaults.EventLogName
        EventLogSource       = $defaults.EventLogSource
        MaxLogAgeDays        = $defaults.MaxLogAgeDays
        MaxLogSizeMB         = $defaults.MaxLogSizeMB
        DefaultMode          = $defaults.DefaultMode
        DefaultUpdateTypes   = $defaults.DefaultUpdateTypes
        DefaultSeverity      = $defaults.DefaultSeverity
        SupportedDellModels  = $defaults.SupportedDellModels
        SupportedLenovoMTMs  = $defaults.SupportedLenovoMTMs
        ModuleVersion        = $manifest.ModuleVersion
    }
    
    # Generate correlation ID for this session
    $script:CorrelationId = [guid]::NewGuid().ToString()
    
    # Override with environment variables if present
    if ($env:PSDM_LOG_PATH) {
        $script:ModuleConfig.LogPath = $env:PSDM_LOG_PATH
    }
    if ($env:PSDM_EVENT_LOG) {
        $script:ModuleConfig.EventLogName = $env:PSDM_EVENT_LOG
    }
}

#endregion

#region Dot-Source Module Components

# Import order matters - Classes first, then Private, then Public

# Classes (type definitions)
$classFiles = @(
    'Classes\DriverManagementConfig.ps1'
)

# Private functions (internal use only)
$privateFiles = @(
    'Private\Logging.ps1'
    'Private\Utilities.ps1'
    'Private\VersionComparison.ps1'
)

# Public functions (exported)
$publicFiles = @(
    'Public\Get-OEMInfo.ps1'
    'Public\Get-DriverComplianceStatus.ps1'
    'Public\Update-DriverComplianceStatus.ps1'
    'Public\Dell.ps1'
    'Public\Lenovo.ps1'
    'Public\WindowsUpdate.ps1'
    'Public\ScheduledTasks.ps1'
    'Public\Invoke-DriverManagement.ps1'
    'Public\UpdateBlocking.ps1'
    'Public\DriverRollback.ps1'
    'Public\UpdateApproval.ps1'
)

# Dot-source all files
foreach ($file in ($classFiles + $privateFiles + $publicFiles)) {
    $filePath = Join-Path $script:ModuleRoot $file
    if (Test-Path $filePath) {
        try {
            . $filePath
        }
        catch {
            Write-Error "Failed to load module component: $file - $($_.Exception.Message)"
            throw
        }
    }
    else {
        Write-Warning "Module component not found: $file"
    }
}

#endregion

#region Aliases

# Create aliases for common commands
New-Alias -Name 'idm' -Value 'Invoke-DriverManagement' -Scope Global -Force
New-Alias -Name 'gdcs' -Value 'Get-DriverComplianceStatus' -Scope Global -Force

#endregion

#region Module Load Actions

# Initialize configuration on module load
Initialize-ModuleConfiguration

# Export module configuration for inspection (read-only)
function Get-DriverManagementConfig {
    <#
    .SYNOPSIS
        Returns the current module configuration
    .DESCRIPTION
        Returns a copy of the module configuration. Use for inspection only.
    #>
    [CmdletBinding()]
    param()
    
    return $script:ModuleConfig.Clone()
}

#endregion

#region Module Unload Actions

$ExecutionContext.SessionState.Module.OnRemove = {
    # Cleanup actions when module is removed
    Remove-Item -Path Alias:idm -Force -ErrorAction SilentlyContinue
    Remove-Item -Path Alias:gdcs -Force -ErrorAction SilentlyContinue
}

#endregion

# Export all public functions and aliases
# Note: FunctionsToExport in the manifest acts as a filter on top of this
Export-ModuleMember -Function @(
    # Core functions defined in this file
    'Get-DriverManagementConfig'
    
    # Core driver management (Public/Invoke-DriverManagement.ps1)
    'Invoke-DriverManagement'
    
    # Compliance (Public/Get-DriverComplianceStatus.ps1, Update-DriverComplianceStatus.ps1)
    'Get-DriverComplianceStatus'
    'Update-DriverComplianceStatus'
    
    # Dell-specific (Public/Dell.ps1)
    'Get-DellDriverUpdates'
    'Install-DellDriverUpdates'
    'Install-DellFullDriverPack'
    
    # Lenovo-specific (Public/Lenovo.ps1)
    'Get-LenovoDriverUpdates'
    'Install-LenovoDriverUpdates'
    'Install-LenovoFullDriverPack'
    
    # Windows Updates (Public/WindowsUpdate.ps1)
    'Install-WindowsUpdates'
    
    # Utility functions (Public/Get-OEMInfo.ps1)
    'Get-OEMInfo'
    'Test-DriverManagementPrerequisites'
    
    # Logging (Private/Logging.ps1 - exposed for initialization)
    'Initialize-DriverManagementLogging'
    'Get-DriverManagementLogs'
    
    # Scheduled task management (Public/ScheduledTasks.ps1)
    'Register-DriverManagementTask'
    'Unregister-DriverManagementTask'
) -Alias @(
    'idm'
    'gdcs'
)