public/Get-LSUpdate.ps1
|
function Get-LSUpdate { <# .SYNOPSIS Fetches available driver packages and updates for Lenovo computers .PARAMETER Model Specify an alternative Lenovo Computer Model to retrieve update packages for. You may want to use this together with '-All' so that packages are not filtered against your local machines configuration. .PARAMETER Proxy Specifies a proxy server for the connection to Lenovo. Enter the URI of a network proxy server. .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. .PARAMETER All Return all updates, regardless of whether they are applicable to this specific machine or whether they are already installed. E.g. this will retrieve LTE-Modem drivers even for machines that do not have the optional LTE-Modem installed. Installation of such drivers will likely still fail. .PARAMETER FailUnsupportedDependencies Lenovo has different kinds of dependencies they specify for each package. This script makes a best effort to parse, understand and check these. However, new kinds of dependencies may be added at any point and some currently in use are not supported yet either. By default, any unknown dependency will be treated as met/OK. This switch will fail all dependencies we can't actually check. Typically, an update installation will simply fail if there really was a dependency missing. #> [CmdletBinding()] Param ( [ValidatePattern('^\w{4}$')] [string]$Model, [Uri]$Proxy, [pscredential]$ProxyCredential, [switch]$ProxyUseDefaultCredentials, [switch]$All, [switch]$FailUnsupportedDependencies, [ValidateScript({ try { [System.IO.File]::Create("$_").Dispose(); $true} catch { $false } })] [string]$DebugLogFile ) begin { if (-not (Test-RunningAsAdmin)) { Write-Warning "Unfortunately, this command produces most accurate results when run as an Administrator`r`nbecause some of the commands Lenovo uses to detect your computers hardware have to run as admin :(" } if (-not $Model) { $MODELREGEX = [regex]::Match((Get-CimInstance -ClassName CIM_ComputerSystem -ErrorAction SilentlyContinue).Model, '^\w{4}') if ($MODELREGEX.Success -ne $true) { throw "Could not parse computer model number. This may not be a Lenovo computer, or an unsupported model." } $Model = $MODELREGEX.Value } Write-Verbose "Lenovo Model is: $Model`r`n" if ($DebugLogFile) { Add-Content -LiteralPath $DebugLogFile -Value "Lenovo Model is: $Model" } $webClient = New-WebClient -Proxy $Proxy -ProxyCredential $ProxyCredential -ProxyUseDefaultCredentials $ProxyUseDefaultCredentials try { $COMPUTERXML = $webClient.DownloadString("https://download.lenovo.com/catalog/${Model}_Win10.xml") } catch { if ($_.Exception.innerException.Response.StatusCode -eq [System.Net.HttpStatusCode]::NotFound) { throw "No information was found on this model of computer (invalid model number or not supported by Lenovo?)" } else { throw "An error occured when contacting download.lenovo.com:`r`n$($_.Exception.Message)" } } $UTF8ByteOrderMark = [System.Text.Encoding]::UTF8.GetString(@(195, 175, 194, 187, 194, 191)) # Downloading with Net.WebClient seems to remove the BOM automatically, this only seems to be neccessary when downloading with IWR. Still I'm leaving it in to be safe [xml]$PARSEDXML = $COMPUTERXML -replace "^$UTF8ByteOrderMark" Write-Verbose "A total of $($PARSEDXML.packages.count) driver packages are available for this computer model." } process { foreach ($packageURL in $PARSEDXML.packages.package) { # This is in place to prevent packages like 'k2txe01us17' that have invalid XML from stopping the entire function with an error try { $rawPackageXML = $webClient.DownloadString($packageURL.location) [xml]$packageXML = $rawPackageXML -replace "^$UTF8ByteOrderMark" } catch { if ($_.FullyQualifiedErrorId -eq 'InvalidCastToXmlDocument') { Write-Warning "Could not parse package '$($packageURL.location)' (invalid XML)" } else { Write-Warning "Could not retrieve or parse package '$($packageURL.location)':`r`n$($_.Exception.Message)" } continue } $DownloadedExternalFiles = [System.Collections.Generic.List[System.IO.FileInfo]]::new() # Downloading files needed by external detection in package dependencies if ($packageXML.Package.Files.External) { # Packages like https://download.lenovo.com/pccbbs/mobiles/r0qch05w_2_.xml show we have to download the XML itself too [string]$DownloadDest = Join-Path -Path $env:Temp -ChildPath ($packageURL.location -replace "^.*/") $webClient.DownloadFile($packageURL.location, $DownloadDest) $DownloadedExternalFiles.Add( [System.IO.FileInfo]::new($DownloadDest) ) foreach ($externalFile in $packageXML.Package.Files.External.ChildNodes) { [string]$DownloadDest = Join-Path -Path $env:Temp -ChildPath $externalFile.Name $webClient.DownloadFile(($packageURL.location -replace "[^/]*$") + $externalFile.Name, $DownloadDest) $DownloadedExternalFiles.Add( [System.IO.FileInfo]::new($DownloadDest) ) } } if ($DebugLogFile) { Add-Content -LiteralPath $DebugLogFile -Value "Parsing dependencies for package: $($packageXML.Package.id)`r`n" } $packageObject = [LenovoPackage]@{ 'ID' = $packageXML.Package.id 'Title' = $packageXML.Package.Title.Desc.'#text' 'Category' = $packageURL.category 'Version' = if ([Version]::TryParse($packageXML.Package.version, [ref]$null)) { $packageXML.Package.version } else { '0.0.0.0' } 'Severity' = $packageXML.Package.Severity.type 'RebootType' = $packageXML.Package.Reboot.type 'Vendor' = $packageXML.Package.Vendor 'URL' = $packageURL.location 'Extracter' = $packageXML.Package 'Installer' = [PackageInstallInfo]::new($packageXML.Package, $packageURL.category) 'IsApplicable' = Resolve-XMLDependencies -XMLIN $packageXML.Package.Dependencies -FailUnsupportedDependencies:$FailUnsupportedDependencies -DebugLogFile $DebugLogFile 'IsInstalled' = if ($packageXML.Package.DetectInstall) { Resolve-XMLDependencies -XMLIN $packageXML.Package.DetectInstall -FailUnsupportedDependencies:$FailUnsupportedDependencies -DebugLogFile $DebugLogFile } else { Write-Verbose "Package $($packageURL.location) doesn't have a DetectInstall section" 0 } } if ($All -or ($packageObject.IsApplicable -and $packageObject.IsInstalled -eq $false)) { $packageObject } foreach ($tempFile in $DownloadedExternalFiles) { if ($tempFile.Exists) { $tempFile.Delete() } } } } end { $webClient.Dispose() } } |