Merge pull request #142904 from axelgMS/patch-18

Update troubleshoot.md

Author: PRMerger17

articles/virtual-machines/extensions/troubleshoot.md

@@ -73,26 +73,30 @@ Once the extension has been removed, the template can be re-executed to run the
 
 ### Trigger a new GoalState to the VM
 You might notice that an extension hasn't been executed, or is failing to execute because of a missing "Windows Azure CRP Certificate Generator" (that certificate is used to secure the transport of the extension's protected settings).
-That certificate will be automatically re-generated by restarting the Windows Guest Agent from inside the Virtual Machine:
+That certificate will be automatically regenerated by restarting the Windows Guest Agent from inside the Virtual Machine:
 - Open the Task Manager
 - Go to the Details tab
 - Locate the WindowsAzureGuestAgent.exe process
 - Right-click, and select "End Task". The process will be automatically restarted
 
 
-You can also trigger a new GoalState to the VM, by executing an "empty update":
+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. 
 
-Azure PowerShell:
+Azure portal:
+
+In the portal, select the VM and in the left pane under the **Support + troubleshooting**, select **Redeploy + reapply**, then select **Reapply**.
+
+
+Azure PowerShell *(replace the RG Name and VM Name with your values)*:
 
 ```azurepowershell
-$vm = Get-AzureRMVM -ResourceGroupName <RGName> -Name <VMName>  
-Update-AzureRmVM -ResourceGroupName <RGName> -VM $vm  
+Set-AzVM -ResourceGroupName <RG Name> -Name <VM Name> -Reapply
 ```
 
-Azure CLI:
+Azure CLI *(replace the RG Name and VM Name with your values)*:
 
 ```azurecli
-az vm update -g <rgname> -n <vmname>
+az vm reapply -g <RG Name> -n <VM Name>
 ```
 
-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.
+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.