SnapCenter PowerShell Commands
Remove-SdVolume
Suggest changes
PDFs
Removes a volume from your storage system.
Syntax
Remove-SdVolume [-Volume] <String> [-StorageSystem] <String> [-Session] <String> [-Host] <String>
Detailed Description
Removes a volume from your storage system. When you remove a volume using this cmdlet, Remove-SdVolume dismounts your volume, brings it offline, and deletes it. You can remove one volume at a time, only.You cannot remove volumes that are in a SnapMirror relationship. When you remove volumes, any active LUNs or shares on the volume are also removed. This cmdlet is supported in clustered Data ONTAP 8.2 and later.Related cmdlets: New-SdVolume
Parameters
| Name | Description | Required? | Pipeline Input | Default Value |
|---|---|---|---|---|
Volume |
Specifies the name of the volume you want to delete. |
true |
true (ByValue, ByPropertyName) |
|
StorageSystem |
Specifies the name of the storage system from which you want to delete the volume. You can use the administration interface or the storage system name. |
true |
true (ByValue, ByPropertyName) |
|
Session |
false |
true (ByPropertyName) |
||
Host |
Specifies the name or IP address of the host on which you execute the operation. The default is your local machine. |
false |
true (ByPropertyName) |
Examples
Example 1: Removing a volume
PS C:\> Remove-SdVolume -Volume TestRemoval01 -StorageSystem 172.17.165.39 -Verbose
This example syntax removes volume TestRemoval01 from storage system 172.17.165.39.
VERBOSE: volume 'TestRemoval01' will be removed Remove-SdVolume volume 'TestRemoval01' will be removed Do you want to continue? [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): y VERBOSE: Removing volume: TestRemoval01 VERBOSE: Operation Successful.