Remove-DPMDiskStorage

Removes disk-based storage from the storage pool on a DPM server.

Syntax

Remove-DPMDiskStorage [-DPMDisk] <Disk[]> [-Confirm] [-WhatIf] [<CommonParameters>]
Remove-DPMDiskStorage [-Volume] <Volume[]> [-Confirm] [-WhatIf] [<CommonParameters>]

Description

The Remove-DPMDiskStorage cmdlet removes given disk or volume from the storage pool of a given System Center 2016 - 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

-DPMDisk

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

Type:Disk[]
Required:True
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[]
Required:True
Position:1
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

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

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

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