< Back
Remove-AzureStorSimpleDeviceVolume
Post
NAME Remove-AzureStorSimpleDeviceVolume
SYNOPSIS
Removes a volume from a StorSimple device.
SYNTAX
Remove-AzureStorSimpleDeviceVolume [-DeviceName] <String> [-VolumeName] <String> [[-WaitForComplete]] [[-Force]] [-Profile
<Microsoft.Azure.Common.Authentication.Models.AzureProfile>] [<CommonParameters>]
Remove-AzureStorSimpleDeviceVolume [-DeviceName] <String> [-Volume] <VirtualDisk> [[-WaitForComplete]] [[-Force]] [-Profile
<Microsoft.Azure.Common.Authentication.Models.AzureProfile>] [<CommonParameters>]
DESCRIPTION
The Remove-AzureStorSimpleDeviceVolume cmdlet removes a volume from a StorSimple device. This cmdlet prompts you for confirmation unless you specify the
Force parameter.
PARAMETERS
-DeviceName <String>
Specifies the name of the StorSimple device on which to the volume to remove exists.
Required? true
Position? 1
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Force [<SwitchParameter>]
Indicates that this cmdlet does not prompt you for confirmation.
Required? false
Position? 4
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Profile [<Microsoft.Azure.Common.Authentication.Models.AzureProfile>]
Specifies an Azure profile.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Volume <VirtualDisk>
Specifies the volume to remove, as a VirtualDisk object. To obtain a VirtualDisk object, use the Get-AzureStorSimpleDeviceVolume cmdlet.
Required? true
Position? 2
Default value none
Accept pipeline input? true(ByValue)
Accept wildcard characters? false
-VolumeName <String>
Specifies the name of the volume to remove.
Required? true
Position? 2
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-WaitForComplete [<SwitchParameter>]
Indicates that this cmdlet waits for the operation to complete before it returns control to the Windows PowerShell????????? console.
Required? false
Position? 3
Default value none
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 (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
VirtualDisk
This cmdlet accepts either the VirtualDisk object to delete or the volume name of the VirtualDisk to delete.
OUTPUTS
TaskStatusInfo
This cmdlet returns a TaskStatusInfo object, if you specify the WaitForComplete parameter.
NOTES
Keywords: azure, azuresm, servicemanagement, management, service, store, storsimple
Example 1: Remove a volume by using the pipeline
PS C:\\>Get-AzureStorSimpleDeviceVolume -DeviceName "Contoso63-AppVm" -VolumeName "Volume18" | Remove-AzureStorSimpleDeviceVolume -DeviceName
"Contoso63-AppVm"
VERBOSE: ClientRequestId: 2933e24d-9564-42b5-9053-5f0bc4f59ea8_PS
VERBOSE: ClientRequestId: 7c2d854b-537a-4253-bb0c-c15bc8aa2b49_PS
VERBOSE: ClientRequestId: 4bf749ac-517c-49e7-8027-a8f62e272014_PS
VERBOSE: ClientRequestId: 7d9ec87a-616d-4ca9-bfb8-158859174d59_PS
Confirm
Are you sure you want to remove the volume?
[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): Y
VERBOSE: ClientRequestId: 67a38e28-a015-44b1-8159-c1a6604f4d81_PS
VERBOSE: About to run a job to remove your volume!
VERBOSE: ClientRequestId: 56101c10-07ca-40f4-8f19-c6fdd895e3a5_PS
32925451-4451-4478-89f7-d8930505d3fb
VERBOSE: The delete task is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId
32925451-4451-4478-89f7-d8930505d3fb for tracking the task's status
VERBOSE: Volume with name: Volume18 is found.
This command gets the volume named Volume18 on the device named Contoso63-AppVm, and then passes that volume to the current cmdlet by using the pipeline
operator. The current cmdlet starts the task that removes the volume, and then returns a TaskResponse object. To see the status of the task, use the
Get-AzureStorSimpleTask cmdlet. The command does not specify the Force parameter, so the cmdlet prompts you for confirmation.
Example 2: Remove a volume without confirmation
PS C:\\>Remove-AzureStorSimpleDeviceVolume -DeviceName "Contoso63-AppVm" -VolumeName "Volume18" -Force
VERBOSE: ClientRequestId: 72f13290-41eb-4ac4-9535-da1a42d0fa0b_PS
VERBOSE: ClientRequestId: ae0c1d99-1a66-4a69-9260-f2c8c12546bd_PS
VERBOSE: ClientRequestId: 9610744f-d031-488f-87e6-3ecddb305e13_PS
VERBOSE: About to run a job to remove your volume!
VERBOSE: ClientRequestId: d33525d8-7276-4d2a-942d-d10f8078f1f7_PS
483f8cb4-ebc3-46a9-a9e6-0989e25738a0
VERBOSE: The delete task is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId
483f8cb4-ebc3-46a9-a9e6-0989e25738a0 for tracking the task's status
This command removes the volume named Volume18 from the device named Contoso63-AppVm. The command specifies the Force parameter, so the cmdlet does not
prompt you for confirmation.
RELATED LINKS
Get-AzureStorSimpleDeviceVolumeContainer
New-AzureStorSimpleDeviceVolume
Set-AzureStorSimpleDeviceVolume
Get-AzureStorSimpleJob
SYNOPSIS
Removes a volume from a StorSimple device.
SYNTAX
Remove-AzureStorSimpleDeviceVolume [-DeviceName] <String> [-VolumeName] <String> [[-WaitForComplete]] [[-Force]] [-Profile
<Microsoft.Azure.Common.Authentication.Models.AzureProfile>] [<CommonParameters>]
Remove-AzureStorSimpleDeviceVolume [-DeviceName] <String> [-Volume] <VirtualDisk> [[-WaitForComplete]] [[-Force]] [-Profile
<Microsoft.Azure.Common.Authentication.Models.AzureProfile>] [<CommonParameters>]
DESCRIPTION
The Remove-AzureStorSimpleDeviceVolume cmdlet removes a volume from a StorSimple device. This cmdlet prompts you for confirmation unless you specify the
Force parameter.
PARAMETERS
-DeviceName <String>
Specifies the name of the StorSimple device on which to the volume to remove exists.
Required? true
Position? 1
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Force [<SwitchParameter>]
Indicates that this cmdlet does not prompt you for confirmation.
Required? false
Position? 4
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Profile [<Microsoft.Azure.Common.Authentication.Models.AzureProfile>]
Specifies an Azure profile.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Volume <VirtualDisk>
Specifies the volume to remove, as a VirtualDisk object. To obtain a VirtualDisk object, use the Get-AzureStorSimpleDeviceVolume cmdlet.
Required? true
Position? 2
Default value none
Accept pipeline input? true(ByValue)
Accept wildcard characters? false
-VolumeName <String>
Specifies the name of the volume to remove.
Required? true
Position? 2
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-WaitForComplete [<SwitchParameter>]
Indicates that this cmdlet waits for the operation to complete before it returns control to the Windows PowerShell????????? console.
Required? false
Position? 3
Default value none
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 (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
VirtualDisk
This cmdlet accepts either the VirtualDisk object to delete or the volume name of the VirtualDisk to delete.
OUTPUTS
TaskStatusInfo
This cmdlet returns a TaskStatusInfo object, if you specify the WaitForComplete parameter.
NOTES
Keywords: azure, azuresm, servicemanagement, management, service, store, storsimple
Example 1: Remove a volume by using the pipeline
PS C:\\>Get-AzureStorSimpleDeviceVolume -DeviceName "Contoso63-AppVm" -VolumeName "Volume18" | Remove-AzureStorSimpleDeviceVolume -DeviceName
"Contoso63-AppVm"
VERBOSE: ClientRequestId: 2933e24d-9564-42b5-9053-5f0bc4f59ea8_PS
VERBOSE: ClientRequestId: 7c2d854b-537a-4253-bb0c-c15bc8aa2b49_PS
VERBOSE: ClientRequestId: 4bf749ac-517c-49e7-8027-a8f62e272014_PS
VERBOSE: ClientRequestId: 7d9ec87a-616d-4ca9-bfb8-158859174d59_PS
Confirm
Are you sure you want to remove the volume?
[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): Y
VERBOSE: ClientRequestId: 67a38e28-a015-44b1-8159-c1a6604f4d81_PS
VERBOSE: About to run a job to remove your volume!
VERBOSE: ClientRequestId: 56101c10-07ca-40f4-8f19-c6fdd895e3a5_PS
32925451-4451-4478-89f7-d8930505d3fb
VERBOSE: The delete task is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId
32925451-4451-4478-89f7-d8930505d3fb for tracking the task's status
VERBOSE: Volume with name: Volume18 is found.
This command gets the volume named Volume18 on the device named Contoso63-AppVm, and then passes that volume to the current cmdlet by using the pipeline
operator. The current cmdlet starts the task that removes the volume, and then returns a TaskResponse object. To see the status of the task, use the
Get-AzureStorSimpleTask cmdlet. The command does not specify the Force parameter, so the cmdlet prompts you for confirmation.
Example 2: Remove a volume without confirmation
PS C:\\>Remove-AzureStorSimpleDeviceVolume -DeviceName "Contoso63-AppVm" -VolumeName "Volume18" -Force
VERBOSE: ClientRequestId: 72f13290-41eb-4ac4-9535-da1a42d0fa0b_PS
VERBOSE: ClientRequestId: ae0c1d99-1a66-4a69-9260-f2c8c12546bd_PS
VERBOSE: ClientRequestId: 9610744f-d031-488f-87e6-3ecddb305e13_PS
VERBOSE: About to run a job to remove your volume!
VERBOSE: ClientRequestId: d33525d8-7276-4d2a-942d-d10f8078f1f7_PS
483f8cb4-ebc3-46a9-a9e6-0989e25738a0
VERBOSE: The delete task is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId
483f8cb4-ebc3-46a9-a9e6-0989e25738a0 for tracking the task's status
This command removes the volume named Volume18 from the device named Contoso63-AppVm. The command specifies the Force parameter, so the cmdlet does not
prompt you for confirmation.
RELATED LINKS
Get-AzureStorSimpleDeviceVolumeContainer
New-AzureStorSimpleDeviceVolume
Set-AzureStorSimpleDeviceVolume
Get-AzureStorSimpleJob