Remove-DPMChildDatasource
Remove-DPMChildDatasource
Removes a data source or child data source from a protection group.
Syntax
Parameter Set: StopProtection
Remove-DPMChildDatasource [-ProtectionGroup] <ProtectionGroup> [-ChildDatasource] <ProtectableObject[]> [-KeepDiskData] [-KeepOnlineData] [-KeepTapeData] [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: RejectCloud
Remove-DPMChildDatasource [-ProtectionGroup] <ProtectionGroup> [-ChildDatasource] <ProtectableObject[]> [-Online] [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Remove-DPMChildDatasource cmdlet removes a data source or child data source from a System Center 2012 – 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.
Parameters
-ChildDatasource<ProtectableObject[]>
Specifies an array of data sources, such as folders in a file system, that DPM can protect individually.
Aliases |
none |
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.
Aliases |
none |
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.
Aliases |
none |
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.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Online
Indicates that online protection is enabled.
Aliases |
none |
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.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-ProtectionGroup<ProtectionGroup>
Specifies a protection group from which this cmdlet removes data sources. To obtain a ProtectionGroup object, use the Get-DPMProtectionGroup cmdlet.
Aliases |
none |
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.
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.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
- ProtectionGroup
Examples
Example 1: Remove a child data source
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.
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]