Share via

Remove-DPMDatasourceReplica

  • Reference
Module:
DataProtectionManager

Removes an inactive replica.

Syntax

Remove-DPMDatasourceReplica
      [-Datasource] <Datasource>
      [-Disk]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-DPMDatasourceReplica
      [-Datasource] <Datasource>
      [-Tape]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Datasource
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Disk

Indicates that the cmdlet removes the replica from disk.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Online

Indicates that the data source uses online protection.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tape

Indicates that the cmdlet removes the replica from tape.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False