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 http://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.