Remove-OVStorageVolume
Syntax
Remove-OVStorageVolume
[-InputObject] <Object>
[-ExportOnly]
[-Async]
[-ApplianceConnection] <Object>
[<CommonParameters>]
Description
This Cmdlet will remove storage volumes from the HPE OneView appliance. Volumes must first be removed from attached Server Profiles prior to deleting the Storage Volume.
Examples
Example 1
$VolumeToRemove = Get-OVStorageVolume -Name TestVol1 -ErrorAction Stop
Remove-OVStorageVolume -InputObject $VolumeToRemove
Remove export and delete volume named "TestVol1".
Example 2
Remove export of volume named "TestVol1" only, which leaves the volume still provisioned on the array and is added back to the HPE OneView Storage Volumes pool.
Parameters
-InputObject <Object>
Storage Volume Name, URI or Object.
| Aliases | uri, name, StorageVolume |
|---|---|
| Required? | True |
| Position? | Named |
| Default value | |
| Accept pipeline input? | true (ByValue) |
| Accept wildcard characters? | False |
-ExportOnly <SwitchParameter>
Removes the volume from HPE OneView. The volume remains on the storage system, and must be managed manually until it is added back under management of HPE OneView. Default: Delete Export AND Volume from storage system.
| Aliases | None |
|---|---|
| Required? | False |
| Position? | Named |
| Default value | False |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
-Async <SwitchParameter>
Use this parameter to immediately return the async task. By default, the Cmdlet will wait for the task to complete.
| Aliases | None |
|---|---|
| Required? | False |
| Position? | Named |
| Default value | false |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
-ApplianceConnection <Object>
Specify one [HPEOneView.Appliance.Connection] object or Name property value. If Resource object is provided via Pipeline, the ApplianceConnection property of the object will be used.
| Aliases | Appliance |
|---|---|
| Required? | True |
| Position? | Named |
| Default value | (${Global:ConnectedSessions} | ? Default) |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? | False |
-WhatIf <SwitchParameter>
| Aliases | wi |
|---|---|
| Required? | False |
| Position? | Named |
| Default value | |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
-Confirm <SwitchParameter>
| Aliases | cf |
|---|---|
| Required? | False |
| Position? | Named |
| Default value | |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Input Types
Storage Volume resource object
Return Values
Async removal task
Related Links
- Add-OVStorageVolume
- ConvertTo-OVStorageVolume
- Get-OVStorageVolume
- Get-OVStorageVolumeSet
- Get-OVStorageVolumeSnapShot
- Get-OVStorageVolumeTemplate
- Get-OVStorageVolumeTemplatePolicy
- New-OVStorageVolume
- New-OVStorageVolumeSnapshot
- New-OVStorageVolumeTemplate
- Remove-OVStorageVolumeSnapshot
- Remove-OVStorageVolumeTemplate
- Set-OVStorageVolume
- Set-OVStorageVolumeTemplate
- Set-OVStorageVolumeTemplatePolicy