Skip to content

Known issues

General

Where an application source is unavailable the value of the URI property returned may be https://stealthpuppy.com/evergreen/issues/. If you encounter this scenario, follow the troubleshooting steps.

Public Functions

Get-EvergreenApp

Get-EvergreenApp may not fully support proxy servers. This will be fixed in a future release.

Private Functions

Resolve-DnsNameWrapper

Supports Windows platforms only - this function wraps Resolve-DnsName which is not available under PowerShell 6+ on macOS or Linux. Application functions that use this private function will return an error on non-Windows platforms.

Get-GitHubRepoRelease

Get-GitHubRepoRelease queries release information from a specified GitHub repository to return version and binaries or is used to source the version number for some applications. This function uses an unauthenticated session to the GitHub REST API, thus requests will be [rate limited]. Using the -Verbose parameter with Get-EvergreenApp for those applications that use GitHub as the source, will display the number of available requests to the API.

Updating Get-GitHubRepoRelease to support authenticated requests is planned for a future release.

Application Functions

7zip

The 32-bit installers returned by 7Zip link to a SourceForge download page instead of the file directly. These installers can be downloaded by Invoke-WebRequest by setting the UserAgent to the Googlebot.

AdobeAcrobat

Where Adobe releases an update for Acrobat/Reader DC for Windows ahead of macOS, the current patch release may not be returned. In most cases, Adobe keeps both platforms in sync, so this should be a rare occurrence.

The determine the current update version of AdobeAcrobat, the URL for macOS updates is used. This provides a simple text lookup of the latest version number.

Note

The Windows version of Adobe Acrobat and Reader uses an update URL like: https://armmf.adobe.com/arm-manifests/win/AcrobatDCManifest3.msi, which would require unpacking and parsing the MSI file. Sample code to query the MSI database has been posted here: AdobeReader download links not valid; however, this approach will only work on a Windows hosts and will not support macOS or Linux.

Alternative application - AdobeAcrobatDC and AdobeAcrobatReaderDC use a web API lookup to determine the current version of Adobe Acrobat Reader DC, Acrobat Standard DC, and Acrobat Pro DC. Earlier version of Acrobat are still affected by this issue.

AdobeAcrobatReaderDC

AdobeAcrobatReaderDC may not return an installer with the latest update. This application determines the available installers from the Adobe Acrobat Reader download page - Adobe does not always immediately make the latest update available in the current downloadable installer version.

Validate whether AdobeAcrobat returns the latest update version.

CiscoWebEx

The versions returned for Cisco WebEx may be out of date. Refer to Cisco WebEx - new app available, Evergreen returning legacy version only until a fix is found.

CitrixWorkspaceApp

HDX RealTime Media Engine

