Get-S2DHealthStatus

Runs all S2D health checks and returns pass/warn/fail results with severity.

---

Synopsis

Executes 11 health checks covering reserve adequacy, disk symmetry, volume health, disk health, NVMe wear, thin overcommit, firmware consistency, rebuild capacity, infrastructure volume presence, cache tier health, and thin provisioning reserve risk.

Uses already-collected data from the session cache where available. Run the collector cmdlets first for best results, or they will be invoked automatically.

Requires an active session from Connect-S2DCluster.

---

Syntax

Get-S2DHealthStatus
    [-CheckName <string[]>]

---

Parameters

-CheckName

Type	string[]
Required	No
Default	all checks

Limit execution to one or more specific check names. See the table below for valid names.

---

Health Checks

Check Name	Severity	What it tests
ReserveAdequacy	Critical	Rebuild reserve ≥ one drive per node (up to 4 nodes)
DiskSymmetry	Warning	All nodes have identical disk count and media types
VolumeHealth	Critical	No volumes in Warning or Unhealthy state
DiskHealth	Critical	No pool-member disks in Warning or Unhealthy state
NVMeWear	Warning (>75%), Critical (>90%)	NVMe/SSD drive wear percentage
ThinOvercommit	Warning (>80%), Critical (>100%)	Thin-provisioned logical size vs pool total
FirmwareConsistency	Warning	All disks of the same model run the same firmware version
RebuildCapacity	Critical	Largest per-node disk total ≤ pool free space (enough room to rebuild if a node fails)
InfraVolumePresent	Warning	Expected Azure Local infrastructure volumes are present
CacheTierHealth	Critical	Cache tier is healthy with no missing or failed cache disks
ThinReserveRisk	Warning	Uncommitted thin growth headroom vs rebuild reserve

---

Outputs

S2DHealthCheck[] — one object per check.

Properties per check:

Property	Description
CheckName	Name of the health check
Severity	Warning or Critical (maximum severity if the check fails)
Status	Pass, Warn, or Fail
Details	Human-readable description of the result
Remediation	Recommended action when status is not Pass

---

Examples

Run all checks:

Connect-S2DCluster -ClusterName "tplabs-clus01" -Credential $cred
Get-S2DHealthStatus

Show only non-passing checks:

Get-S2DHealthStatus | Where-Object Status -ne 'Pass' | Format-List

Run a single check:

Get-S2DHealthStatus -CheckName RebuildCapacity

Run a subset of checks:

Get-S2DHealthStatus -CheckName DiskHealth, NVMeWear, ThinOvercommit

Check overall health in a script:

$checks = Get-S2DHealthStatus
$critical = $checks | Where-Object { $_.Status -eq 'Fail' -and $_.Severity -eq 'Critical' }
if ($critical) {
    Write-Error "CRITICAL health issues: $($critical.CheckName -join ', ')"
}