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 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, 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
Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.
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.
Examples
Example 1: Remove a data source replica
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.
PS C:\> $PGroup = Get-DPMProtectionGroup -DPMServerName "DPMServer02"
PS C:\> $PObjects = Get-DPMDatasource -ProtectionGroup $PGroup
PS C:\> Remove-DPMDatasourceReplica -Datasource $PObjects -Disk