public/Find-LatestUpdate.ps1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
function Find-LatestUpdate {
<#

    .SYNOPSIS
Finds the latest delta or cumulative update for Windows or Windows Server operating system


    .DESCRIPTION
This script will return the list of links to updates for Windows 10 and Windows Server 2016 from the Microsoft Update Catalog.


    .PARAMETER Build
Windows 10 Build Number used to filter available Downloads

    10240 - Windows 10 Version 1507
    10586 - Windows 10 Version 1511
    14393 - Windows 10 Version 1607 and Windows Server 2016
    15063 - Windows 10 Version 1703
    16299 - WIndows 10 Version 1709
    17134 - Windows 10 Version 1803 (default value)


    .PARAMETER Platform
Windows hardware platform to select updates for. Parameter can take the following values:

    x64 (default value)
    x86
    arm64


    .PARAMETER Type
Update type. Parameter can take the following values:

    Cumulative (default value)
    Delta


    .NOTES
Copyright Keith Garner (KeithGa@DeploymentLive.com), All rights reserved.
Copyright Andriy Melnyk (mao@bebee.xyz), all rights reserved


    .LINK
https://support.microsoft.com/en-us/help/4000823


    .EXAMPLE
Get link to the latest Cumulative update for Windows 10, both for x86 and x64 platforms

    Find-LatestUpdate -verbose


    .EXAMPLE
Get link to the latest Cumulative update for Windows 10 x86

    Find-LatestUpdate -filter Cumulative, x86


    .EXAMPLE
Get the latest Cumulative Update for the build 14393, x64 platform

    Find-LatestUpdate -filter Cumulative, x64 -build 14393


    .EXAMPLE
Get the latest Cumulative Updates for Windows 10 (both x86 and x64) and download to the %TEMP% directory.

    Find-LatestUpdate | %{ Start-BitsTransfer -Source $_ -Destination $ENV:Temp }


    .EXAMPLE
Get the latest cumulative update for x64 platform
    Find-LatestUpdate -build 17134 | ? { ($_.Platform -eq x64) -and ($_.Type -eq Cumulative) }

#>


    [CmdletBinding()]
    Param(
        [String]
            [Parameter(
                HelpMessage = "Windows build number.",
                Position = 0
            )]
            [ValidateSet( '17134', '16299', '15063', '14393', '10586', '10240' )]
        $Build = '17134',

        [String]
            [Parameter(
                HelpMessage = "Hardware platform.",
                Position = 1
            )]
            [ValidateSet( 'x64', 'x86', 'arm64' )]
        $Platform = 'x64',

        [String]
            [Parameter(
                HelpMessage = "Update type (Cumulative or Delta).",
                Position = 2
            )]
            [ValidateSet( 'Cumulative', 'Delta' )]
        $Type = 'Cumulative'
    )

    Begin {}

    Process {
        # Find KB article for the latest update for selected build
        $article = Find-UpdateMetadata |
            Where-Object { $_.Version.Major -eq $Build } |
            Sort-Object Version |
            Select-Object -Last 1
        Write-Verbose "Found article: KB$( $article.articleId )"

        $article |
            Find-ArticleUri |
            Find-AssetGuid |
            Where-Object {
                ($_.Platform -eq $Platform) -and
                ($_.Type -eq $Type)
            } |
            Find-AssetUri |
            Select-Object -Unique
    }

    End {}
}