Remove-Volume

SYNOPSIS

Removes one or more volumes from the PowerMax array.

SYNTAX

Remove-Volume [-Unisphere] <UnisphereServer> [-ArrayId] <String> [-Id] <String[]> [-Confirm] [-Force] [-PassThru] [-WhatIf] [<CommonParameters>]

DESCRIPTION

Removes one or more volumes using a list of volume IDs or a range (e.g. 00010-0001F) of volume IDs.

EXAMPLES

Example 1

PS C:\> Remove-Volume -Unisphere $unisphere -ArrayId 000123456789 -Id 00010

Where $unisphere is a Unisphere server instance. Removes the volume with ID 00010.

Example 2

PS C:\> Remove-Volume -Unisphere $unisphere -ArrayId 000123456789 -Id '0001D',0002E

Where $unisphere is a Unisphere server instance. Removes the volumes with IDs 0001D and 0002E (Use quotes for IDs with ‘D’ when used in an array).

Example 3

PS C:\> Remove-Volume -Unisphere $unisphere -ArrayId 000123456789 -Id 00023,000F0-000FF

Where $unisphere is a Unisphere server instance. Removes the volume with ID 00023 and volumes in the range 000F0-000FF.

PARAMETERS

-Unisphere

The Unisphere server object.

Type: UnisphereServer
Parameter Sets: (All)
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-ArrayId

The PowerMax array ID.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-Id

The volume ID. Use quotes for IDs with ‘D’ when used in an array.

Type: String[]
Parameter Sets: (All)
Aliases:

Required: True
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Force

Skips confirmation before removing the volumes.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PassThru

Returns the list of objects that were actually removed.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

Dell.PowerMax.Management.Model.UnisphereServer

System.String

System.String[]

OUTPUTS

Dell.PowerMax.Management.Model.Volume

NOTES

If a range of volume IDs is given and some volumes are not present on the PowerMax array then multiple REST API DELETE requests are made to the Unisphere server instead of a single REST API call with the range of IDs. The entire volume removal operation could take a longer time to complete.

RELATED LINKS