Get-S2DCacheTierInfo¶

Analyzes the S2D cache tier configuration, binding ratio, and health.

Synopsis¶

Classifies cache vs capacity disks, computes the cache-to-capacity binding ratio, and surfaces degradation or missing cache disk conditions.

Handles all-NVMe clusters (software write-back cache) and hybrid configurations (NVMe/SSD cache over HDD/SSD capacity tier).

Requires an active session from Connect-S2DCluster, or use -CimSession directly.

Get-S2DCacheTierInfo
    [-CimSession <CimSession>]

Override the module session and target this CimSession directly.

S2DCacheTier — a single object describing the cache configuration.

Key properties:

Property	Description
`CacheMode`	`WriteBack`, `WriteThrough`, or `Disabled`
`IsAllFlash`	`$true` when all pool disks are NVMe or SSD
`CacheDiskCount`	Number of cache-tier disks in the cluster
`CapacityDiskCount`	Number of capacity-tier disks in the cluster
`CacheToCapacityRatio`	Cache disk count / capacity disk count (e.g. `1:4`)
`CacheDiskMediaType`	Media type of cache disks (`NVMe`, `SSD`)
`CapacityDiskMediaType`	Media type of capacity disks (`NVMe`, `SSD`, `HDD`)
`HealthStatus`	`Healthy`, `Degraded`, `Unhealthy`
`DegradedNodes`	Nodes with a missing or failed cache disk

Basic cache info:

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

Key cache metrics:

Get-S2DCacheTierInfo | Select-Object CacheMode, IsAllFlash, CacheDiskCount, CacheToCapacityRatio

Check for degraded cache:

$cache = Get-S2DCacheTierInfo
if ($cache.HealthStatus -ne 'Healthy') {
    "Cache degraded on: $($cache.DegradedNodes -join ', ')"
}