Remove-DPMChildDatasource

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

Syntax

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

Description

The Remove-DPMChildDatasource cmdlet removes a data source or child data source from a System Center 2016 - 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[]
Required:True
Position:2
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-KeepDiskData

Indicates that the cmdlet keeps existing data on a disk.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-KeepTapeData

Indicates that the cmdlet keeps existing data on a tape.

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

Indicates that online protection is enabled.

Type:SwitchParameter
Required:True
Position:3
Default value:None
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
Required:False
Position:Named
Default value:None
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
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

Outputs

ProtectionGroup