en-US/about_DriverManagement.help.txt
|
TOPIC
about_DriverManagement SHORT DESCRIPTION Enterprise driver and Windows update management for Dell and Lenovo endpoints. LONG DESCRIPTION The DriverManagement module provides automated driver and Windows update management for enterprise fleets. It supports Dell and Lenovo hardware with two operational modes: - Individual: Surgical updates for outdated or missing drivers only - FullPack: Complete driver pack reinstallation The module integrates with: - Dell Command Update CLI for Dell systems - LSUClient / Thin Installer for Lenovo systems - PSWindowsUpdate for Windows cumulative updates It provides comprehensive logging to Windows Event Log and JSON files, making it suitable for enterprise monitoring and compliance tracking. INSTALLATION The module can be installed from PowerShell Gallery: Install-Module -Name DriverManagement Or manually by copying to a PSModulePath location: Copy-Item -Path .\DriverManagement -Destination $env:ProgramFiles\WindowsPowerShell\Modules -Recurse QUICK START # Import the module Import-Module DriverManagement # Check prerequisites Test-DriverManagementPrerequisites -Detailed # Run individual driver updates Invoke-DriverManagement -Mode Individual # Run full pack reinstall with Windows Updates Invoke-DriverManagement -Mode FullPack -IncludeWindowsUpdates # Read-only driver/device health snapshot (no updates installed) Invoke-DriverManagement -Status -LookbackHours 24 SUPPORTED HARDWARE All Dell and Lenovo systems are supported automatically. Dell: Uses Dell Command Update CLI (auto-installed if not present) Supports all Precision, Latitude, OptiPlex, and XPS models Lenovo: Uses LSUClient module (auto-installed from PSGallery if not present) Falls back to Thin Installer if LSUClient unavailable Supports all ThinkPad, ThinkCentre, and ThinkStation models Non-Dell/Lenovo systems will be detected but skipped. AUTOMATIC TOOL INSTALLATION The module automatically downloads and installs required tools: Dell Command Update: Downloaded from Dell's website and silently installed Configurable via $env:PSDM_DCU_URL or manifest (DellCommandUpdateUrl) LSUClient (Lenovo): Installed from PowerShell Gallery using Install-Module CONFIGURATION Module configuration is stored in the manifest PrivateData and can be overridden via environment variables: $env:PSDM_LOG_PATH = "D:\Logs\DriverMgmt" $env:PSDM_EVENT_LOG = "CustomLogName" $env:PSDM_DCU_URL = "https://your-cdn.com/Dell-Command-Update.exe" For enterprises with restricted internet access, host DCU on your internal CDN/repository and set PSDM_DCU_URL before running the module. View current configuration: Get-DriverManagementConfig LOGGING Logs are written to: - Windows Event Log: PSDriverManagement/DriverManagement - JSON files: %ProgramData%\PSDriverManagement\Logs\ Event IDs: 1000-1099: Debug/Information 2000-2099: Warning 3000-3999: Error STATUS MODE Invoke-DriverManagement supports a read-only status mode that collects on-device driver health signals and emits a structured DriverStatusReport object. Status mode outputs: - Windows Event Log: One summary event per run (EventId 1200/2200/3200 based on severity) - JSON Artifact: Full DriverStatusReport JSON written under %ProgramData%\\PSDriverManagement\\Logs\\ Example: Invoke-DriverManagement -Status -LookbackHours 24 Parameters (Status set): -Status Enables status mode (no installs/updates). -LookbackHours Event Viewer lookback window (default 24). -MaxEventsPerChannel Maximum events read per channel (default 500). -IncludeDriverInventory Adds driver store inventory via pnputil (can be slower). -OutputPath Optional directory to copy the JSON artifact. Output schema: DriverStatusReport.SchemaVersion = '1.0' DriverStatusReport contains Host/OEM/PendingReboot/Devices/DriverSignals/Health/Logging. Retrieve logs: Get-DriverManagementLogs -Last 50 -Severity Error SCHEDULED TASKS Register automated updates: # Weekly on Saturday at 3am Register-DriverManagementTask -TriggerType Weekly -Time "03:00" # On driver failure events Register-DriverManagementTask -TriggerType EventDriven # At system startup Register-DriverManagementTask -TriggerType AtStartup INTUNE DEPLOYMENT Package as Win32 app with: Install command: powershell.exe -ExecutionPolicy Bypass -Command "Import-Module DriverManagement; Invoke-DriverManagement" Detection script: $compliance = Get-Content "$env:ProgramData\PSDriverManagement\compliance.json" | ConvertFrom-Json if ($compliance.Status -eq 'Compliant') { exit 0 } else { exit 1 } ALIASES idm -> Invoke-DriverManagement gdcs -> Get-DriverComplianceStatus SEE ALSO Invoke-DriverManagement Get-OEMInfo Get-DriverComplianceStatus Install-DellDriverUpdates Install-LenovoDriverUpdates Register-DriverManagementTask KEYWORDS Driver, Update, Dell, Lenovo, Intune, Enterprise, Fleet, Windows |