You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/backup/backup-azure-manage-vms.md
+26-15Lines changed: 26 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -196,6 +196,8 @@ To protect your data, Azure Backup includes the soft delete feature. With soft d
196
196
197
197
## Uninstall and re-install the VMSnapshot extension on Windows operating system
198
198
199
+
If you 're experiencing Azure VM backup or extension failure issues, uninstall and reinstall the `VMSnapshot` extension on a Windows VM. This extension is responsible for enabling application-consistent snapshots during backup operations. 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
+
199
201
To uninstall and re-install the VMSnapshot extension on Windows operating system for the backup operation, follow these steps:
200
202
201
203
1. Uninstall the `VMSnapshot` extension by running the following cmdlet:
@@ -204,17 +206,28 @@ To uninstall and re-install the VMSnapshot extension on Windows operating system
204
206
Remove-AzVMExtension -ResourceGroupName "<Azure VM's resource group name>" -<VMName "Azure VM name>" -Name "VMSnapshot"
205
207
```
206
208
207
-
2. 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.
208
-
3. On the Services window, stop the **Windows Azure Guest Agent** service.
209
-
4. Go to the folder `C:\Packages\Plugins`, and then rename the folder `Microsoft.Azure.RecoveryServices.VMSnapshot` to `Microsoft.Azure.RecoveryServices.VMSnapshot_old`.
210
-
5. Right-click the Windows **Start** icon, select **Run**, and then enter **regedit** to open the **Registry Editor**.
211
-
6. 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.
212
-
7. Go to *HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsAzure\HandlerState*, and delete `Microsoft.Azure.RecoveryServices.VMSnapshot_1.X.XX.X`.
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`.
213
224
214
225
>[!Note]
215
-
>The plugin version **1.X.XX.X** might change based on your environment.
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":::
216
229
217
-
8. Open the **Command prompt** as **Administrator** and add the required registry entries by running the following commands:
230
+
1. Open the **Command prompt** as **Administrator** and add the required registry entries by running the following commands:
9. On the **Services** window, start **Windows Azure Guest Agent**.
228
-
1. Restart the Azure VM.
229
-
1. Run an on-demand backup of Azure VM; this operation installs a new `VMSnapshot` extension.
230
-
231
-
232
-
233
-
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":::
234
241
242
+
1. On the **Services** window, start **Windows Azure Guest Agent**.
235
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":::
236
245
246
+
1. Restart the Azure VM.
247
+
1. Run an on-demand backup of Azure VM; this operation installs a new `VMSnapshot` extension.
0 commit comments