Remove-DPMChildDatasource
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