Remove-ClusterSharedVolume
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] <StringCollection>]
[-InputObject <PSObject>]
[-Cluster <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
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.
Examples
Example 1
PS C:\> Remove-ClusterSharedVolume -Name "Cluster Disk 3"
Name State Group ResourceType
---- ----- ----- ------------
Cluster Disk 3 Online Available Storage Physical Disk
This example removes the CSV named Cluster Disk 3 from the Cluster Shared Volumes on the local cluster, and places it in Available Storage.
Example 2
PS C:\> Get-ClusterSharedVolume -Name "Cluster Disk 4" | Remove-ClusterSharedVolume
Name State Group ResourceType
---- ----- ----- ------------
Cluster Disk 4 Online Available Storage Physical Disk
This example removes the CSV named Cluster Disk 4 from the Cluster Shared Volumes on the local cluster, and places it in Available Storage.
Parameters
-Cluster
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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Specifies the Cluster Shared Volume to remove.
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Specifies the name of the Cluster Shared Volume to remove.
Type: | StringCollection |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
Microsoft.FailoverClusters.PowerShell.ClusterSharedVolume
Outputs
Microsoft.FailoverClusters.PowerShell.ClusterResource