Skip to content

Commit 0cee0ef

Browse files
authored
Merge pull request #302517 from AbhishekMallick-MS/Jul-10-2025-EEE
Addressed EEE doc ask #26432439
2 parents 37856d6 + 9f2db8d commit 0cee0ef

8 files changed

+58
-4
lines changed

articles/backup/backup-azure-manage-vms.md

Lines changed: 55 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Manage and monitor Azure VM backups
33
description: Learn how to manage and monitor Azure VM backups by using the Azure Backup service.
44
ms.topic: how-to
5-
ms.date: 09/11/2024
5+
ms.date: 08/13/2025
66
ms.service: azure-backup
77
author: AbhishekMallick-MS
88
ms.author: v-mallicka
@@ -149,7 +149,7 @@ To stop protection and delete data of a VM:
149149
:::image type="content" source="./media/backup-azure-manage-vms/delete-backup-data.png" alt-text="Screenshot showing to delete backup data.":::
150150

151151
> [!NOTE]
152-
> After completing the delete operation the backed up data will be retained for 14 days in the [soft deleted state](./soft-delete-virtual-machines.md). <br>In addition, you can also [enable or disable soft delete](./backup-azure-security-feature-cloud.md#enable-and-disable-soft-delete).
152+
> After completing the delete operation the backed-up data will be retained for 14 days in the [soft deleted state](./soft-delete-virtual-machines.md). <br>In addition, you can also [enable or disable soft delete](./backup-azure-security-feature-cloud.md#enable-and-disable-soft-delete).
153153
154154
## Resume protection of a VM
155155

@@ -194,8 +194,60 @@ To protect your data, Azure Backup includes the soft delete feature. With soft d
194194
* These backup items remain active in the system adhering to the backup and retention policy set by the user. The backed-up data for these Azure VMs will be retained according to the retention policy. The expired recovery points (except the most recent recovery point) are cleaned according to the retention range set in the backup policy.
195195
* To avoid any additional cost, we recommend deleting the backup items where the primary data source no longer exists. This is in a scenario where the backup item/data for the deleted resources is no longer required, since the most recent recovery point is retained forever and you're charged according to the applicable backup pricing.
196196

197+
## Re-install the VMSnapshot backup extension for Azure VM protection
198+
199+
VMSnapshot backup extension enables application-consistent snapshots during backup operations. You can uninstall and reinstall the `VMSnapshot` extension on a Windows VM. Since it’s a hidden extension, the process involves manually cleaning up registry entries and plugin folders, followed by restarting the Azure Guest Agent. After the registry is cleaned, the extension automatically reinstalls during the next backup job.
200+
201+
To re-install the VMSnapshot extension on Windows operating system for the backup operation, follow these steps:
202+
203+
1. Uninstall the `VMSnapshot` extension by running the following cmdlet:
204+
205+
```azurepowershell-interactive
206+
Remove-AzVMExtension -ResourceGroupName "<Azure VM's resource group name>" -<VMName "Azure VM name>" -Name "VMSnapshot"
207+
```
208+
209+
:::image type="content" source="./media/backup-azure-manage-vms/uninstall-backup-extension.png" alt-text="Screenshot shows the execution of the extension uninstall command." lightbox="./media/backup-azure-manage-vms/uninstall-backup-extension.png":::
210+
211+
1. Sign in to the Azure VM, right-click the Windows **Start** icon to open the **Run** window, and then enter **services.msc** to open the **Services** window.
212+
1. On the Services window, stop the **Windows Azure Guest Agent** service.
213+
214+
:::image type="content" source="./media/backup-azure-manage-vms/stop-windows-azure-guest-agent-service.png" alt-text="Screenshot shows the Windows Azure guest agent service is stopped." lightbox="./media/backup-azure-manage-vms/stop-windows-azure-guest-agent-service.png":::
215+
216+
1. Go to the folder `C:\Packages\Plugins`, and then rename the folder `Microsoft.Azure.RecoveryServices.VMSnapshot` to `Microsoft.Azure.RecoveryServices.VMSnapshot_old`.
217+
218+
1. Right-click the Windows **Start** icon, select **Run**, and then enter **regedit** to open the **Registry Editor**.
219+
1. On the **Registry Editor** window, go to *HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsAzure* and export to an alternate location before modifying for the backup operation.
220+
221+
:::image type="content" source="./media/backup-azure-manage-vms/export-registry-key.png" alt-text="Screenshot shows the registry key for export.":::
222+
223+
1. Go to *HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsAzure\HandlerState*, and delete `Microsoft.Azure.RecoveryServices.VMSnapshot_1.X.XX.X`.
224+
225+
>[!Note]
226+
>The backup extension version **1.X.XX.X** might change based on your environment.
227+
228+
:::image type="content" source="./media/backup-azure-manage-vms/delete-registry-key.png" alt-text="Screenshot shows the deletion of backup extension registry key values." lightbox="./media/backup-azure-manage-vms/delete-registry-key.png":::
229+
230+
1. Open the **Command prompt** as **Administrator** and add the required registry entries by running the following commands:
231+
232+
```
233+
REG ADD "HKLM\SOFTWARE\Microsoft\BcdrAgent" /v IsProviderInstalled /t REG_SZ /d False /f
234+
```
235+
236+
```
237+
REG ADD "HKLM\SOFTWARE\Microsoft\BcdrAgentPersistentKeys" /v IsCommonProviderInstalled /t REG_SZ /d False /f
238+
```
239+
240+
:::image type="content" source="./media/backup-azure-manage-vms/install-backup-agent.png" alt-text="Screenshot shows the installation of backup agent." lightbox="./media/backup-azure-manage-vms/install-backup-agent.png":::
241+
242+
1. On the **Services** window, start **Windows Azure Guest Agent**.
243+
244+
:::image type="content" source="./media/backup-azure-manage-vms/start-windows-azure-guest-agent-service.png" alt-text="Screenshot shows the Windows Azure guest agent service is started." lightbox="./media/backup-azure-manage-vms/start-windows-azure-guest-agent-service.png":::
245+
246+
1. Restart the Azure VM.
247+
1. Run an on-demand backup of Azure VM; this operation installs a new `VMSnapshot` extension.
248+
197249
## Next steps
198250
199251
* Learn how to [back up Azure VMs from the VM's settings](backup-azure-vms-first-look-arm.md).
200252
* Learn how to [restore VMs](backup-azure-arm-restore-vms.md).
201-
* Learn how to [monitor Azure VM backups](./backup-azure-monitoring-built-in-monitor.md).
253+
* Learn how to [monitor Azure VM backups](./backup-azure-monitoring-built-in-monitor.md).

articles/backup/backup-azure-vms-troubleshoot.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Troubleshoot backup errors with Azure VMs
33
description: In this article, learn how to troubleshoot errors encountered with backup and restore of Azure virtual machines.
44
ms.reviewer: srinathv
55
ms.topic: troubleshooting
6-
ms.date: 07/24/2025
6+
ms.date: 08/13/2025
77
ms.service: azure-backup
88
author: AbhishekMallick-MS
99
ms.author: v-mallicka
@@ -263,6 +263,8 @@ The Backup operation failed due to inconsistent state of Backup Extension. To re
263263
* After deleting backup extension, retry the backup operation
264264
* The subsequent backup operation will install the new extension in the desired state
265265
266+
Learn more how to [reinstall the VMSnapshot backup extension on Windows VM](backup-azure-manage-vms.md#re-install-the-vmsnapshot-backup-extension-for-azure-vm-protection).
267+
266268
### ExtensionFailedSnapshotLimitReachedError - Snapshot operation failed as snapshot limit is exceeded for some of the disks attached
267269
268270
Error code: ExtensionFailedSnapshotLimitReachedError <br/>
182 KB
Loading
163 KB
Loading
114 KB
Loading
180 KB
Loading
193 KB
Loading
125 KB
Loading

0 commit comments

Comments
 (0)