Merging changes synced from https://github.com/MicrosoftDocs/SupportArticles-docs-pr (branch live)

Learn Build Service GitHub App · Learn Build Service GitHub App · commit 07c5aad91a9e · 2025-10-24T22:05:25.000Z
diff --git a/support/azure/virtual-machines/linux/extensions-stop-running.md b/support/azure/virtual-machines/linux/extensions-stop-running.md
@@ -13,6 +13,8 @@ ms.collection: linux
 
 _Original KB number:_ &nbsp; 4099558
 
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 ## Symptoms
 
 The Linux VM Agent fails to process extensions. This causes some extensions to stop running, which affects some dependent Azure services, such as Azure Backup Azure Site Recovery.
diff --git a/support/azure/virtual-machines/linux/how-to-use-perfInsights-linux.md b/support/azure/virtual-machines/linux/how-to-use-perfInsights-linux.md
@@ -19,6 +19,8 @@ ms.author: jarrettr
 
 **Applies to:** :heavy_check_mark: Linux VMs
 
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 [PerfInsights Linux](https://aka.ms/perfinsightslinuxdownload) is a self-help diagnostics tool that collects and analyzes the diagnostic data, and provides a report to help troubleshoot Linux virtual machine performance problems in Azure. Use Performance Diagnostics to identify and troubleshoot performance issues in one of two modes: 
 
 - **Continuous diagnostics** collects data at five-second intervals and reports actionable insights about high resource usage every five minutes. 
diff --git a/support/azure/virtual-machines/linux/linux-agent-cannot-process-extensions.md b/support/azure/virtual-machines/linux/linux-agent-cannot-process-extensions.md
@@ -13,6 +13,8 @@ ms.collection: linux
 
 _Original KB number:_ &nbsp; 3200481
 
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 This article provides information about resolving a problem in which Azure Linux VMs that are running Azure Linux VM Agent 2.1.5 or 2.1.6 cannot process extensions.
 
 ## Symptoms
diff --git a/support/azure/virtual-machines/linux/linux-azure-guest-agent.md b/support/azure/virtual-machines/linux/linux-azure-guest-agent.md
@@ -19,6 +19,8 @@ ms.author: axelg
 
 [!INCLUDE [Feedback](../../../includes/feedback.md)]
 
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 The [Azure Linux Agent](/azure/virtual-machines/extensions/agent-linux) enables a virtual machine (VM) to communicate with the Fabric Controller (the underlying physical server on which the VM is hosted) on IP address 168.63.129.16.
 
 >[!NOTE]
diff --git a/support/azure/virtual-machines/linux/linux-custom-image-provisioning-errors.md b/support/azure/virtual-machines/linux/linux-custom-image-provisioning-errors.md
@@ -10,6 +10,8 @@ ms.reviewer: srijangupta, scotro, maries, jarrettr, v-weizhu
 
 **Applies to:** :heavy_check_mark: Linux VMs
 
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 ## Overview
 
 When you upload or capture a generalized virtual machine (VM) image as a specialized VM image, a [provisioning timeout error](#provisioning-timeout-error-during-an-upload-process) will occur.
diff --git a/support/azure/virtual-machines/linux/linux-image-provisioning-agent-update-awareness.md b/support/azure/virtual-machines/linux/linux-image-provisioning-agent-update-awareness.md
@@ -15,6 +15,9 @@ ms.reviewer:
 
 _Original KB number:_ &nbsp; 4538386
 
+
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 ## Summary
 
 Many Linux Azure Marketplace images contain an **Azure Linux Agent**, which is responsible for completing the setup of the newly created Virtual Machine (VM), such as setting the hostname, username, password/ ssh keys, and mounting an ephemeral disk. This setup process is known as 'provisioning'. In addition, the agent provides support for Azure VM Extensions.
diff --git a/support/azure/virtual-machines/linux/linux-vm-extension-status-not-reported.md b/support/azure/virtual-machines/linux/linux-vm-extension-status-not-reported.md
@@ -13,6 +13,8 @@ ms.collection: linux
 
 _Original KB number:_ &nbsp; 4077547
 
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 This article provides a solution to an issue in which the Linux VM extension status is not reported after an Azure Linux Agent update to version 2.2.19.
 
 ## Symptoms
diff --git a/support/azure/virtual-machines/linux/linux-vm-sshconnectionissue-perms.md b/support/azure/virtual-machines/linux/linux-vm-sshconnectionissue-perms.md
@@ -13,6 +13,8 @@ ms.collection: linux
 
 **Applies to:** :heavy_check_mark: Linux VMs
 
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 This article provides solutions to an issue in which connecting to a Linux virtual machine (VM) via Secure Shell (SSH) fails because the _/var/empty/sshd_ directory in RHEL, the _/var/lib/empty_ directory in SUSE, or the _/var/run/sshd_ directory in Ubuntu, doesn't exist, or it isn't owned by the root user, or it's group-writable or world-writable.
 
 ## Symptoms
diff --git a/support/azure/virtual-machines/linux/reset-password.md b/support/azure/virtual-machines/linux/reset-password.md
@@ -20,6 +20,8 @@ ms.reviewer: msaenzbo, divargas, v-six
 
 **Applies to:** :heavy_check_mark: Linux VMs
 
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 This article provides three methods to reset local Linux Virtual Machine (VM) passwords. If the user account is expired or you want to create a new account, you can use the following methods to create a new local admin account and regain access to the VM.
 
 ## Reset the password by using Azure Linux Agent
diff --git a/support/azure/virtual-machines/linux/serial-console-grub-proactive-configuration.md b/support/azure/virtual-machines/linux/serial-console-grub-proactive-configuration.md
@@ -19,6 +19,8 @@ ms.author: jarrettr
 
 **Applies to:** :heavy_check_mark: Linux VMs
 
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 Having access to the Serial Console and GRUB will improve recovery times of your IaaS Linux Virtual Machine in most cases. GRUB offers recovery options that otherwise would take longer to recover your VM.
 
 The reasons to perform a VM recovery are many and can be attributed to scenarios such as:
diff --git a/support/azure/virtual-machines/linux/troubleshoot-deployment-new-vm-linux.md b/support/azure/virtual-machines/linux/troubleshoot-deployment-new-vm-linux.md
@@ -16,6 +16,8 @@ ms.reviewer: srijangupta, scotro, jarrettr
 
 [!INCLUDE [support-disclaimer](../../../includes/support-disclaimer.md)]
 
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 ## Symptoms
 
 A typical provisioning failure scenario occurs after you create a custom image, then deploy a VM from it, you then experience unto 40mins where the VM status is showing `creating`, and you see this error message:
diff --git a/support/azure/virtual-machines/linux/troubleshoot-device-names-problems.md b/support/azure/virtual-machines/linux/troubleshoot-device-names-problems.md
@@ -21,6 +21,8 @@ ms.author: jarrettr
 
 **Applies to:** :heavy_check_mark: Linux VMs
 
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 This article explains why device names change after you restart a Linux VM or reattach the data disks. The article also provides solutions for this problem.
 
 ## Symptoms
diff --git a/support/azure/virtual-machines/linux/troubleshoot-lis-driver-issues-on-linux-vms.md b/support/azure/virtual-machines/linux/troubleshoot-lis-driver-issues-on-linux-vms.md
@@ -12,6 +12,8 @@ ms.custom: sap:My VM is not booting, linux-related-content
 
 **Applies to:** :heavy_check_mark: Linux VMs
 
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 When you run a Linux Virtual Machine (VM) on Azure, the Hyper-V drivers, also known as Linux Integration Services (LIS) drivers, are crucial for proper VM operations. These drivers allow the VM to communicate with the underlying Azure hypervisor. If these drivers are missing or not properly loaded, the VM might fail to boot. This article provides solutions to LIS/Hyper-V driver issues in Azure Linux VMs.
 
 ## Prerequisites
diff --git a/support/azure/virtual-machines/linux/troubleshoot-ssh-connection.md b/support/azure/virtual-machines/linux/troubleshoot-ssh-connection.md
@@ -19,6 +19,8 @@ ms.author: jarrettr
 
 **Applies to:** :heavy_check_mark: Linux VMs
 
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 This article helps you find and correct the problems that occur due to Secure Shell (SSH) errors, SSH connection failures, or SSH is refused when you try to connect to a Linux virtual machine (VM). You can use the Azure portal, Azure CLI, or VM Access Extension for Linux to troubleshoot and resolve connection problems.
 
 [!INCLUDE [Feedback](../../../includes/feedback.md)]
diff --git a/support/azure/virtual-machines/linux/troubleshoot-ssh-permissions-too-open.md b/support/azure/virtual-machines/linux/troubleshoot-ssh-permissions-too-open.md
@@ -18,6 +18,8 @@ ms.author: jarrettr
 
 **Applies to:** :heavy_check_mark: Linux VMs
 
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 ## Symptoms
 
 You can't connect to your Microsoft Azure Linux virtual machine (VM) by using Secure Shell (SSH). You notice the following entries in the system log (/var/log/messages, /var/log/syslog, /var/log/secure, or /var/log/auth.log):
diff --git a/support/azure/virtual-machines/windows/debug-customscriptextension-runcommand-scripts.md b/support/azure/virtual-machines/windows/debug-customscriptextension-runcommand-scripts.md
@@ -14,6 +14,9 @@ ms.custom: sap:VM Admin - Windows (Guest OS), devx-track-azurepowershell
 
 This article discusses how to test and correct for a failure in a PowerShell script that uses the Custom Script Extension or Run Command feature.
 
+
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 ## Prerequisites
 
 - [Azure PowerShell](/powershell/azure/install-az-ps)
diff --git a/support/azure/virtual-machines/windows/extension-supported-os.md b/support/azure/virtual-machines/windows/extension-supported-os.md
@@ -12,6 +12,9 @@ ms.custom: sap:VM Extensions not operating correctly
 
 _Original KB number:_ &nbsp; 4078134
 
+
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 VM Extensions enable post-deployment configuration of VM, such as installing and configuring software. VM extensions also enable recovery features such as resetting the administrative password of a VM. Without the Azure VM Agent, VM extensions cannot be run.
 
 * The Windows VM Agent needs at least Windows Server 2008 SP2 (64-bit) to run, with the .NET Framework 4.0.
diff --git a/support/azure/virtual-machines/windows/install-vm-agent-offline.md b/support/azure/virtual-machines/windows/install-vm-agent-offline.md
@@ -17,6 +17,8 @@ ms.reviewer: kageorge, v-weizhu
 
 **Applies to:** :heavy_check_mark: Windows VMs
 
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 The Azure Virtual Machine Agent (VM Agent) provides useful features, such as local administrator password reset and script pushing. This article shows you how to install the VM Agent for an offline Windows virtual machine (VM).
 
 ## When to use the VM Agent in offline mode
diff --git a/support/azure/virtual-machines/windows/multiple-certificates-iaas-vm-extensions.md b/support/azure/virtual-machines/windows/multiple-certificates-iaas-vm-extensions.md
@@ -11,6 +11,9 @@ ms.custom: sap:VM Extensions not operating correctly
 
 **Applies to:** :heavy_check_mark: Linux VMs :heavy_check_mark: Windows VMs
 
+
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 This article discusses how to handle an issue in which multiple certificates are generated on a Microsoft Azure infrastructure as a service (IaaS) virtual machine (VM) that uses extensions.
 
 ## Symptoms
diff --git a/support/azure/virtual-machines/windows/must-change-password.md b/support/azure/virtual-machines/windows/must-change-password.md
@@ -21,6 +21,8 @@ ms.custom: sap:Cannot connect to my VM
 
 **Applies to:** :heavy_check_mark: Windows VMs
 
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 ## Symptom
 
 When you use a Remote Desktop Protocol (RDP) connection to connect to an Azure virtual machine (VM), you encounter the error:
diff --git a/support/azure/virtual-machines/windows/reset-rdp.md b/support/azure/virtual-machines/windows/reset-rdp.md
@@ -22,6 +22,8 @@ ms.reviewer: herensin, v-monicaba
 
 [!INCLUDE [Feedback](../../../includes/feedback.md)]
 
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 > [!NOTE]
 > The steps in this article don't apply to Windows domain controllers.
 
diff --git a/support/azure/virtual-machines/windows/slow-vm-start-extensions-troubleshooting.md b/support/azure/virtual-machines/windows/slow-vm-start-extensions-troubleshooting.md
@@ -9,6 +9,9 @@ ms.custom: sap:Cannot start or stop my VM
 ---
 # Slow Azure VM Start operations when extensions are "Failed"
 
+
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 ## Overview
 
 You might experience slow Microsoft Azure Virtual Machine (VM) **Start** or **Redeploy** operations when one or more of the VM extensions are in a **Failed** state. This article discusses possible causes of this issue and resolutions.
diff --git a/support/azure/virtual-machines/windows/support-agent-extensions.md b/support/azure/virtual-machines/windows/support-agent-extensions.md
@@ -12,6 +12,8 @@ ms.custom: sap:VM Extensions not operating correctly
 
 _Original KB number:_ &nbsp; 2965986
 
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 This article discusses support policy for the VM agent for Microsoft Azure Virtual Machines and for VM agent extensions on infrastructure as a service (IaaS) for Microsoft Azure.
 
 Microsoft Support for VM agent extensions is limited to first-party extensions that are developed and published directly by Microsoft.
diff --git a/support/azure/virtual-machines/windows/support-extensions-agent-version.md b/support/azure/virtual-machines/windows/support-extensions-agent-version.md
@@ -12,6 +12,8 @@ ms.custom: sap:VM Extensions not operating correctly, linux-related-content
 
 _Original KB number:_ &nbsp; 4049215
 
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 This article describes the minimum version support for Linux and Windows virtual machine agents in Azure.
 
 ## Minimum supported version of Linux VM Agent
diff --git a/support/azure/virtual-machines/windows/troubleshoot-extension-certificates-issues-windows-vm.md b/support/azure/virtual-machines/windows/troubleshoot-extension-certificates-issues-windows-vm.md
@@ -11,6 +11,8 @@ ms.custom: sap:VM Extensions not operating correctly
 
 **Applies to:** :heavy_check_mark: Windows VMs
 
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 This article discusses how to identify and fix issues that involve certificates on a Windows virtual machine (VM) that uses an extension. Usually, these issues are related to cryptographic operations or the certificate itself.
 
 ## Troubleshooting checklist
diff --git a/support/azure/virtual-machines/windows/windows-azure-guest-agent.md b/support/azure/virtual-machines/windows/windows-azure-guest-agent.md
@@ -19,6 +19,8 @@ ms.custom: sap:VM Extensions not operating correctly
 
 [!INCLUDE [Feedback](../../../includes/feedback.md)]
 
+[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
+
 Azure VM Agent is a virtual machine (VM) agent. It enables the VM to communicate with the Fabric Controller (the underlying physical server on which the VM is hosted) on IP address `168.63.129.16`. This address is a virtual public IP address that facilitates communication. For more information, see [What is IP address 168.63.129.16?](/azure/virtual-network/what-is-ip-address-168-63-129-16).
 
 The VM that's migrated to Azure from an on-premises environment or created by using a customized image doesn't have Azure VM Agent installed. In these scenarios, you have to manually install VM Agent. For more information about how to install the VM Agent, see [Azure Virtual Machine Agent overview](/azure/virtual-machines/extensions/agent-windows).
diff --git a/support/includes/vmassist-include.md b/support/includes/vmassist-include.md
@@ -0,0 +1,3 @@
+> [!NOTE]
+> ### New! Try VM assist for Faster Diagnostics
+> We recommend that you run [VM assist for Windows](https://github.com/Azure/azure-support-scripts/blob/master/vmassist/windows) or [VM assist for Linux](https://github.com/Azure/azure-support-scripts/blob/master/vmassist/linux). These script-based diagnostic tools help you to identify common issues that affect the Azure VM Guest Agent and overall VM health.
