This is an archive version of the document. To get the most up-to-date information, see the current version.

Reset-HvVmChangeTracking

Short Description

Clears change tracking data for a specific VM or specific virtual disk (VHD).

Applies to

Platform: Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

Reset-HvVmChangeTracking [-Server] <CHost> [-VMName <String>] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

-OR-

Reset-HvVmChangeTracking [-Server] <CHost> [-VhdPath <String>] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

Detailed Description

This cmdlet clears and resets change tracking data for a VM or specific virtual disk (VHD).

Change tracking data is history of changes kept for each data block. Using the changed block tracking (CBT) mechanism allows to reduce the backup time as the backup process compares the CBT data instead of scanning all data. You may need to reset the change tracking data in case it was corrupted.

This cmdlet provides two scenarios. You can reset change tracking for a specific VM or for a specific virtual disk (VHD).

Parameters

Parameter	Description	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
Server	Specifies the server where the VM reside.	True	2	False	False
VMName	Specifies the VM. The cmdlet will reset change tracking data for this VM.	False	Named	False	False
VhdPath	Specifies the virtual disk (VHD). The cmdlet will reset change tracking data for this disk.	False	Named	False	False

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Example 1

This command resets change tracking data for the VM named "Fileserver". The VM is located on host represented by the $server variable. The server object is obtained with Get-VBRServer and assigned to the variable beforehand.

Reset-HvVmChangeTracking -Server $server -VMName "Fileserver"

Example 2

This command resets change tracking data for the specified virtual disk. The VM is located on host represented by the $server variable. The server object is obtained with Get-VBRServer and assigned to the variable beforehand.

Reset-HvVmChangeTracking -Server $server -VhdPath "C:\Users\Public\Hyper-V\Virtual Hard Disks\hv_dns.vhdx"

Related Commands

Get-VBRServer