Get-S2DVolumeMap¶

Maps all S2D volumes with resiliency type, capacity footprint, and provisioning detail.

Synopsis¶

Queries VirtualDisk and ClusterSharedVolume. Returns per-volume resiliency efficiency, footprint on pool, provisioning type, overcommit ratio for thin volumes, and thin growth headroom. Auto-detects Azure Local infrastructure volumes by name and size pattern.

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

Syntax¶

Get-S2DVolumeMap
    [-VolumeName <string[]>]
    [-CimSession <CimSession>]

Parameters¶

`-VolumeName`¶


Type	`string[]`
Required	No
Default	all volumes

Limit results to one or more specific volume friendly names.

`-CimSession`¶


Type	`CimSession`
Required	No
Default	uses module session

Override the module session and target this CimSession directly.

Outputs¶

S2DVolume[] — one object per volume.

Key properties:

Property	Description
`FriendlyName`	Volume name
`ResiliencySettingName`	`Mirror` or `Parity`
`NumberOfDataCopies`	Resiliency factor (2 = 2-way mirror, 3 = 3-way mirror)
`ProvisioningType`	`Thin` or `Fixed`
`Size`	Logical size as `S2DCapacity`
`FootprintOnPool`	Physical space consumed on the pool as `S2DCapacity`
`EfficiencyPercent`	Logical size / footprint × 100
`AllocatedSize`	Actually written data (thin volumes) as `S2DCapacity`
`ThinGrowthHeadroom`	Remaining thin headroom before pool is full as `S2DCapacity`
`MaxPotentialFootprint`	Maximum pool space this thin volume could ever consume as `S2DCapacity`
`OvercommitRatio`	`MaxPotentialFootprint / pool.TotalSize`
`HealthStatus`	`Healthy`, `Warning`, `Unhealthy`
`OperationalStatus`	WMI operational status
`IsInfrastructureVolume`	`$true` for Azure Local system volumes (UserStorage, SBEAgent, etc.)
`CSVPath`	Cluster Shared Volume mount path

Examples¶

All volumes:

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

Capacity summary:

Get-S2DVolumeMap | Format-Table FriendlyName, ResiliencySettingName, ProvisioningType, Size, FootprintOnPool, EfficiencyPercent

Thin volume risk assessment:

Get-S2DVolumeMap |
    Where-Object ProvisioningType -eq 'Thin' |
    Select-Object FriendlyName, Size, AllocatedSize, ThinGrowthHeadroom, MaxPotentialFootprint, OvercommitRatio

Filter to specific volumes:

Get-S2DVolumeMap -VolumeName "UserStorage_1", "UserStorage_2"

Show only user (non-infrastructure) volumes:

Get-S2DVolumeMap | Where-Object IsInfrastructureVolume -eq $false