Force-Sync
Forcibly synchronizes the VPG.
Syntax
Force-Sync [-ZVMIP] <String>[-ZVMPort] <Int32> [-Username] <String> [-Password] <String>
[-VirtualProtectionGroup] <String> [-Wait <int32>] [<Common&RiskParameters>] |
Description
The Force-Sync cmdlet synchronizes the VPG from scratch, using the MD5 Message-Digest Algorithm. This cmdlet is used when the replicated disks are no longer synchronized with the protected disks, for example, after rolling back from a VMware snapshot.
Parameters
[-ZVMIP] <String>
The IP address of the machine where the Zerto Virtual Manager is installed that is used to process the cmdlet. The VPG to synchronize can be defined on this Zerto Virtual Manager site or a paired site.
Required? | True |
Position? | 1 or named |
Default Value | None |
Accept Wildcard Characters? | False |
[-ZVMPort] <Int32>
The HTTP port used for inbound communication with the Zerto Virtual Manager for APIs and cmdlets, specified during the installation. The default port recommended during installation is 9080.
Required? | True |
Position? | 2 or named |
Default Value | None |
Accept Wildcard Characters? | False |
[-Username] <String>
A username defined in the users.txt file in the Zerto Virtual Replication installation folder, for the Zerto Virtual Manager where the cmdlet is run.
Required? | True |
Position? | 3 or named |
Default Value | None |
Accept Wildcard Characters? | False |
[-Password] <String>
The password for the specified username, in the users.txt file in the Zerto Virtual Replication installation folder, for the Zerto Virtual Manager where the cmdlet is run, encrypted using SHA-1.
Required? | True |
Position? | 4 or named |
Default Value | None |
Accept Wildcard Characters? | False |
[-VirtualProtectionGroup] <String>
The name of the VPG to synchronize. The value specified is case-sensitive.
Required? | True |
Position? | 5 or named |
Default Value | None |
Accept Wildcard Characters? | False |
-Wait <Int32>
The number of seconds to wait before timing out.
Required? | False |
Position? | Named |
Default Value | None |
Accept Wildcard Characters? | False |
<Common&RiskParameters>
This cmdlet supports the parameters described in
Optional PowerShell Parameters.
Inputs and Outputs
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 returns.
Inputs | None. |
Outputs | Force-Sync returns the task identifier for the command and the site identifier where the VPG is defined. |
Notes
Use this cmdlet if there is a change to the virtual machines in the VPG that warrants a synchronization, such as rolling back to a VMware snapshot.
The command returns a result even when the actual removal of the VPG has not completed.
Example 1
PS C:\Windows\SysWOW64\WindowsPowerShell\v1.0> Force-Sync 182.24.123.123 9080 administrator password -VirtualProtectionGroup ’Back Office’ |
This command forcibly synchronizes the Back Office VPG. The Zerto Virtual Manager used to process the cmdlet runs on IP 182.24.123.123 and port 9080.
The cmdlet returns the command task identifier and site identifier. For example:
Identifier SiteId ---------- ------ ab1b3c1b-fc94-4a1f-a42d-eb57b40526e0 d2da8a37-68f0-4464-a70c-abb19683fd01 |