Cmdlets

Choose a cmdlet from the list on the left or search for a specific cmdlet. Choose a cmdlet from the list or search for a specific cmdlet.
About Help  Providers
 

Remove-ClusterSharedVolume

Remove-ClusterSharedVolume

microsoft.failoverclusters.powershell.dll

Synopsis

Removes a volume from the Cluster Shared Volumes in a failover cluster, and places it in Available Storage in the cluster.

Syntax

Remove-ClusterSharedVolume [-Name] [-Cluster] [-InputObject] [-Confirm] [-WhatIf] [<CommonParameters>]

Detailed Description

The Remove-ClusterSharedVolume cmdlet removes a volume from the Cluster Shared Volumes in a failover cluster, and places it in Available Storage in the cluster. After placing a volume in Available Storage, you can use the volume when you configure a new clustered role.

Parameters

-Cluster <String>

Specifies the name of the cluster on which to run this cmdlet. If the input for this parameter is . or it is omitted, then the cmdlet runs on the local cluster.

Aliases

None

Required?

false

Position

named

Default value

Accept pipeline input?

false

Accept wildcard characters?

false

-InputObject <PSObject>

Specifies the Cluster Shared Volume to remove.

Aliases

None

Required?

false

Position

named

Default value

Accept pipeline input?

true (ByValue)

Accept wildcard characters?

false

-Name <StringCollection>

Specifies the name of the Cluster Shared Volume to remove.

Aliases

None

Required?

false

Position

1

Default value

Accept pipeline input?

false

Accept wildcard characters?

false

-Confirm <SwitchParameter>

Prompts you for confirmation before running the cmdlet.

Aliases

None

Required?

false

Position

named

Default value

false

Accept pipeline input?

false

Accept wildcard characters?

false

-WhatIf <SwitchParameter>

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Aliases

None

Required?

false

Position

named

Default value

false

Accept pipeline input?

false

Accept wildcard characters?

false

Input Type

Microsoft.FailoverClusters.PowerShell.ClusterSharedVolume

Return Type

Microsoft.FailoverClusters.PowerShell.ClusterResource

Notes

None

Examples

Example 1

This example removes the CSV named Cluster Disk 3 from the Cluster Shared Volumes on the local cluster, and places it in Available Storage.

PS C:\>Remove-ClusterSharedVolume –Name "Cluster Disk 3"
Name                State               Group               ResourceType 
----                -----               -----               ------------ 
Cluster Disk 3      Online              Available Storage   Physical Disk 

Example 2

This example removes the CSV named Cluster Disk 4 from the Cluster Shared Volumes on the local cluster, and places it in Available Storage.

PS C:\>Get-ClusterSharedVolume –Name "Cluster Disk 4" | Remove-ClusterSharedVolume
Name                State               Group               ResourceType 
----                -----               -----               ------------ 
Cluster Disk 4      Online              Available Storage   Physical Disk 

Online Version
Add-ClusterSharedVolume
Get-ClusterSharedVolume
Move-ClusterSharedVolume