Home

SPSWeather Wiki

SPSWeather is a PowerShell tool that produces a health-check report of a SharePoint Server farm and emails it to administrators. It is compatible with SharePoint Server Subscription Edition.

SharePoint Server 2016 and 2019 reached end of support on 14 July 2026. Customers still running SharePoint Server 2016 or 2019 must stay on SPSWeather v2.3.7.

SPSWeather connects to each farm server over CredSSP remoting, collects SharePoint, Search, system/IIS and SQL signals, renders a single HTML report optimized for email, and raises an ALERT when something needs attention.

Key features

• Configurable farm health checks (SharePoint, Search, IIS, system, SQL)
• HTML report optimized for email, delivered over SMTP
• Configuration as a PowerShell data file (config.psd1)
• Service credential stored as a DPAPI-encrypted secrets.psd1 — no third-party module
• Windows Event Log instrumentation (dedicated SPSWeather log)
• Self-contained SPSWeather.Common PowerShell module (manifest-driven version)

Architecture overview

        SPSWeather.ps1  (entry point, scheduled task)
               │  imports
               ▼
        SPSWeather.Common  (PowerShell module: Public/ + Private/)
               │  CredSSP remoting (Invoke-Command / New-PSSession)
               ▼
   Each SharePoint farm server  ──►  HTML report  ──►  SMTP mailbox

The credential used for remoting is read from Config\secrets.psd1 (DPAPI), and every run writes lifecycle entries to the SPSWeather Windows Event Log.

Pages

• Getting Started — prerequisites, installation, first run
• Configuration — config.psd1 and secrets.psd1 explained
• Usage — parameters, scheduling, output and the event log
• Health Checks — every check, what it reports, and how an ALERT is raised
• Release Process — for maintainers: how to ship a new version

Project links

• Source repository
• Latest release
• Issues
• Changelog