public/Install-LSUpdate.ps1
|
function Install-LSUpdate { <# .SYNOPSIS Installs a Lenovo update package. Downloads it if not previously downloaded. .DESCRIPTION Installs a Lenovo update package. Downloads it if not previously downloaded. .PARAMETER Package The Lenovo package object to install .PARAMETER Path If you previously downloaded the Lenovo package to a custom directory, specify its path here so that the package can be found .PARAMETER SaveBIOSUpdateInfoToRegistry If a BIOS update is successfully installed, write information about it to 'HKLM\Software\LSUClient\BIOSUpdate'. This is useful in automated deployment scenarios, especially the 'ActionNeeded' key which will tell you whether a shutdown or reboot is required to apply the BIOS update. The created registry values will not be deleted by this module, only overwritten on the next installed BIOS Update. .PARAMETER Proxy Specifies the URL of a proxy server to use for the connection to the update repository. Used if a package still needs to be downloaded before it can be installed. .PARAMETER ProxyCredential Specifies a user account that has permission to use the proxy server that is specified by the -Proxy parameter. .PARAMETER ProxyUseDefaultCredentials Indicates that the cmdlet uses the credentials of the current user to access the proxy server that is specified by the -Proxy parameter. #> [CmdletBinding()] [OutputType('PackageInstallResult')] Param ( [Parameter( Position = 0, ValueFromPipeline = $true, Mandatory = $true )] [PSCustomObject]$Package, [ValidateScript({ Test-Path -LiteralPath $_ -PathType Container })] [System.IO.DirectoryInfo]$Path = "$env:TEMP\LSUPackages", [switch]$SaveBIOSUpdateInfoToRegistry, [Uri]$Proxy = $script:LSUClientConfiguration.Proxy, [PSCredential]$ProxyCredential = $script:LSUClientConfiguration.ProxyCredential, [switch]$ProxyUseDefaultCredentials = $script:LSUClientConfiguration.ProxyUseDefaultCredentials ) begin { if ($PSBoundParameters['Debug'] -and $DebugPreference -eq 'Inquire') { Write-Verbose "Adjusting the DebugPreference to 'Continue'." $DebugPreference = 'Continue' } } process { foreach ($PackageToProcess in $Package) { $Extracter = $PackageToProcess.Files | Where-Object { $_.Kind -eq 'Installer' } $PackageDirectory = Join-Path -Path $Path -ChildPath $PackageToProcess.ID if (-not (Test-Path -LiteralPath $PackageDirectory -PathType Container)) { $null = New-Item -Path $PackageDirectory -Force -ItemType Directory } $SpfParams = @{ 'SourceFile' = $Extracter 'Directory' = $PackageDirectory 'Proxy' = $Proxy 'ProxyCredential' = $ProxyCredential 'ProxyUseDefaultCredentials' = $ProxyUseDefaultCredentials } $FullPath = Save-PackageFile @SpfParams if (-not $FullPath) { Write-Error "The installer of package '$($PackageToProcess.ID)' could not be accessed or found and will be skipped" continue } Expand-LSUpdate -Package $PackageToProcess -WorkingDirectory $PackageDirectory Write-Verbose "Installing package $($PackageToProcess.ID) ..." # As a precaution, do not apply runtime limits and kill in-progress installers for packages that are likely firmware updaters if ($script:LSUClientConfiguration.MaxInstallerRuntime -gt [TimeSpan]::Zero -and ( $PackageToProcess.Installer.Command -like '*winuptp.exe*' -or $PackageToProcess.Installer.Command -like '*Flash.cmd*' -or $PackageToProcess.Type -in 'BIOS', 'Firmware' -or $PackageToProcess.Category -like "*BIOS*" -or $PackageToProcess.Category -like "*UEFI*" -or $PackageToProcess.Category -like "*Firmware*" -or $PackageToProcess.Title -like "*BIOS*" -or $PackageToProcess.Title -like "*UEFI*" -or $PackageToProcess.Title -like "*Firmware*" -or $PackageToProcess.RebootType -eq 5) ) { Write-Verbose "MaxInstallerRuntime of $($script:LSUClientConfiguration.MaxInstallerRuntime) will not be enforced for this package because it appears to be a BIOS or firmware update" $MaxInstallerRuntime = [TimeSpan]::Zero } else { $MaxInstallerRuntime = $script:LSUClientConfiguration.MaxInstallerRuntime } switch ($PackageToProcess.Installer.InstallType) { 'CMD' { # Special-case ThinkPad and ThinkCentre (winuptp.exe and Flash.cmd/wflash2.exe) # BIOS updates because we can install them silently and unattended with custom arguments # Other BIOS updates are not classified as unattended and will be treated like any other package. if ($PackageToProcess.Installer.Command -match 'winuptp\.exe|Flash\.cmd') { # We are dealing with a known kind of BIOS Update $installProcess = Install-BiosUpdate -PackageDirectory $PackageDirectory } else { # Correct typo from Lenovo ... yes really... $InstallCMD = $PackageToProcess.Installer.Command -replace '-overwirte', '-overwrite' $installProcess = Invoke-PackageCommand -Path $PackageDirectory -Command $InstallCMD -RuntimeLimit $MaxInstallerRuntime } $Success = $installProcess.Err -eq [ExternalProcessError]::NONE -and $( if ($installProcess.Info -is [BiosUpdateInfo] -and $null -ne $installProcess.Info.SuccessOverrideValue) { $installProcess.Info.SuccessOverrideValue } else { $installProcess.Info.ExitCode -in $PackageToProcess.Installer.SuccessCodes } ) $FailureReason = if ($installProcess.Err) { "$($installProcess.Err)" } elseif ($installProcess.Info.ExitCode -in $PackageToProcess.Installer.CancelCodes) { 'CANCELLED_BY_USER' } elseif (-not $Success) { 'INSTALLER_EXITCODE' } else { '' } $PendingAction = if (-not $Success) { 'NONE' } elseif ($installProcess.Info -is [BiosUpdateInfo]) { if ($installProcess.Info.ActionNeeded -eq 'SHUTDOWN') { 'SHUTDOWN' } elseif ($installProcess.Info.ActionNeeded -eq 'REBOOT') { 'REBOOT_MANDATORY' } } elseif ($PackageToProcess.RebootType -eq 0) { 'NONE' } elseif ($PackageToProcess.RebootType -eq 1) { # RebootType 1 updates should force a reboot on their own, interrupting LSUClient anyway, # but this can lead to race conditions (how fast does the reboot happen, killing LSUClient before this point?) # or maybe the reboot doesn't happen for some reason so we still communicate that it's needed. See issue #94. 'REBOOT_MANDATORY' } elseif ($PackageToProcess.RebootType -eq 3) { 'REBOOT_SUGGESTED' } elseif ($PackageToProcess.RebootType -eq 4) { 'SHUTDOWN' } elseif ($PackageToProcess.RebootType -eq 5) { 'REBOOT_MANDATORY' } [PackageInstallResult]@{ ID = $PackageToProcess.ID Title = $PackageToProcess.Title Type = $PackageToProcess.Type Success = $Success FailureReason = $FailureReason PendingAction = $PendingAction ExitCode = $installProcess.Info.ExitCode StandardOutput = $installProcess.Info.StandardOutput StandardError = $installProcess.Info.StandardError LogOutput = if ($installProcess.Info -is [BiosUpdateInfo]) { $installProcess.Info.LogMessage } else { '' } Runtime = if ($installProcess.Info) { $installProcess.Info.Runtime } else { [TimeSpan]::Zero } } # Extra handling for BIOS updates if ($installProcess.Info -is [BiosUpdateInfo]) { if ($Success) { # BIOS Update successful Write-Information -MessageData "BIOS UPDATE SUCCESS: An immediate full $($installProcess.Info.ActionNeeded) is strongly recommended to allow the BIOS update to complete!" -InformationAction Continue if ($SaveBIOSUpdateInfoToRegistry) { Set-BIOSUpdateRegistryFlag -Timestamp $installProcess.Info.Timestamp -ActionNeeded $installProcess.Info.ActionNeeded -PackageHash $Extracter.Checksum } } } } 'INF' { $InfSuccessCodes = @(0, 3010) + $PackageToProcess.Installer.SuccessCodes $InfInstallParams = @{ 'Path' = $PackageDirectory 'Executable' = "${env:SystemRoot}\system32\pnputil.exe" 'Arguments' = "/add-driver $($PackageToProcess.Installer.InfFile) /install" 'RuntimeLimit' = $MaxInstallerRuntime } $installProcess = Invoke-PackageCommand @InfInstallParams $Success = $installProcess.Err -eq [ExternalProcessError]::NONE -and $installProcess.Info.ExitCode -in $InfSuccessCodes [PackageInstallResult]@{ ID = $PackageToProcess.ID Title = $PackageToProcess.Title Type = $PackageToProcess.Type Success = $Success FailureReason = if ($installProcess.Err) { "$($installProcess.Err)" } elseif (-not $Success) { 'INSTALLER_EXITCODE' } else { '' } PendingAction = if ($Success -and $installProcess.Info.ExitCode -eq 3010) { 'REBOOT_SUGGESTED' } else { 'NONE' } ExitCode = $installProcess.Info.ExitCode StandardOutput = $installProcess.Info.StandardOutput StandardError = $installProcess.Info.StandardError LogOutput = '' Runtime = if ($installProcess.Info) { $installProcess.Info.Runtime } else { [TimeSpan]::Zero } } } default { Write-Warning "Unsupported package installtype '$_', skipping installation!" } } } } } |