Skip to content
A PowerShell module to return the latest version software and download links for various software
PowerShell
Branch: master
Clone or download

README.md

About

License PowerShell Gallery Version PowerShell Gallery Master build status

Evergreen is a simple PowerShell module to return the latest version and download URLs for a set of common enterprise applications. The module consists of a number of simple commands to use in scripts when performing several tasks including:

  • Retrieve the latest version of a particular software product when comparing against a version already installed or downloaded
  • Return the URL for the latest version of a software product if you need to download it locally

All functions consist of the following:

  • Get verb - the module provides functions to retrieve data only
  • Vendor - the vendor / developer of the application (e.g. Adobe, Google, Microsoft)
  • Product name - product names and optionally version (e.g. Reader DC, Chrome, VisualStudioCode)

Why

There are several community and commercial products that manage application deployment and updates already. This module isn't intended to compete against those. Instead the focus is on simple integration for PowerShell scripts to provide product version numbers and download URLs. Data will only be pulled from the vendor web site and never a third party.

How

Evergreen uses a couple of approaches to returning the latest version of software. Instead of scraping web pages, the primary methods used are:

  1. Application update APIs - by using the same approach as the application itself, Evergreen can consistently return the latest version number and download URI
  2. Web APIs - often a vendor download pages will include a query when listing versions and download links. Evergreen can use the same approach

Who

This module is maintained by the following community members

Versioning

The module uses a version notation that follows: YearMonth.Build. It is expected that the module will have changes on a regular basis, so the version numbering is intended to make it easy to understand when the last update was made.

Installing the Module

Install from the PowerShell Gallery

The Evergreen module is published to the PowerShell Gallery and can be found here: Evergreen. The module can be installed from the gallery with:

Install-Module -Name Evergreen
Import-Module -Name Evergreen

Updating the Module

If you have installed a previous version of the module from the gallery, you can install the latest update with the -Force parameter:

Install-Module -Name Evergreen -Force

Manual Installation from the Repository

The module can be downloaded from the GitHub source repository and includes the module in the Evergreen folder. The folder needs to be installed into one of your PowerShell Module Paths. To see the full list of available PowerShell Module paths, use $env:PSModulePath.split(';') in a PowerShell console.

Common PowerShell module paths include:

  • Current User: %USERPROFILE%\Documents\WindowsPowerShell\Modules\
  • All Users: %ProgramFiles%\WindowsPowerShell\Modules\
  • OneDrive: $env:OneDrive\Documents\WindowsPowerShell\Modules\

To install from the repository

  1. Download the master branch to your workstation
  2. Copy the contents of the Evergreen folder onto your workstation into the desired PowerShell Module path
  3. Open a Powershell console with the Run as Administrator option
  4. Run Set-ExecutionPolicy using the parameter RemoteSigned or Bypass
  5. Unblock the files with Get-ChildItem -Path <path to module> -Recurse | Unblock-File

Once installation is complete, you can validate that the module exists by running Get-Module -ListAvailable Evergreen. To use the module, load it with:

Import-Module Evergreen
You can’t perform that action at this time.