Share via

Remove-DPMDatasourceReplica

Module:
DataProtectionManager Module

Removes an inactive replica.

Syntax

Disk (Default) 

Remove-DPMDatasourceReplica
    [-Datasource] <Datasource>
    [-Disk]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Tape 

Remove-DPMDatasourceReplica
    [-Datasource] <Datasource>
    [-Tape]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Online 

Remove-DPMDatasourceReplica
    [-Datasource] <Datasource>
    [-Online]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The Remove-DPMDatasourceReplica cmdlet removes an inactive replica from disk or tape.

Examples

Example 1: Remove a data source replica

PS C:\>$PGroup = Get-DPMProtectionGroup -DPMServerName "DPMServer02"
PS C:\> $PObjects = Get-DPMDatasource -ProtectionGroup $PGroup
PS C:\> Remove-DPMDatasourceReplica -Datasource $PObjects -Disk

The first command gets the protection group from the DPM server named DPMServer02, and then stores that group in the $PGroup variable.

The second command gets the data source from the protection group in $PGroup, and then stores that data source in the $PObject variable.

The last command removes the replica of the data source in $PObjects from disk.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Datasource

Specifies a data source object for which this cmdlet removes a replica. A data source can be a file system share or volume for the Windows operating system, Microsoft SQL Server database, Microsoft Exchange Server storage group, Microsoft SharePoint farm, Microsoft Virtual Machine, System Center 2019 - Data Protection Manager (DPM) database, or system state that is a member of a protection group.

Parameter properties

Type:Datasource
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:1
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-Disk

Indicates that the cmdlet removes the replica from disk.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Disk
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Online

Indicates that the data source uses online protection.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Online
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PassThru

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Tape

Indicates that the cmdlet removes the replica from tape.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Tape
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.