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. A child data source can refer to files or folders on a protected volume.
If you remove a data source using the Remove-Datasource 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 you 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 whether online protection is enabled.
Aliases |
none |
Required? |
true |
Position? |
3 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-PassThru
Indicates that the cmdlet generates output. By default, this cmdlet does not generate output. You can use the PassThru parameter in order to use the cmdlet in a pipeline.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-ProtectionGroup<ProtectionGroup>
Specifies a protection group.
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
Notes
- For more information, type "
Get-Help Remove-DPMChildDatasource -detailed
".
Examples
Example 1: Remove a child data source
This example removes the ninth child data source stored in a parent data source.
The first command gets all protection groups from the DPM server named DPMServer07 and stores these groups in the $Pg variable. You cannot edit these protection groups.
The second command gets the first member of the $Pg array in editable mode, and then stores this protection group in the $Mpg variable.
The third command gets the data source for the list of protection groups in the $Pg variable and stores this data source in the $Po variable.
The fourth command uses standard array notation to specify the ninth element of the $Po array. The command removes that data source from the protection group stored in the $Mpg variable.
PS C:\> $Pg = Get-ProtectionGroup -DPMServerName "DPMServer07"
PS C:\> $Mpg = Get-ModifiableProtectionGroup $Pg[0]
PS C:\> $Po = Get-Datasource -ProtectionGroup $Pg
PS C:\> Remove-DPMChildDatasource -ProtectionGroup $Mpg -ChildDatasource $Po[8]