Share via

Remove-DPMChildDatasource

  • Reference
Module:
DataProtectionManager

Removes a data source or child data source from a protection group.

Syntax

Remove-DPMChildDatasource
      [-ProtectionGroup] <ProtectionGroup>
      [-ChildDatasource] <ProtectableObject[]>
      [-KeepDiskData]
      [-KeepTapeData]
      [-KeepOnlineData]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-DPMChildDatasource
      [-ProtectionGroup] <ProtectionGroup>
      [-ChildDatasource] <ProtectableObject[]>
      [-Online]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

The Remove-DPMChildDatasource cmdlet removes a data source or child data source from a System Center - Data Protection Manager (DPM) protection group. Child data sources are files or folders on a protected volume.

If you remove a data source using this cmdlet, it is equivalent to setting an exclusion.

Examples

Example 1: Remove a child data source

PS C:\>$PGroup = Get-DPMProtectionGroup -DPMServerName "DPMServer07"
PS C:\> $MPGroup = Get-DPMModifiableProtectionGroup $PGroup[0]
PS C:\> $PObjects = Get-DPMDatasource -ProtectionGroup $PGroup
PS C:\> Remove-DPMChildDatasource -ProtectionGroup $MPGroup -ChildDatasource $PObjects[8]

The first command gets all protection groups from the DPM server named DPMServer07, and then stores these groups in the $PGroup variable. You cannot edit these protection groups.

The second command gets the first member of the $PGroup array in editable mode, and then stores this protection group in the $MPGroup variable.

The third command gets the data source for the list of protection groups in $PGroup, and then stores this data source in the $PObjects variable.

The final command uses standard array notation to specify the ninth element of the $PObjects array. The command removes that data source from the protection group stored in $MPGroup.

Parameters

-ChildDatasource

Specifies an array of data sources, such as folders in a file system, that DPM can protect individually.

Type:ProtectableObject[]
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.

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

-KeepDiskData

Indicates that the cmdlet keeps existing data on a disk.

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

-KeepOnlineData

Indicates that the cmdlet keeps replicas even after protection ends. You must also specify the KeepDiskData parameter to enable this parameter.

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

-KeepTapeData

Indicates that the cmdlet keeps existing data on a tape.

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

-Online

Indicates that online protection is enabled.

Type:SwitchParameter
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

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

-ProtectionGroup

Specifies a protection group from which this cmdlet removes data sources. To obtain a ProtectionGroup object, use the Get-DPMProtectionGroup cmdlet.

Type:ProtectionGroup
Position:1
Default value:None
Required:True
Accept pipeline input:True
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Outputs

ProtectionGroup