The version of the HDX RealTime Media Engine for Microsoft Skype for Business for Windows returned by CitrixWorkspaceApp is out of date. This is the version of the HDX RTME that is returned by the Workspace App update feed (https://downloadplugins.citrix.com/ReceiverUpdates/Prod/catalog_win.xml). Use CitrixWorkspaceAppFeed to find the latest version of the HDX RTME.

Note

CitrixWorkspaceAppFeed returns a link to the download page and not the installer directly. See Get-CitrixWorkspaceApp does not return the latest Citrix HDX RealTime Media Engine.

404 Error

Occasionally Get-EvergreenApp -Name "CitrixWorkspaceApp" may fail with the following error:

WARNING: Invoke-RestMethodWrapper: Error at URI: https://downloadplugins.citrix.com/ReceiverUpdates/Prod/catalog_win.xml.
WARNING: Invoke-RestMethodWrapper: Error encountered: Response status code does not indicate success: 404 (Not Found)..
WARNING: Invoke-RestMethodWrapper: For troubleshooting steps see: https://stealthpuppy.com/evergreen/troubleshoot/.

This typically occurs right after the release of a new version of the Workspace app and may return this result for some time. Right after a new release of the Workspace app, Citrix often makes the update XML file unavailable so that clients do not update immediately. You may have to wait until Citrix makes the URL available again for this function to work.

Out of Date Update Feed

Occasionally Get-EvergreenApp -Name "CitrixWorkspaceApp" may not return the latest version of the Citrix Workspace app. This is due to Citrix making changes to the update feed at https://downloadplugins.citrix.com/ReceiverUpdates/Prod/catalog_win.xml to throttle or prevent automatic rollout of the latest Workspace app. The only recourse is to wait until Citrix corrects the update feed to include the latest version of the Workspace app again.

GhislerTotalCommander

Supports Windows platforms only - this application relies on Resolve-DnsName which is not available under PowerShell 6+ on macOS or Linux.

LibreOffice

Attention

LibreOffice has been removed from Evergreen due to on-going changes that TDF makes to the update mechanism.

LibreOffice uses the update host at https://update.libreoffice.org/check.php to determine the available update release. The Document Foundation does not immediately make the update host return the latest version at the time of release. In a scenario where the update host does not return the very latest version and the TDF has pulled the downloads for the same version returned from the update host, LibreOffice is unable to build valid download links.

The only recourse at this time is to wait until the TDF tells the update host to return the latest version. Also see LibreOffice version

Microsoft365Apps

Microsoft365Apps returns publicly documented channels only. Additional channels may be available from the Microsoft 365 Apps update API; however, these may not align to channels documented at microsoft.com, so are not included in this function.

Channel properties are listed in the following articles: Configuration options for the Office Deployment Tool, Update channel for Office LTSC 2021, Update channel for Office 2019.

Full channel names are listed here: Update history for Microsoft 365 Apps.

MicrosoftFSLogixApps

Depending on release schedules, the preview version of the FSLogix Apps download may not be available. The preview version is found here: https://aka.ms/fslogix/downloadpreview - if no preview version is behind this URL, Get-EvergreenApp -Name MicrosoftFSLogixApps will return an error when attempting to resolve the preview URL, but will continue to return the release version.

MicrosoftSsms

The product release feed used by the Microsoft SQL Server Management Studio (e.g., SSMS_PRODUCTRELEASESFEED.xml) includes the internal build number of the SQL Server Management Studio and not the display version, thus the version return will be similar to 15.0.18369.0 instead of the display version: 18.9.1. See Download SQL Server Management Studio (SSMS) for more info. Also see SQL SSMS is reporting the wrong version.

MicrosoftTeams

The version number returned by the Microsoft Teams update API may be slightly different to the version number displayed in the ProductVersion property in the MSI or in Programs and Features. For example, Get-EvergreenApp -Name MicrosoftTeams may report a version number of 1.4.00.8872, but the Windows Installer may report 1.4.0.8872. Also see Get-MicrosoftTeams displays slightly wrong formatted version number.

MicrosoftWvdRemoteDesktop

MicrosoftWvdRemoteDesktop may report an HTTP 503 error from some URLs (see an example below). This is intermittent behavior, but the function should still usable data. Suppress this warning with `-WarningAction "SilentlyContinue".

WARNING: Invoke-WebRequestWrapper: Error at URI: https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RE50Mp8.
WARNING: Invoke-WebRequestWrapper: Error encountered: Response status code does not indicate success: 503 (Service Unavailable)..
WARNING: Invoke-WebRequestWrapper: For troubleshooting steps see: https://stealthpuppy.com/evergreen/troubleshoot/.
WARNING: Get-MicrosoftWvdRemoteDesktop: Unable to retrieve headers from https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RE50Mp8.
WARNING: Invoke-WebRequestWrapper: Error at URI: https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RE50t3P.
WARNING: Invoke-WebRequestWrapper: Error encountered: Response status code does not indicate success: 503 (Service Unavailable)..
WARNING: Invoke-WebRequestWrapper: For troubleshooting steps see: https://stealthpuppy.com/evergreen/troubleshoot/.
WARNING: Get-MicrosoftWvdRemoteDesktop: Unable to retrieve headers from https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RE50t3P.

MozillaFirefox

Language Support

MozillaFirefox will only return the English US installer by default. This has been done due to the lengthy amount of time that the function takes to query the Mozilla site to find the installers for each channel, architecture and file type. This could be up to 12 objects for each language - if the supported languages are included by default, then the function will take several minutes to return an object.

Any supported language can be passed to MozillaFirefox by passing a hashtable to -AppParams. For example: Get-EvergreenApp -Name "MozillaFirefox" -AppParams @{Language="en-GB", "es-ES"} will return the English (UK) and Spanish language installers for Firefox.

Most supported languages can be passed to the function as the language short code. The list of languages can be found in the MozillaFirefox manifest.

Errors and Warnings

MozillaFirefox will warnings and an error similar to the following which is normal - not all channels or installer types may return an object from the Mozilla site that is used to find an installer download URL. In the example below, a call is being made for the ARM64, MSI version of the Extended Support Release which doesn't exist.

WARNING: Resolve-SystemNetWebRequest: Error at URI: https://download.mozilla.org/?product=firefox-esr-msi-latest-ssl&os=win64-aarch64&lang=en-US.
WARNING: Resolve-SystemNetWebRequest: Response: Exception calling "GetResponse" with "0" argument(s): "The remote server returned an error: (404) Not Found.".
WARNING: Resolve-SystemNetWebRequest: For troubleshooting steps see: https://stealthpuppy.com/evergreen/troubleshoot/.
Write-Error: /Users/aaron/projects/evergreen/Evergreen/Apps/Get-MozillaFirefox.ps1:38
Line |
  38 |                      $response = Resolve-SystemNetWebRequest @params
     |                                  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     | Resolve-SystemNetWebRequest: Exception calling "GetResponse" with "0" argument(s): "The remote server returned an error: (404) Not Found.".

You can suppress this output with the following syntax:

Get-EvergreenApp -Name "MozillaFirefox" -ErrorAction "SilentlyContinue" -WarningAction "SilentlyContinue"

OBSStudio

Returning the latest version and download for OBS Studio may fail when the OBS Project modifies the availability of the update manifest at https://obsproject.com/update_studio/manifest.json. Get-EvergreenApp -Name OBSStudio will return a 404 error. The only recourse is to wait until the OBS Project makes the manifest available again.

Evergreen could query versions from the GitHub repository; however, the the OBS Project does not consistently maintain releases in the repository. In some instances a specific release of OBS Studio may address an issue with the macOS version only and OBSStudio would then return no results.

Also see Get-EvergreenApp OBSStudio not working due to a 404 errors.

PaintDotNet

Get-EvergreenApp -Name PaintDotNet produces the following error under PowerShell on Linux. As a workaround, use Get-EvergreenApp -Name PaintDotNetOfflineInstaller instead.

WARNING: Invoke-WebRequestWrapper: Error at URI: https://www.getpaint.net/updates/versions.8.1000.0.x64.en.txt.
WARNING: Invoke-WebRequestWrapper: Error encountered: The SSL connection could not be established, see inner exception..
WARNING: Invoke-WebRequestWrapper: For troubleshooting steps see: https://stealthpuppy.com/evergreen/troubleshoot/.
Write-Error: /home/aaron/.local/share/powershell/Modules/Evergreen/2205.561/Apps/Get-PaintDotNet.ps1:20
Line |
  20 |      $Content = Invoke-WebRequestWrapper -Uri $res.Get.Uri
     |                 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     | Invoke-WebRequestWrapper: The SSL connection could not be established, see inner exception.

VideoLanVlcPlayer

VideoLanVlcPlayer may not always return the latest available release - the release returned by the update feed used by the VLC media player may not be the same as the current version available for download from the videolan.org site, due to the version returned in the update feed.

The source code for the update site can be found here: VideoLAN organization > update.videolan.org > Repository.

VMwareHorizonClient

VMwareHorizonClient may not always return the current release - the major version property in the VMware Horizon Client software update data does not use easily sortable versioning. This may be fixed in a future release. Also see VMware Horizon Client reporting out of date version.

Note

VMwareHorizonClient returns the Horizon Client in .tar format. This the same URL used when the Horizon Client updates itself - you will need to unpack the .tar file to retrieve the executable installer.

Zoom

Zoom returns versions as Latest for some downloads - the source used by this function does not provide a method for determining the version number. Also see Zoom currently failing