Remove-VMReplication
Removes the replication relationship of a virtual machine.
Syntax
Remove-VMReplication
[-VMName] <String[]>
[-ComputerName <String[]>]
[-PassThru]
Remove-VMReplication
[-VM] <VirtualMachine[]>
[-PassThru]
Remove-VMReplication
[-VMReplication] <VMReplication[]>
[-PassThru]
Description
The Remove-VMReplication removes the replication relationship of a virtual machine. Replication must be removed independently from both the primary and Replica virtual machines. Removing replication on a Replica virtual machine does not delete the Replica virtual machine.
Examples
Example 1
PS C:\>Remove-VMReplication VM01
This example removes the replication relationship of virtual machine VM01.
Example 2
PS C:\>Remove-VMReplication *
This example removes the replication relationships from all replica-enabled virtual machines on the local Hyper-V host.
Parameters
-ComputerName
Specifies one or more Hyper-V hosts on which the replication relationship of a virtual machine is to be removed. NetBIOS names, IP addresses, and fully-qualified domain names are allowable. The default is the local computer - use "localhost" or a dot (".") to specify the local computer explicitly.
Type: | String[] |
Position: | Named |
Default value: | . |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Specifies that a VMReplication object is to be passed through to the pipeline representing the virtual machine for which the replication relationship will be removed.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VM
Specifies the virtual machine for which the replication relationship is to be removed.
Type: | VirtualMachine[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMName
Specifies the name of the virtual machine for which the replication relationship is to be removed.
Type: | String[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-VMReplication
Specifies a virtual machine replication object associated with the virtual machine whose replication relationship is to be removed.
Type: | VMReplication[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Outputs
None
Default
VMReplication
If -PassThru is specified.
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for