Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/aaronparker/evergreen

Create evergreen Windows image build pipelines with the latest version numbers and download URLs for common applications
https://github.com/aaronparker/evergreen

applications automation configmgr endpoint-manager evergreen intune packer powershell-gallery psgallery updates

Last synced: about 2 months ago
JSON representation

Create evergreen Windows image build pipelines with the latest version numbers and download URLs for common applications

Awesome Lists containing this project

README 

        
# About



[![License][license-badge]][license]

[![PowerShell Gallery Version][psgallery-version-badge]][psgallery]

[![PowerShell Gallery][psgallery-badge]][psgallery]

[![codecov](https://codecov.io/gh/aaronparker/evergreen/branch/main/graph/badge.svg?token=QK2YKUgCBX)](https://codecov.io/gh/aaronparker/evergreen)



![Evergreen icon](/img/evergreenbulb.png)



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



* [Image creation with Hashicorp Packer](https://github.com/aaronparker/packer) - images can be created with the latest version of a set of applications

* Import applications into Configuration Manager or [Microsoft Intune](https://github.com/aaronparker/packagefactory) and keep applications up to date with the latest versions

* Validating or auditing a desktop image to ensure the current version of an application is installed

* Create a [library of application installers](https://stealthpuppy.com/evergreen/newlibrary/) - by regularly running Evergreen functions, you can retrieve and download the current version of an application and store it in an application directory structure for later use

* [Track application updates](https://stealthpuppy.com/apptracker) to stay on top of new releases

* Submitting manifests to `Winget` or `Chocolatey` or similar - Evergreen can return an object with a version number and download URL that can be used to construct manifests for the most recent versions



Via `Get-EvergreenApp` each Evergreen application returns at least two properties in the object sent to the pipeline:



* `Version` - a string property that is the version number of the application. If you need these in a version format, cast them with `[System.Version]`

* `URI` - a string property that is the download location for the latest version of the application. These will be publicly available locations that provide installers in typically Windows installer formats, e.g., `exe`, `msi`. Some downloads may be in other formats, such as `zip` that will need to be extracted before install



![Alt](https://repobeats.axiom.co/api/embed/ab0139306213ed1f2e467127afeb269dc57bb353.svg "Repobeats analytics image")



## How Evergreen Works



**Application version and download links are only pulled from official sources (vendor's web site, vendor's application update API, GitHub, SourceForge etc.) and never a third party**.



Evergreen uses an approach that returns at least the version number and download URI for applications programmatically - thus for each run an Evergreen function it should return the latest version and download link.



Evergreen uses several strategies to return the latest version of software:



1. Application update APIs - by using the same approach as the application itself, Evergreen can consistently return the latest version number and download URI - e.g., [Microsoft Edge](/Evergreen/Public/Get-MicrosoftEdge.ps1), [Mozilla Firefox](/Evergreen/Apps/Get-MozillaFirefox.ps1) or [Microsoft OneDrive](/Evergreen/Apps/Get-MicrosoftOneDrive.ps1). [Fiddler](https://www.telerik.com/fiddler) can often be used to find where an application queries for updates

2. Repository APIs - repo hosts including GitHub and SourceForge have APIs that can be queried to return application version and download links - e.g., [Audacity](/Evergreen/Apps/Get-Audacity.ps1), [Notepad++](/Evergreen/Apps/Get-NotepadPlusPlus.ps1) or [WinMerge](/Evergreen/Apps/Get-WinMerge.ps1)

3. Web page queries - often a vendor download pages will include a query that returns JSON when listing versions and download links - this avoids page scraping. Evergreen can mimic this approach to return application download URLs; however, this approach is likely to fail if the vendor changes how their pages work - e.g., [Adobe Acrobat Reader DC](/Evergreen/Apps/Get-AdobeAcrobatReaderDC.ps1)

4. Static URLs - some vendors provide static or evergreen URLs to their application installers. These URLs often provide additional information in the URL that can be used to determine the application version and can be resolved to the actual target URL - e.g., [Microsoft FSLogix Apps](/Evergreen/Apps/Get-MicrosoftFSLogixApps.ps1) or [Zoom](/Evergreen/Apps/Get-Zoom.ps1)



## What Evergreen Doesn't Do



Evergreen does not scrape HTML - scraping web pages to parse text and determine version strings and download URLs can be problematic when text in the page changes or the page is out of date. Pull requests that use web page scraping will be closed.



While the use of RegEx to determine application properties (particularly version numbers) is used for some applications, this approach is not preferred, if possible.



For additional applications where the only recourse it to use web page scraping, see the [Nevergreen](https://github.com/DanGough/Nevergreen) project.



## Why



There are several community and commercial products that manage application deployment and updates already. This module isn't intended to compete against those. In fact, they can be complementary - for example, Evergreen can be used with the [Chocolatey Automatic Package Updater Module](https://www.powershellgallery.com/packages/AU/) to find the latest version of an application and then creating and submitting a Chocolatey package, or it can be used to create a [Windows Package Manager](https://github.com/microsoft/winget-create) manifest.



Evergreen's focus is on integration for PowerShell scripts to provide product version numbers and download URLs. Ideal for use with the Microsoft Deployment Toolkit or Microsoft Configuration Manager for operating system deployment, creating applications packages in Microsoft Intune, or with [Packer](https://www.packer.io/) to create evergreen machine images in Azure, AWS, GCP etc.



## Documentation



Documentation for Evergreen, including usage examples, is located here: [https://stealthpuppy.com/evergreen/](https://stealthpuppy.com/evergreen/).



## 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 as simple as possible to understand when the last update was made. See the [CHANGELOG](https://stealthpuppy.com/evergreen/changelog/) for details on changes introduced in each version.



## Installing the Module



### PowerShell Support



Evergreen supports Windows PowerShell 5.1 and PowerShell 7.0+. Evergreen should work on PowerShell Core 6.x; however, we are not actively testing on that version of PowerShell, so support cannot be guaranteed.



### Install from the PowerShell Gallery



The Evergreen module is published to the PowerShell Gallery and can be found here: [Evergreen](https://www.powershellgallery.com/packages/Evergreen/). This is the best and recommend method to install Evergreen.



The module can be installed from the gallery with:



```powershell

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 `Update-Module` and the `-Force` parameter:



```powershell

Update-Module -Name Evergreen -Force

```



### Manual Installation from the Repository



The module can be downloaded from the [GitHub source repository](https://github.com/aaronparker/evergreen) 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 `main 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  -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:



```powershell

Import-Module -Name Evergreen

```



[psgallery-badge]: https://img.shields.io/powershellgallery/dt/Evergreen.svg?style=flat-square

[psgallery]: https://www.powershellgallery.com/packages/Evergreen

[psgallery-version-badge]: https://img.shields.io/powershellgallery/v/Evergreen.svg?style=flat-square

[license-badge]: https://img.shields.io/github/license/aaronparker/Evergreen.svg?style=flat-square

[license]: /LICENSE



---

[Greentech icon by Icons8](https://icons8.com/icon/set/bulb/3d-fluency)