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

<CommonParameters>

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