Public/Catalog/Get-CatalogDellSystem.ps1
|
<#
.SYNOPSIS Converts the Dell Catalog PC to a PowerShell Object .DESCRIPTION Converts the Dell Catalog PC to a PowerShell Object Requires Internet Access to download Dell CatalogPC.cab .PARAMETER Component Filter the results based on these Components: Application BIOS Driver Firmware .PARAMETER Compatible If you have a Dell System, this will filter the results based on your ComputerSystem SystemSKUNumber .EXAMPLE Get-CatalogDellSystem Don't do this, you will get an almost endless list .EXAMPLE $Result = Get-CatalogDellSystem Yes do this. Save it in a Variable .EXAMPLE Get-CatalogDellSystem -Component BIOS | Out-GridView Displays all the Dell BIOS Updates in GridView .LINK https://osd.osdeploy.com/module/functions .NOTES #> function Get-CatalogDellSystem { [CmdletBinding()] param ( [ValidateSet('Application','BIOS','Driver','Firmware')] [string]$Component, [switch]$Compatible ) #======================================================================= # Paths #======================================================================= $CatalogState = 'Online' #Online, Build, Local, Offline $DownloadsBaseUrl = 'http://downloads.dell.com/' $CatalogOnlinePath = 'http://downloads.dell.com/catalog/CatalogPC.cab' $CatalogBuildPath = Join-Path $env:TEMP 'CatalogPC.xml' $CatalogLocalPath = Join-Path $env:TEMP 'CatalogDellSystem.xml' $CatalogOfflinePath = "$($MyInvocation.MyCommand.Module.ModuleBase)\Files\Catalogs\CatalogDellSystem.xml" $CatalogLocalCabName = [string]($CatalogOnlinePath | Split-Path -Leaf) $CatalogLocalCabPath = Join-Path $env:TEMP $CatalogLocalCabName #======================================================================= # Test CatalogState Local #======================================================================= if (Test-Path $CatalogLocalPath) { #Get-Item to determine the age $GetItemCatalogLocalPath = Get-Item $CatalogLocalPath #If the local is older than 1 day, delete it if (((Get-Date) - $GetItemCatalogLocalPath.CreationTime).TotalDays -gt 1) { Write-Verbose "Removing previous Offline Catalog" } else { $CatalogState = 'Local' } } #======================================================================= # Test CatalogState Online #======================================================================= if ($CatalogState -eq 'Online') { if (Test-WebConnection -Uri $CatalogOnlinePath) { #Catalog is online and can be downloaded } else { $CatalogState = 'Offline' } } #======================================================================= # CatalogState Online # Need to get the Online Catalog to Local #======================================================================= if ($CatalogState -eq 'Online') { Write-Verbose "Source: $CatalogOnlinePath" Write-Verbose "Destination: $CatalogLocalCabPath" (New-Object System.Net.WebClient).DownloadFile($CatalogOnlinePath, $CatalogLocalCabPath) #Make sure the file downloaded if (Test-Path $CatalogLocalCabPath) { Write-Verbose "Expand: $CatalogLocalCabPath" Expand "$CatalogLocalCabPath" "$CatalogBuildPath" | Out-Null if (Test-Path $CatalogBuildPath) { $CatalogState = 'Build' } else { Write-Verbose "Could not expand $CatalogLocalCabPath" $CatalogState = 'Offline' } } else { $CatalogState = 'Offline' } } #======================================================================= # CatalogState Build #======================================================================= if ($CatalogState -eq 'Build') { Write-Verbose "Reading the System Catalog at $CatalogBuildPath" [xml]$XmlCatalogContent = Get-Content $CatalogBuildPath -ErrorAction Stop $CatalogVersion = $XmlCatalogContent.Manifest.version $Result = $XmlCatalogContent.Manifest.SoftwareComponent Write-Verbose "Building the System Catalog" $Result = $Result | Select-Object @{Label="CatalogVersion";Expression={$CatalogVersion};}, @{Label="Component";Expression={($_.ComponentType.Display.'#cdata-section'.Trim())};}, @{Label="ReleaseDate";Expression = {[datetime] ($_.dateTime)};}, @{Label="Name";Expression={($_.Name.Display.'#cdata-section'.Trim())};}, #@{Label="Description";Expression={($_.Description.Display.'#cdata-section'.Trim())};}, @{Label="DellVersion";Expression={$_.dellVersion};}, @{Label="Url";Expression={-join ($DownloadsBaseUrl, $_.path)};}, @{Label="VendorVersion";Expression={$_.vendorVersion};}, @{Label="Criticality";Expression={($_.Criticality.Display.'#cdata-section'.Trim())};}, @{Label="FileName";Expression = {(split-path -leaf $_.path)};}, @{Label="SizeMB";Expression={'{0:f2}' -f ($_.size/1MB)};}, @{Label="PackageID";Expression={$_.packageID};}, @{Label="PackageType";Expression={$_.packageType};}, @{Label="ReleaseID";Expression={$_.ReleaseID};}, @{Label="Category";Expression={($_.Category.Display.'#cdata-section'.Trim())};}, @{Label="SupportedDevices";Expression={($_.SupportedDevices.Device.Display.'#cdata-section'.Trim())};}, @{Label="SupportedBrand";Expression={($_.SupportedSystems.Brand.Display.'#cdata-section'.Trim())};}, @{Label="SupportedModel";Expression={($_.SupportedSystems.Brand.Model.Display.'#cdata-section'.Trim())};}, @{Label="SupportedSystemID";Expression={($_.SupportedSystems.Brand.Model.systemID)};}, @{Label="SupportedOperatingSystems";Expression={($_.SupportedOperatingSystems.OperatingSystem.Display.'#cdata-section'.Trim())};}, @{Label="SupportedArchitecture";Expression={($_.SupportedOperatingSystems.OperatingSystem.osArch)};}, @{Label="HashMD5";Expression={$_.HashMD5};} Write-Verbose "Exporting Offline Catalog to $CatalogLocalPath" $Result = $Result | Sort-Object ReleaseDate -Descending $Result | Export-Clixml -Path $CatalogLocalPath } #======================================================================= # CatalogState Local #======================================================================= if ($CatalogState -eq 'Local') { Write-Verbose "Reading the Local System Catalog at $CatalogLocalPath" $Result = Import-Clixml -Path $CatalogLocalPath } #======================================================================= # CatalogState Offline #======================================================================= if ($CatalogState -eq 'Offline') { Write-Verbose "Reading the Offline System Catalog at $CatalogOfflinePath" $Result = Import-Clixml -Path $CatalogOfflinePath } #======================================================================= # Compatible #======================================================================= if ($PSBoundParameters.ContainsKey('Compatible')) { $MyComputerProduct = Get-MyComputerProduct Write-Verbose "Filtering XML for items compatible with Product $MyComputerProduct" $Result = $Result | Where-Object {$_.SupportedSystemID -contains $MyComputerProduct} } #======================================================================= # Component #======================================================================= if ($PSBoundParameters.ContainsKey('Component')) { Write-Verbose "Filtering XML for $Component" $Result = $Result | Where-Object {$_.Component -eq $Component} } #======================================================================= # Component #======================================================================= $Result | Sort-Object -Property ReleaseDate -Descending #======================================================================= } |