Get-DbaWsfcAvailableDisk

Want to see the source code for this command? Check out Get-DbaWsfcAvailableDisk on GitHub.
Want to see the Bill Of Health for this command? Check out Get-DbaWsfcAvailableDisk.

Synopsis

Retrieves shared storage disks available for clustering but not yet assigned to a Windows Server Failover Cluster.

Description

Identifies shared storage disks that are visible to all cluster nodes and eligible for clustering, but have not yet been added to the cluster's storage pool. This is essential when planning to expand SQL Server Failover Cluster Instances (FCIs) or troubleshooting storage connectivity issues. The function queries each cluster node to ensure disks are properly accessible across the entire cluster before attempting to add them as cluster resources.

All Windows Server Failover Clustering (Wsfc) commands require local admin on each member node.

Syntax

Get-DbaWsfcAvailableDisk
    [[-ComputerName] <DbaInstanceParameter[]>]
    [[-Credential] <PSCredential>]
    [-EnableException]
    [<CommonParameters>]

Examples

Example: 1

PS C:\> Get-DbaWsfcAvailableDisk -ComputerName cluster01

Gets available disks from the failover cluster cluster01

Optional Parameters

-ComputerName

Specifies the Windows Server Failover Cluster name or any cluster node name to query for available disks.
Use this when you need to check shared storage from a specific cluster, especially when managing multiple clusters or troubleshooting storage visibility across cluster nodes.
Accepts multiple values to query several clusters simultaneously.

-Credential

Allows you to login to the cluster using alternative credentials.

-EnableException

By default, when something goes wrong we try to catch it, interpret it and give you a friendly warning message.
This avoids overwhelming you with "sea of red" exceptions, but is inconvenient because it basically disables advanced scripting.
Using this switch turns this "nice by default" feature off and enables you to catch exceptions with your own try/catch.