Public/Functions/Catalog/Get-OSDCatalogMicrosoftDriverPack.ps1

<#
.SYNOPSIS
Returns the Microsoft Surface DriverPacks
 
.DESCRIPTION
Returns the Microsoft Surface DriverPacks
 
.PARAMETER Compatible
Filters results based on your current Product
 
.LINK
https://osd.osdeploy.com
 
.NOTES
#>

function Get-OSDCatalogMicrosoftDriverPack {
    [CmdletBinding()]
    param (
        [System.String]
        $DownloadPath,
        [System.Management.Automation.SwitchParameter]
        $Compatible,
        [System.Management.Automation.SwitchParameter]
        $Force
    )

### Reference
# https://docs.microsoft.com/en-us/surface/manage-surface-driver-and-firmware-updates
# https://docs.microsoft.com/en-us/surface/surface-system-sku-reference
# https://www.reddit.com/r/Surface/comments/mlhqw5/all_direct_download_links_for_surface/
# https://dancharblog.wordpress.com/2021/04/06/all-direct-download-links-for-surface-firmware-drivers/

$OSDCatalog = @'
[
    {
        "Name": "Surface 3 WiFi",
        "Model": "Surface 3",
        "Product": "Surface_3",
        "PackageID": "49040"
    },
    {
        "Name": "Surface 3 LTE ATT",
        "Model": "Surface 3",
        "Product": "Surface_3_US1",
        "PackageID": "49039"
    },
    {
        "Name": "Surface 3 LTE Verizon",
        "Model": "Surface 3",
        "Product": "Surface_3_US2",
        "PackageID": "49037"
    },
    {
        "Name": "Surface 3 LTE North America",
        "Model": "Surface 3",
        "Product": "Surface_3_NAG",
        "PackageID": "49037"
    },
    {
        "Name": "Surface 3 LTE Rest of World",
        "Model": "Surface 3",
        "Product": "Surface_3_ROW",
        "PackageID": "49041"
    },
    {
        "Name": "Surface Book",
        "Model": "Surface Book",
        "Product": "Surface_Book",
        "PackageID": "49497"
    },
    {
        "Name": "Surface Book 2 13",
        "Model": "Surface Book 2",
        "Product": "Surface_Book_1832",
        "PackageID": "56261"
    },
    {
        "Name": "Surface Book 2 15",
        "Model": "Surface Book 2",
        "Product": "Surface_Book_1793",
        "PackageID": "56261"
    },
    {
        "Name": "Surface Book 3 13",
        "Model": "Surface Book 3",
        "Product": "Surface_Book_3_1900",
        "PackageID": "101315"
    },
    {
        "Name": "Surface Book 3 15",
        "Model": "Surface Book 3",
        "Product": "Surface_Book_3_1899",
        "PackageID": "101315"
    },
    {
        "Name": "Surface Go Commercial",
        "Model": "Surface Go",
        "Product": "Surface_Go_1824_Commercial",
        "PackageID": "57439"
    },
    {
        "Name": "Surface Go Consumer",
        "Model": "Surface Go",
        "Product": "Surface_Go_1824_Consumer",
        "PackageID": "57439"
    },
    {
        "Name": "Surface Go LTE Commercial",
        "Model": "Surface Go",
        "Product": "Surface_Go_1825_Commercial",
        "PackageID": "57601"
    },
    {
        "Name": "Surface Go 2 Commercial",
        "Model": "Surface Go 2",
        "Product": "Surface_Go_2_1926",
        "PackageID": "101304"
    },
    {
        "Name": "Surface Go 2 Consumer",
        "Model": "Surface Go 2",
        "Product": "Surface_Go_2_1901",
        "PackageID": "101304"
    },
    {
        "Name": "Surface Go 2 LTE",
        "Model": "Surface Go 2",
        "Product": "Surface_Go_2_1927",
        "PackageID": "101304"
    },
    {
        "Name": "Surface Go 3 Commercial",
        "Model": "Surface Go 3",
        "Product": "Surface_Go_3_1926",
        "PackageID": "103504"
    },
    {
        "Name": "Surface Go 3 Consumer",
        "Model": "Surface Go 3",
        "Product": "Surface_Go_3_1901",
        "PackageID": "103504"
    },
    {
        "Name": "Surface Go 3 LTE",
        "Model": "Surface Go 3",
        "Product": "Surface_Go_3_2022",
        "PackageID": "103504"
    },
    {
        "Name": "Surface Hub 2",
        "Model": "Surface Hub 2",
        "Product": "Surface_Hub_2",
        "PackageID": "101974"
    },
    {
        "Name": "Surface Hub 2S 50",
        "Model": "Surface Hub 2S",
        "Product": "Surface Hub 2S",
        "PackageID": "101974"
    },
    {
        "Name": "Surface Hub 2S 85",
        "Model": "Surface Hub 2S",
        "Product": "Surface Hub 2S 85",
        "PackageID": "101974"
    },
    {
        "Name": "Surface Laptop",
        "Model": "Surface Laptop",
        "Product": "Surface_Laptop",
        "PackageID": "55489"
    },
    {
        "Name": "Surface Laptop 2 Commercial",
        "Model": "Surface Laptop 2",
        "Product": "Surface_Laptop_2_1769_Commercial",
        "PackageID": "57515"
    },
    {
        "Name": "Surface Laptop 2 Consumer",
        "Model": "Surface Laptop 2",
        "Product": "Surface_Laptop_2_1769_Consumer",
        "PackageID": "57515"
    },
    {
        "Name": "Surface Laptop 3 13 Intel",
        "Model": "Surface Laptop 3",
        "Product": "Surface_Laptop_3_1867:1868",
        "PackageID": "100429"
    },
    {
        "Name": "Surface Laptop 3 13 AMD",
        "Model": "Surface Laptop 3",
        "Product": "Surface_Laptop_3_1873",
        "PackageID": "100428"
    },
    {
        "Name": "Surface Laptop 3 15 Intel",
        "Model": "Surface Laptop 3",
        "Product": "Surface_Laptop_3_1872",
        "PackageID": "100429"
    },
    {
        "Name": "Surface Laptop 4 13 AMD",
        "Model": "Surface Laptop 4",
        "Product": "Surface_Laptop_4_1958:1959",
        "PackageID": "102923"
    },
    {
        "Name": "Surface Laptop 4 13 Intel",
        "Model": "Surface Laptop 4",
        "Product": "Surface_Laptop_4_1950:1951",
        "PackageID": "102924"
    },
    {
        "Name": "Surface Laptop 4 15 AMD",
        "Model": "Surface Laptop 4",
        "Product": "Surface_Laptop_4_1952:1953",
        "PackageID": "102923"
    },
    {
        "Name": "Surface Laptop 4 15 Intel",
        "Model": "Surface Laptop 4",
        "Product": "Surface_Laptop_4_1978:1979",
        "PackageID": "102924"
    },
    {
        "Name": "Surface Laptop 5 13 Consumer",
        "Model": "Surface Laptop 5",
        "Product": "Surface_Laptop_5_1950:1951",
        "PackageID": "104679"
    },
    {
        "Name": "Surface Laptop 5 13 Commercial",
        "Model": "Surface Laptop 5",
        "Product": "Surface_Laptop_5_for_Business_1950:1951",
        "PackageID": "104679"
    },
    {
        "Name": "Surface Laptop 5 15 Consumer",
        "Model": "Surface Laptop 5",
        "Product": "Surface_Laptop_5_1979",
        "PackageID": "104679"
    },
    {
        "Name": "Surface Laptop 5 15 Commercial",
        "Model": "Surface Laptop 5",
        "Product": "Surface_Laptop_5_for_Business_1979",
        "PackageID": "104679"
    },
    {
        "Name": "Surface Laptop Go",
        "Model": "Surface Laptop Go",
        "Product": "Surface_Laptop_Go_1943",
        "PackageID": "102261"
    },
    {
        "Name": "Surface Laptop Go 2",
        "Model": "Surface Laptop Go 2",
        "Product": "Surface_Laptop_Go_2_2013",
        "PackageID": "104251"
    },
    {
        "Name": "Surface Laptop Studio",
        "Model": "Surface Laptop Studio",
        "Product": "Surface_Laptop_Studio_1964",
        "PackageID": "103505"
    },
    {
        "Name": "Surface Pro",
        "Model": "Surface Pro",
        "Product": "Surface_Pro",
        "PackageID": "49038"
    },
    {
        "Name": "Surface Pro 2",
        "Model": "Surface Pro 2",
        "Product": "Surface_Pro_2",
        "PackageID": "49042"
    },
    {
        "Name": "Surface Pro 3",
        "Model": "Surface Pro 3",
        "Product": "Surface_Pro_3",
        "PackageID": "38826"
    },
    {
        "Name": "Surface Pro 4",
        "Model": "Surface Pro 4",
        "Product": "Surface_Pro_4",
        "PackageID": "49498"
    },
    {
        "Name": "Surface Pro (5th Gen)",
        "Model": "Surface Pro",
        "Product": "Surface_Pro_1796",
        "PackageID": "55484"
    },
    {
        "Name": "Surface Pro with LTE Advanced",
        "Model": "Surface Pro",
        "Product": "Surface_Pro_1807",
        "PackageID": "56278"
    },
    {
        "Name": "Surface Pro 6 Commercial",
        "Model": "Surface Pro 6",
        "Product": "Surface_Pro_6_1796_Commercial",
        "PackageID": "57514"
    },
    {
        "Name": "Surface Pro 6 Consumer",
        "Model": "Surface Pro 6",
        "Product": "Surface_Pro_6_1796_Consumer",
        "PackageID": "57514"
    },
    {
        "Name": "Surface Pro 7",
        "Model": "Surface Pro 7",
        "Product": "Surface_Pro_7_1866",
        "PackageID": "100419"
    },
    {
        "Name": "Surface Pro 7+",
        "Model": "Surface Pro 7+",
        "Product": "Surface_Pro_7+_1960",
        "PackageID": "102633"
    },
    {
        "Name": "Surface Pro 7+ LTE",
        "Model": "Surface Pro 7+",
        "Product": "Surface_Pro_7+_with_LTE_Advanced_1961",
        "PackageID": "102633"
    },
    {
        "Name": "Surface Pro 8",
        "Model": "Surface Pro 8",
        "Product": "Surface_Pro_8_for_Business_1983",
        "PackageID": "103503"
    },
    {
        "Name": "Surface Pro 8 Consumer",
        "Model": "Surface Pro 8",
        "Product": "Surface_Pro_8_1983",
        "PackageID": "103503"
    },
    {
        "Name": "Surface Pro 8 LTE",
        "Model": "Surface Pro 8",
        "Product": "Surface_Pro_8_for_Business_with_LTE_Advanced_1982",
        "PackageID": "103503"
    },
    {
        "Name": "Surface Pro 9 Consumer",
        "Model": "Surface Pro 9",
        "Product": "Surface_Pro_9_2038",
        "PackageID": "104680"
    },
    {
        "Name": "Surface Pro 9 Commercial",
        "Model": "Surface Pro 9",
        "Product": "Surface_Pro_9_for_Business_2038",
        "PackageID": "104680"
    },
    {
        "Name": "Surface Pro 9 5G US",
        "Model": "Surface Pro 9",
        "Product": "Surface_Pro_9_With_5G_1997",
        "PackageID": "104680"
    },
    {
        "Name": "Surface Pro 9 5G ROW",
        "Model": "Surface Pro 9",
        "Product": "Surface_Pro_9_With_5G_1996",
        "PackageID": "104680"
    },
    {
        "Name": "Surface Studio",
        "Model": "Surface Studio",
        "Product": "Surface_Studio",
        "PackageID": "54311"
    },
    {
        "Name": "Surface Studio 2",
        "Model": "Surface Studio 2",
        "Product": "Surface_Studio_2_1707_Commercial",
        "PackageID": "57593"
    }
]
'@

    #=================================================
    # Reference
    #=================================================
    #https://docs.microsoft.com/en-us/surface/surface-system-sku-reference
    #https://docs.microsoft.com/en-us/surface/manage-surface-driver-and-firmware-updates
    #https://support.microsoft.com/en-us/surface/download-drivers-and-firmware-for-surface-09bb2e09-2a4b-cb69-0951-078a7739e120

    #Supported Operating Systems
    #https://support.microsoft.com/en-us/surface/surface-supported-operating-systems-9559cc3c-7a38-31b6-d9fb-571435e84cd1
    #=================================================
    # Paths
    #=================================================
    $UseCatalog             = 'Offline'
    $CloudCatalogUri        = 'https://support.microsoft.com/en-us/surface/download-drivers-and-firmware-for-surface-09bb2e09-2a4b-cb69-0951-078a7739e120'
    $BuildCatalogFile        = Join-Path $env:TEMP (Join-Path 'OSD' 'OSDCatalogMicrosoftDriverPack.json')
    $OfflineCatalogFile     = "$($MyInvocation.MyCommand.Module.ModuleBase)\Catalogs\OSDCatalog\OSDCatalogMicrosoftDriverPack.json"
    $DownloadsBaseUrl         = 'https://www.microsoft.com/en-us/download/confirmation.aspx?id='
    #=================================================
    # Create Paths
    #=================================================
    if (-not(Test-Path (Join-Path $env:TEMP 'OSD'))) {
        $null = New-Item -Path (Join-Path $env:TEMP 'OSD') -ItemType Directory -Force
    }
    #=================================================
    # Test Build Catalog
    #=================================================
    if (Test-Path $BuildCatalogFile) {
        Write-Verbose "Build Catalog already created at $BuildCatalogFile"    

        $GetItemBuildCatalogFile = Get-Item $BuildCatalogFile

        #If the Build Catalog is older than 12 hours, delete it
        if (((Get-Date) - $GetItemBuildCatalogFile.LastWriteTime).TotalHours -gt 12) {
            Write-Verbose "Removing previous Build Catalog"
            $null = Remove-Item $GetItemBuildCatalogFile.FullName -Force
        }
        else {
            $UseCatalog = 'Build'
        }
    }
    #=================================================
    # Test Cloud Catalog
    #=================================================
    if ($Force) {
        $UseCatalog = 'Cloud'
    }
    if ($UseCatalog -eq 'Cloud') {
        if (Test-WebConnection -Uri $CloudCatalogUri) {
            #Catalog is Cloud and can be downloaded
        }
        else {
            $UseCatalog = 'Offline'
        }
    }
    #=================================================
    # UseCatalog Cloud
    #=================================================
    if ($UseCatalog -eq 'Cloud') {
        $Results = $OSDCatalog | ConvertFrom-Json
        $MasterResults = @()
    
        $MasterResults = foreach ($Item in $Results) {
            Write-Verbose "Processing $($Item.Name)"
            $DriverPage = $DownloadsBaseUrl + $Item.PackageID
            $Downloads = (Invoke-WebRequest -Uri $DriverPage -UseBasicParsing).Links
            $Downloads = $Downloads | Where-Object {$_.href -match 'download.microsoft.com'}
            $Downloads = $Downloads | Where-Object {($_.href -match 'Win11') -or ($_.href -match 'Win10')}
            $Downloads = $Downloads | Sort-Object href | Select-Object href -Unique
            #$Downloads = $Downloads | Select-Object -Last 1
            #$Item.Url = ($Downloads).href
            #$Item.FileName = Split-Path $Item.Url -Leaf

            #=================================================
            # Create Object
            #=================================================
            foreach ($Download in $Downloads) {
                $DownloadUrl = $Download.href
                Write-Verbose "Testing Download File at $DownloadUrl"

                $GetUrl = Invoke-WebRequest -Method Head -Uri $DownloadUrl -UseBasicParsing
                $GetHeaders = $GetUrl.Headers
                $GetLastModified = $GetHeaders['Last-Modified']
                Write-Verbose "Last Modified: $GetLastModified"

                $ReleaseDate = (Get-Date $GetLastModified).ToString('yy.MM.dd')
                $FileName = Split-Path $DownloadUrl -Leaf

                if ($FileName -match 'Win11') {
                    $OSVersion = 'Windows 11 x64'
                }
                else {
                    $OSVersion = 'Windows 10 x64'
                }
                
                $ByteArray = [System.Convert]::FromBase64String($GetHeaders['Content-MD5'])
                $HexObject = $ByteArray | Format-Hex
                $HashMD5 = ($HexObject.Bytes | ForEach-Object {"{0:X}" -f $_}) -join ''

                $UniqueFileName = $FileName
                $UniqueFileName = $UniqueFileName -replace '_Win', ' Win'
                $UniqueFileName = $UniqueFileName.Split(' ')[1]
                $UniqueFileName = $UniqueFileName -replace 'Win10_', 'Win10 '
                $UniqueFileName = $UniqueFileName -replace 'Win11_', 'Win11 '
                $UniqueFileName = $UniqueFileName.Split('_')[0]

                $UniqueName = "Microsoft $($Item.Name) $UniqueFileName"

                $ObjectProperties = [ordered] @{
                    CatalogVersion          = Get-Date -Format yy.MM.dd
                    Status                  = $null
                    Component               = 'DriverPack'
                    ReleaseDate             = $ReleaseDate
                    Manufacturer            = 'Microsoft'
                    Model                   = $Item.Model
                    Product                 = $Item.Product
                    Name                    = $UniqueName
                    PackageID               = $Item.PackageID
                    FileName                = $FileName
                    Url                     = $DownloadUrl
                    OSVersion               = $OSVersion
                    HashMD5                 = $HashMD5
                }
                New-Object -TypeName PSObject -Property $ObjectProperties
            }
        }
        $MasterResults | ConvertTo-Json | Out-File $BuildCatalogFile -Encoding ascii -Width 2000 -Force

        if (Test-Path $BuildCatalogFile) {
            $UseCatalog = 'Build'
        }
        else {
            Write-Verbose "Could not locate $BuildCatalogFile"
            $UseCatalog = 'Offline'
        }
    }
    #=================================================
    # UseCatalog Build
    #=================================================
    if ($UseCatalog -eq 'Build') {
        Write-Verbose "Importing the Build Catalog at $BuildCatalogFile"
        $MasterResults = Get-Content -Path $BuildCatalogFile | ConvertFrom-Json
    }
    #=================================================
    # UseCatalog Offline
    #=================================================
    if ($UseCatalog -eq 'Offline') {
        Write-Verbose "Importing the Offline Catalog at $OfflineCatalogFile"
        $MasterResults = Get-Content -Path $OfflineCatalogFile | ConvertFrom-Json
    }
    #=================================================
    # Compatible
    #=================================================
    if ($PSBoundParameters.ContainsKey('Compatible')) {
        $MyComputerProduct = Get-MyComputerProduct
        Write-Verbose "Filtering Catalog for items compatible with Product $MyComputerProduct"
        $MasterResults = $MasterResults | Where-Object {$_.Product -contains $MyComputerProduct}
    }
    #=================================================
    # DownloadPath
    #=================================================
    if ($PSBoundParameters.ContainsKey('DownloadPath')) {
        $MasterResults = $MasterResults | Out-GridView -Title 'Select one or more files to Download' -PassThru -ErrorAction Stop
        foreach ($Item in $MasterResults) {
            $OutFile = Save-WebFile -SourceUrl $Item.Url -DestinationDirectory $DownloadPath -DestinationName $Item.FileName -Verbose
            $Item | ConvertTo-Json | Out-File "$($OutFile.FullName).json" -Encoding ascii -Width 2000 -Force
        }
    }
    #=================================================
    # Results
    #=================================================
    $MasterResults | Sort-Object -Property Name
    #=================================================
}