Remove-DPMChildDatasource
Removes a data source or child data source from a protection group.
Syntax
StopProtection (Default)
Remove-DPMChildDatasource
[-ProtectionGroup] <ProtectionGroup>
[-ChildDatasource] <ProtectableObject[]>
[-KeepDiskData]
[-KeepTapeData]
[-KeepOnlineData]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RejectCloud
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.
Parameter properties
| Type: | ProtectableObject[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 2 |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-KeepDiskData
Indicates that the cmdlet keeps existing data on a disk.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
StopProtection
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-KeepOnlineData
Indicates that the cmdlet keeps replicas even after protection ends. You must also specify the KeepDiskData parameter to enable this parameter.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
StopProtection
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-KeepTapeData
Indicates that the cmdlet keeps existing data on a tape.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
StopProtection
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Online
Indicates that online protection is enabled.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
RejectCloud
| Position: | 3 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-PassThru
Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ProtectionGroup
Specifies a protection group from which this cmdlet removes data sources. To obtain a ProtectionGroup object, use the Get-DPMProtectionGroup cmdlet.
Parameter properties
| Type: | ProtectionGroup |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 1 |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.