Remove-DPMDiskStorage
Removes disk-based storage from the storage pool on a DPM server. Please note that the commandlet will also remove the volumes that may have datasources being backed up to it. Please ensure that you are not actively backing up data before removing the volumes.
Syntax
DPMDisk
Remove-DPMDiskStorage
[-DPMDisk] <Disk[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Volumes
Remove-DPMDiskStorage
[-Volume] <Volume[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The Remove-DPMDiskStorage cmdlet removes given disk or volume from the storage pool of a given System Center - Data Protection Manager (DPM) server. A storage pool on a DPM server consists of a set of disks where the server stores replicas, shadow copies, and transfer logs for protected data sources and a set of ReFS volumes where the server stores replica VHDs.
To get a list of all disks in the DPM storage pool, use the Get-DPMDiskStorage cmdlet. To get a list of all volumes in the DPM storage pool, use the Get-DPMDiskStorage cmdlet with the Volume switch.
Examples
Example 1: Remove a disk from a storage pool
PS C:\>$disks = Get-DPMDiskStorage -DPMServerName "TestingServer"
PS C:\> Remove-DPMDiskStorage -DPMDisk $disks[0]
First command uses the Get-DPMDiskStorage cmdlet to get the disks that are locally attached to the DPM server named TestingServer. It stores them in the $disks variable.
Second command removes first disk listed in $disks from the DPM storage pool, assuming that this disk was already added to the storage pool.
Example 2: Remove a volume from a storage pool
PS C:\>$volumes = Get-DPMDiskStorage -DPMServerName "TestingServer" -Volumes
PS C:\> Remove-DPMDiskStorage -Volume $volumes
First command uses the Get-DPMDiskStorage cmdlet to get the volumes already added to storage pool of the DPM server named TestingServer. It stores them in the $volumes variable.
The second command removes these volumes from the DPM storage pool.
Parameters
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-DPMDisk
Specifies an array of disks that this cmdlet removes from the storage pool.
Parameter properties
| Type: | Disk[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
DPMDisk
| Position: | 1 |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Volume
Specifies an array of volumes that this cmdlet removes from disk storage pool.
Parameter properties
| Type: | Volume[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Volumes
| Position: | 1 |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.