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

Remove-DPMDiskStorage
      [-DPMDisk] <Disk[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
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 2019 - 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DPMDisk

Specifies an array of disks that this cmdlet removes from the storage pool.

Type:Disk[]
Position:1
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-Volume

Specifies an array of volumes that this cmdlet removes from disk storage pool.

Type:Volume[]
Position:1
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False