Remove-DPMDatasourceReplica
Remove-DPMDatasourceReplica
Removes an inactive replica.
Syntax
Parameter Set: Disk
Remove-DPMDatasourceReplica [-Datasource] <Datasource> -Disk [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: Online
Remove-DPMDatasourceReplica [-Datasource] <Datasource> -Online [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: Tape
Remove-DPMDatasourceReplica [-Datasource] <Datasource> -Tape [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Remove-DPMDatasourceReplica cmdlet removes an inactive replica from disk or tape.
Parameters
-Datasource<Datasource>
Specifies a Windows file system share or volume, Microsoft SQL Server database, Microsoft Exchange storage group, Microsoft SharePoint farm, virtual machine, System Center 2012 – Data Protection Manager (DPM) database, or system state that is a member of a protection group.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
True (ByValue) |
Accept Wildcard Characters? |
false |
-Disk
Indicates that the cmdlet removes the replica from disk.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Online
Indicates that the data source uses online protection.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-PassThru
Indicates that the cmdlet generates output. By default, this cmdlet does not generate output. You can use the PassThru parameter in order to use the cmdlet in a pipeline.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Tape
Indicates that the cmdlet removes the replica from tape.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Notes
For more information, type "
Get-Help Remove-DPMDatasourceReplica -detailed
".For technical information, type "
Get-Help Remove-DPMDatasourceReplica -full
".
Examples
Example 1: Remove a data source replica
This example removes a data source replica from disk.
The first command gets the protection group from the DPM server named DPMServer02 and stores the protection group in the $Pg variable.
The second command gets the data source from the protection group in the $Pg variable stores the data source in the $Ds variable.
The last command removes the replica of the data source in the $Ds variable from disk.
PS C:\> $Pg = Get-ProtectionGroup -DPMServerName "DPMServer02"
PS C:\> $Ds = Get-Datasource -ProtectionGroup $Pg
PS C:\> Remove-DPMDatasourceReplica -Datasource $Ds -Disk