Remove-DatasourceReplica

Remove-DatasourceReplica

Removes an inactive replica

Syntax

Remove-DatasourceReplica [-Datasource] <Datasource> -Tape <Media> [-PassThru <SwitchParameter>] [<CommonParameters>]


Remove-DatasourceReplica [-Datasource] <Datasource> -Disk <SwitchParameter> [-PassThru <SwitchParameter>] [<CommonParameters>]


Remove-DatasourceReplica [-Datasource] <Datasource> -Online <SwitchParameter> [-PassThru <SwitchParameter>] [<CommonParameters>]

Detailed Description

The Remove-DatasourceReplica cmdlet removes an inactive replica. You can indicate whether the replica is on disk or tape by using the -Disk or -Tape parameters.

Parameters

-Datasource

A Windows file system share or volume, Microsoft SQL Server database, Microsoft Exchange storage group, Microsoft SharePoint farm, Microsoft Virtual Machine, DPM database, or system state that is a member of a protection group.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

true (ByValue)

Position?

0

-Disk

Indicates that the operation must be performed on a disk.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-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?

named

-Tape

Indicates a tape object.

Attributes

Name Value

Required?

true

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-DatasourceReplica -detailed".
    For technical information, type "Get-Help Remove-DatasourceReplica -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" 
$ds = Get-Datasource -ProtectionGroup $pg 
Remove-DatasourceReplica -Datasource $ds -Disk

This command removes a replica of the data source from disk.