This PowerShell module provides a set of commands for working with the latest releases from the PowerShell GitHub repository. The module contains commands to get summary information about the most current release as well as commands to download some or all of the release files.
These commands utilize the GitHub API which is subject to rate limits. It is recommended that you save results of commands like Get-PSReleaseAsset to a variable. If you encounter an error message for Invoke-RestMethod like "Server Error" then you have likely exceeded the API limit. You will need to wait a bit and try again.
This module should work cross-platform on both Windows PowerShell and PowerShell Core.
The module currently has 6 commands:
- Get-PSReleaseSummary
- Get-PSReleaseCurrent
- Get-PSReleaseAsset
- Save-PSReleaseAsset
- Install-PSCore
- Install-PSPreview
All of the functions take advantage of the GitHub API which in combination with either Invoke-RestMethod or Invoke-WebRequest, allow you to programmatically interact with GitHub.
The first command, Get-PSReleaseSummary queries the PowerShell repository release page and constructs a text summary. You can also have the command write the report text as markdown.
I put the release name and date right at the top so you can quickly check if you need to download something new. In GitHub, each release file is referred to as an asset. The Get-PSReleaseAsset command will query GitHub about each file and write a custom object to the pipeline.
By default it will display assets for all platforms, but I added a -Family parameter if you want to limit yourself to a single entry like MacOS.
Of course, you will want to download these files which is the job of the last command. By default the command will save all files to the current directory unless you specify a different path. You can limit the selection to a specific platform via the -Family parameter which uses a validation set.
You can select multiple names. If you select only Window, then there is a dynamic parameter called -Format where you can select ZIP or MSI. And the command supports -WhatIf.
I also realized you might run Get-PSReleaseAsset, perhaps to examine details before downloading. Since you have those objects, why not be able to pipe them to the save command?
The current version of this module uses regular expression named captures to pull out the file name and corresponding SHA256 hashes. The save command then calls Get-FileHash to get the current hash and compares them.
Starting in v0.8.0, command modules have a -Preview parameter which will get the latest preview build. Otherwise, the commands will use the latest stable release.
On Windows, it is pretty easy to install a new build with a one-line command like this:
Get-PSReleaseAsset -Family Windows -Only64Bit -Format msi | Save-PSReleaseAsset -Path d:\temp -Passthru | Invoke-ItemOr you can use one of two newer functions to install the latest 64bit release. You can specify the interaction level.
Install-PSPreview will download the latest 64 bit preview build for Windows and kick off the installation.
Install-PSPreview -mode passiveInstall-PSCore will do the same thing but for the latest stable release.
The functionality of these commands could have been combined, but I decided to leave this as separate commands so there is no confusion about what you are installing.
Non-Windows platforms have existing installation tools that work great from the command-line. Plus, I don't have the resources to develop and test installation techniques for all of the non-Windows options. That is why install-related commands in this module are limited to Windows.
This module has been published to the PowerShell Gallery. You should be able to run these commands to find and install it.
Install-Module PSReleaseToolsOn PowerShell Core you might need to run:
Install-Module PSReleaseTools -scope currentuserI have a few other ideas for commands I might add to this module. If you have suggestions or encounter problems, please post an issue in the GitHub repository.
Last Updated 2019-07-18 18:07:49Z UTC