Skip to content

Commit abb3e72

Browse files
authored
Update troubleshoot.md
1 parent 7525876 commit abb3e72

File tree

1 file changed

+11
-7
lines changed

1 file changed

+11
-7
lines changed

articles/virtual-machines/extensions/troubleshoot.md

Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -80,19 +80,23 @@ That certificate will be automatically re-generated by restarting the Windows Gu
8080
- Right-click, and select "End Task". The process will be automatically restarted
8181

8282

83-
You can also trigger a new GoalState to the VM, by executing an "empty update":
83+
You can also trigger a new GoalState to the VM, by executing a "VM Reapply". VM [Reapply](https://docs.microsoft.com/rest/api/compute/virtualmachines/reapply) is an API introduced in 2020 to reapply a VM's state. We recommend doing this at a time when you can tolerate a short VM downtime. While Reapply itself does not cause a VM reboot, and the vast majority of times calling Reapply will not reboot the VM, there is a very small risk that some other pending update to the VM model gets applied when Reapply triggers a new goal state, and that other change could require a restart.
8484

85-
Azure PowerShell:
85+
Azure Portal:
86+
87+
In the portal, select the VM and in the left pane under the **Support + troubleshooting**, select **Redeploy + reapply**, then select **Reapply**.
88+
89+
90+
Azure PowerShell *(replace the RGName and VMName with your values)* :
8691

8792
```azurepowershell
88-
$vm = Get-AzureRMVM -ResourceGroupName <RGName> -Name <VMName>
89-
Update-AzureRmVM -ResourceGroupName <RGName> -VM $vm
93+
Set-AzVM -ResourceGroupName <RGName> -Name <VMName> -Reapply
9094
```
9195

92-
Azure CLI:
96+
Azure CLI *(replace the RGName and VMName with your values)* :
9397

9498
```azurecli
95-
az vm update -g <rgname> -n <vmname>
99+
az vm reapply -g <RGName> -n <VMName>
96100
```
97101

98-
If an "empty update" didn't work, you can add a new empty Data Disk to the VM from the Azure Management Portal, and then remove it later once the certificate has been added back.
102+
If a "VM Reapply" didn't work, you can add a new empty Data Disk to the VM from the Azure Management Portal, and then remove it later once the certificate has been added back.

0 commit comments

Comments
 (0)