Remove-ChildDatasource
Remove-ChildDatasource
Removes a data source or child data source from a protection group.
Syntax
Remove-ChildDatasource [-ProtectionGroup] <ProtectionGroup> [-ChildDatasource] <ProtectableObject> [-KeepDiskData] [-KeepOnlineData <SwitchParameter>] [-KeepTapeData] [-PassThru <SwitchParameter>] [<CommonParameters>]
Remove-ChildDatasource [-Online] <SwitchParameter> [-ChildDatasource] <ProtectableObject> [-ProtectionGroup] <ProtectionGroup> [-PassThru <SwitchParameter>] [<CommonParameters>]
Detailed Description
The Remove-ChildDatasource cmdlet removes a data source or child data source from a 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
-Online
With Add-ProtectableObject: Indicates that the protectable object must be also protected with DPM Online.
With New-RecoveryPoint: Indicates that the recovery point must be created on DPM Online.
With Remove-DatasourceReplica: Indicates that data retained on DPM Online must be deleted.
With Remove-ChildDatasource: Indicates that the protectable object is removed from protection on DPM Online.
Attributes
Name | Value |
---|---|
Required? |
true |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
2 |
-ChildDatasource
A data source that can be protected individually. For example, a folder in a file system.
Attributes
Name | Value |
---|---|
Required? |
true |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
true (ByValue) |
Position? |
1 |
-ProtectionGroup
The name of a protection group.
Attributes
Name | Value |
---|---|
Required? |
true |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
true (ByValue) |
Position? |
0 |
-KeepDiskData
Retain the data on a disk.
Attributes
Name | Value |
---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-KeepOnlineData
Indicates that data on DPM Online is retained.
Attributes
Name | Value |
---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-KeepTapeData
Retains the existing data on a tape.
Attributes
Name | Value |
---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-PassThru
The -PassThru parameter can be used with many commands in DPM to return a related object in cases where there is no default output. Using the PassThru parameter allows such cmdlets to be part of a pipeline.
Attributes
Name | Value |
---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-CommonParameter
This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, and OutVariable. For more information, see about_CommonParameters.
Input and Return Types
The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet emits.
Notes
For more information, type "Get-Help Remove-ChildDatasource -detailed".
For technical information, type "Get-Help Remove-ChildDatasource-full".Additionally, any updated information about the cmdlet will be available at https://go.microsoft.com/fwlink/?LinkId=95130.
Examples
EXAMPLE 1
$pg = Get-ProtectionGroup -DPMServerName "TestingServer"
$mpg=Get-ModifiableProtectionGroup $pg[0]
$po = Get-Datasource -ProtectionGroup $pg
Remove-ChildDatasource -ProtectionGroup $mpg -ChildDatasource $po[8]
This command removes the ninth child data source stored in the parent data source.