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 https://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.