Repository navigation
Prerequisites
SPSWeather runs from a single host (a SharePoint server, or a dedicated orchestration / PULL server) and reaches every farm over a CredSSP PSSession.
- Windows with PowerShell 5.1 (or PowerShell 7+).
- Local administrator: SPSWeather must run elevated. The entry script enforces this and stops otherwise. It is required to write the scheduled task, the event-log source, and the CredSSP client configuration.
- The
SPSWeather.Commonmodule shipped insrc\Modules\(no external module needed; the former CredentialManager dependency was dropped in 3.0.0).
SPSWeather uses CredSSP to perform the double hop (the health-check host → each farm server → SQL). CredSSP has two sides:
| Side | Where | Managed by |
|---|---|---|
| Client | the host that runs SPSWeather |
SPSWeather (-Action Install) |
| Server | each SharePoint farm server | your DSC on the farms |
Running -Action Install calls Set-SPSCredSSPClient, which:
- enables CredSSP client authentication (WSMan), and
- allows fresh-credentials delegation to the precise farm FQDNs derived from
Farms[].Server+Domainin your config (e.g.WSMAN/app1.contoso.com).
It is idempotent and supports -WhatIf. When those settings are controlled by a
Group Policy it warns and leaves the GPO in charge instead of fighting it.
Re-run
-Action Installafter adding a farm so the new server FQDN is delegated.-Action Uninstallleaves the CredSSP client configuration in place (other tools on the host may rely on it).
This is why SPSWeather can run from a host that is not a SharePoint server: it no longer depends on a DSC resource to configure the client side.
Each SharePoint farm server must have the CredSSP server role enabled
(Enable-WSManCredSSP -Role Server). This is part of the farm's own configuration and
stays owned by your DSC — SPSWeather does not change it.
CredSSP is convenient but delegates the caller's credentials to the target. A future, more secure option for the double hop is Kerberos resource-based constrained delegation (RBCD), which does not delegate the password and is scoped per target. It is tracked as a backlog item; CredSSP remains the supported path today.