Gets windows patch release information (Version, Build, Availability date, Preview, Out-of-band, Servicing option, KB article, KB URL and Catalog URL) for Windows client and server versions. Useful for scripting and automation purposes. Supports Windows 10 and Windows Server 2016 onwards.
Patch information retrieved from the release health portal and outputted in a usable format. This source is updated regularly by Microsoft AFTER new patches are released. This means at times this info may not always in sync with Windows Update.
WindowsOSBuild supports Windows PowerShell 5.0, 5.1 and 7.0+.
The WindowsOSBuild module is published to the PowerShell Gallery and can be found here: WindowsOSBuild. This is the best and recommend method to install WindowsOSBuild.
The module can be installed from the gallery with:
Install-Module -Name WindowsOSBuild
If you have installed a previous version of the module from the gallery, you can install the latest update with Update-Module
and the -Force
parameter:
Update-Module -Name WindowsOSBuild -Force
Gets windows patch release information (Build, KB Number, Release Date etc) for Windows client and server versions. Useful for scripting and automation purposes. Supports Windows 10 and Windows Server 2016 onwards.
- OSName
This parameter is optional. OS name you want to check. Default value is Win10. Supported accepted values:
OS Name | Version |
---|---|
Windows Client OS Names | Win10, Win11. |
Windows Server OS Names | Server2016, Server2019, Server2022, Server Semi-annual = ServerSAC. |
- OSVersion
This parameter is mandatory. OS version number you want to check. Supported accepted values:
Windows Client OS | Version |
---|---|
CB/CBB/SAC (Semi-Annual Channel) | 1507, 1511, 1607, 1703, 1709, 1803, 1809, 1903, 1909, 2004, 20H2, 21H1, 21H2. |
LTSB/LTSC (Long-Term Servicing Build/Channel) | 2015 = 1507, 2016 = 1607, 2019 = 1809, 2021 = 21H2. |
Windows Server OS | Version |
---|---|
SAC (Semi-Annual Channel) | 1709, 1803, 1809, 1903, 1909, 2004, 20H2. |
LTSB/LTSC (Long-Term Servicing Build/Channel) | 2016 = 1607, 2019 = 1809, 2022 = 21H2. |
- LatestReleases
This parameter is optional. Returns last x releases (where x is the number of releases you want to display). Default value is 1.
- BuildOnly
This parameter is optional. Returns only the full build number/s of the OS Version.
- ExcludePreview
This parameter is optional. Excludes preview releases.
- ExcludeOutOfBand
This parameter is optional. Excludes out-of-band releases.
Gets the currently installed OS Build release number for Windows 10 including Windows Server versions.
Installed OS Build number or detailed information (Version, Build, Availability date, Preview, Out-of-band, Servicing option, KB article, KB URL and Catalog URL).
- Detailed
This parameter is optional. Returns detailed information about the installed OS Build.
Show only the build number for the installed OS Build.
Get-CurrentOSBuild
Show detailed information for the installed OS Build.
Get-CurrentOSBuild -Detailed
Show all information on the latest available OS Build for Version 21H1 in list format.
Get-LatestOSBuild -OSName Win10 -OSVersion 21H1
Show all information on the latest 2 releases of OS Builds for Version 21H1 in list format.
Get-LatestOSBuild -OSName Win10 -OSVersion 21H1 -LatestReleases 2
Show all information on the latest 2 releases (excluding preview) of OS Builds for Windows 10 Version 21H1 in list format.
Get-LatestOSBuild -OSName Win10 -OSVersion 21H1 -ExcludePreview -LatestReleases 2
Show all information on the latest 2 releases (excluding out-of-band) of OS Builds for Windows 10 Version 21H1 in list format.
Get-LatestOSBuild -OSName Win10 -OSVersion 21H1 -ExcludeOutOfBand -LatestReleases 2
Show only the latest available OS Build for Version 21H1 in list format.
Get-LatestOSBuild -OSName Win10 -OSVersion 21H1 -BuildOnly
Show all information on the latest available OS Build for Version 21H1 in json format.
Get-LatestOSBuild -OSName Win10 -OSVersion 21H1 | ConvertTo-Json
Save the json format to a file on the latest available OS Build for Version 21H1.
Get-LatestOSBuild -OSName Win10 -OSVersion 21H1 | ConvertTo-Json | Out-File .\Get-LatestOSBuild.json
PS C:\Users\Ashley> Get-CurrentOSBuild
19044.1415
PS C:\Users\Ashley> Get-CurrentOSBuild -Detailed
Version : Version 21H2 (OS build 19044)
Build : 19044.1415
Availability date : 2021-12-14
Preview : False
Out-of-band : False
Servicing option : LTSC • General Availability Channel
KB article : KB5008212
KB URL : https://support.microsoft.com/help/5008212
Catalog URL : https://www.catalog.update.microsoft.com/Search.aspx?q=KB5008212
PS C:\Users\Ashley> Get-LatestOSBuild -OSName Win10 -OSVersion 21H1 -LatestReleases 2 -BuildOnly
19043.1266
19043.1237
PS C:\Users\Ashley> Get-LatestOSBuild -OSName Win10 -OSVersion 21H1 -LatestReleases 2
Version : Version 21H1 (OS build 19043)
Build : 19043.1387
Availability date : 2021-11-22
Preview : True
Out-of-band : False
Servicing option : Semi-Annual Channel
KB article : KB5007253
KB URL : https://support.microsoft.com/help/5007253
Catalog URL : https://www.catalog.update.microsoft.com/Search.aspx?q=KB5007253
Version : Version 21H1 (OS build 19043)
Build : 19043.1348
Availability date : 2021-11-09
Preview : False
Out-of-band : False
Servicing option : Semi-Annual Channel
KB article : KB5007186
KB URL : https://support.microsoft.com/help/5007186
Catalog URL : https://www.catalog.update.microsoft.com/Search.aspx?q=KB5007186
PS C:\Users\Ashley> Get-LatestOSBuild -OSName Win10 -OSVersion 21H1 -LatestReleases 20 | Format-Table
Version Build Availability date Preview Out-of-band Servicing option KB article KB URL Catalog URL
------- ----- ----------------- ------- ----------- ---------------- ---------- ------ -----------
Version 21H1 (OS build 19043) 19043.1387 2021-11-22 True False Semi-Annual Channel KB5007253 https://support.microsoft.com/help/5007253 https://www.catalog.update.microsoft.com/Search.aspx?q=KB5007253
Version 21H1 (OS build 19043) 19043.1348 2021-11-09 False False Semi-Annual Channel KB5007186 https://support.microsoft.com/help/5007186 https://www.catalog.update.microsoft.com/Search.aspx?q=KB5007186
Version 21H1 (OS build 19043) 19043.1320 2021-10-26 True False Semi-Annual Channel KB5006738 https://support.microsoft.com/help/5006738 https://www.catalog.update.microsoft.com/Search.aspx?q=KB5006738
Version 21H1 (OS build 19043) 19043.1288 2021-10-12 False False Semi-Annual Channel KB5006670 https://support.microsoft.com/help/5006670 https://www.catalog.update.microsoft.com/Search.aspx?q=KB5006670
Version 21H1 (OS build 19043) 19043.1266 2021-09-30 True False Semi-Annual Channel KB5005611 https://support.microsoft.com/help/5005611 https://www.catalog.update.microsoft.com/Search.aspx?q=KB5005611
Version 21H1 (OS build 19043) 19043.1237 2021-09-14 False False Semi-Annual Channel KB5005565 https://support.microsoft.com/help/5005565 https://www.catalog.update.microsoft.com/Search.aspx?q=KB5005565
Version 21H1 (OS build 19043) 19043.1202 2021-09-01 True False Semi-Annual Channel KB5005101 https://support.microsoft.com/help/5005101 https://www.catalog.update.microsoft.com/Search.aspx?q=KB5005101
Version 21H1 (OS build 19043) 19043.1165 2021-08-10 False False Semi-Annual Channel KB5005033 https://support.microsoft.com/help/5005033 https://www.catalog.update.microsoft.com/Search.aspx?q=KB5005033
Version 21H1 (OS build 19043) 19043.1151 2021-07-29 True False Semi-Annual Channel KB5004296 https://support.microsoft.com/help/5004296 https://www.catalog.update.microsoft.com/Search.aspx?q=KB5004296
Version 21H1 (OS build 19043) 19043.1110 2021-07-13 False False Semi-Annual Channel KB5004237 https://support.microsoft.com/help/5004237 https://www.catalog.update.microsoft.com/Search.aspx?q=KB5004237
Version 21H1 (OS build 19043) 19043.1083 2021-07-06 False True Semi-Annual Channel KB5004945 https://support.microsoft.com/help/5004945 https://www.catalog.update.microsoft.com/Search.aspx?q=KB5004945
Version 21H1 (OS build 19043) 19043.1082 2021-06-29 False True Semi-Annual Channel KB5004760 https://support.microsoft.com/help/5004760 https://www.catalog.update.microsoft.com/Search.aspx?q=KB5004760
Version 21H1 (OS build 19043) 19043.1081 2021-06-21 True False Semi-Annual Channel KB5003690 https://support.microsoft.com/help/5003690 https://www.catalog.update.microsoft.com/Search.aspx?q=KB5003690
Version 21H1 (OS build 19043) 19043.1055 2021-06-11 False True Semi-Annual Channel KB5004476 https://support.microsoft.com/help/5004476 https://www.catalog.update.microsoft.com/Search.aspx?q=KB5004476
Version 21H1 (OS build 19043) 19043.1052 2021-06-08 False False Semi-Annual Channel KB5003637 https://support.microsoft.com/help/5003637 https://www.catalog.update.microsoft.com/Search.aspx?q=KB5003637
Version 21H1 (OS build 19043) 19043.1023 2021-05-25 True False Semi-Annual Channel KB5003214 https://support.microsoft.com/help/5003214 https://www.catalog.update.microsoft.com/Search.aspx?q=KB5003214
Version 21H1 (OS build 19043) 19043.985 2021-05-18 False False Semi-Annual Channel KB5003173 https://support.microsoft.com/help/5003173 https://www.catalog.update.microsoft.com/Search.aspx?q=KB5003173
To compare you can use the following code example. This will compare a device's current OS build against the latest available OS build of Windows 10 21H2 (including out-of-band and excluding preview builds) this can be changed as required and guidance can be found above. The $Status variable can used in your RMM, monitoring solution or scripts as required.
$InstalledOSBuild = Get-CurrentOSBuild
$LatestOSBuilds = Get-LatestOSBuild -OSName Win10 -OSVersion 21H2 -LatestReleases 1 -ExcludePreview
If ($LatestOSBuilds -like "*$InstalledOSBuild*") {
Write-Output "OK - OS Build is up to date"
$Status = "OK"
}
Else {
Write-Output "Warning - OS Build is out of date"
$Status = "Warning"
}
This module is maintained by the following
- Ashley How, @AshleyHow1
Forked from Get-Windows10ReleaseInformation.ps1 created by Fredrik Wall
Uses code adapted from Get-CurrentPatchInfo.ps1 created by Trevor Jones