sasaas

Author: ScottAzure

support/azure/virtual-machines/linux/linux-azure-guest-agent-tools-vmassist.md

@@ -13,16 +13,11 @@ ms.custom: sap:zzzz
 
 **Applies to:** :heavy_check_mark: Linux VMs
 
-The Microsoft Azure Linux VM Agent is a secure, lightweight process that manages virtual machine (VM) interaction with the Azure fabric controller. The Azure Linux VM Agent has a primary role in enabling and executing Azure virtual machine extensions. VM extensions enable post-deployment configuration of VMs, such as installing and configuring software. VM extensions also enable recovery features such as resetting the administrative password of a VM. Without the Azure Linux VM Agent, you can't run VM extensions.
-
-[Add Link]()
-
+## Overview
 
-## Tool overview
-
-### VM assist
+The Microsoft Azure Linux VM Agent is a secure, lightweight process that manages virtual machine (VM) interaction with the Azure fabric controller. The Azure Linux VM Agent has a primary role in enabling and executing Azure virtual machine extensions. VM extensions enable post-deployment configuration of VMs, such as installing and configuring software. VM extensions also enable recovery features such as resetting the administrative password of a VM. Without the Azure Linux VM Agent, you can't run VM extensions.
 
-#### Purpose  
+## Purpose  
 The Linux version of VM assist is comprised of bash and Python scripts used to detect potential issues with the Guest Agent in a Linux VM in addition to other issues related to the general health of the VM. Output is intended to be viewed in the serial console and provide pointers to solve well-known issues, as well as certain deviations from best practice which can affect VM availability. The intention is for engineers to provide this script to customers via GitHub, but it is possible and acceptable that a customer uses the script on their own and provides data through an SR.
 
 Given that the output of this script is designed to be viewed in a worst-case scenario of the Azure serial console, the information displayed is minimal and condensed, with detail provided through online resources accessed via an link provided in that output - [VM assist for Linux](https://aka.ms/vmassistlinux)
@@ -31,8 +26,10 @@ VM assist is delivered in two functional scripts - one in bash and one in python
 
 The bash script will perform some basic checks and determine if running the Python script is possible and/or necessary.
 
-#### Key features
-##### Bash checks
+## Key features
+
+### Bash checks
+
 The following checks are run in bash today:
 
 - OS family detection
@@ -43,7 +40,8 @@ The following checks are run in bash today:
 
 > If the bash script finds a python2 system the script will exit and display the information it has gathered.
 
-##### Python analysis
+### Python analysis
+
 If there are no issues uncovered during the base checks using bash, the Python script is called to perform a deeper analysis:
 
 - Find the source (package) for the Guest Agent executable and the Python passed from bash
@@ -55,7 +53,8 @@ If there are no issues uncovered during the base checks using bash, the Python s
 - Basic system configuration and status checks (#Guest best practices)
 
 
-#### Prerequisites
+## Prerequisites
+
 - VM needs to be booting to the full OS, i.e. not emergency or maintenance mode.
 - root-level access either through sudo or direct login/sudo -i
 
@@ -71,7 +70,6 @@ If you open a support request, please include both of the above files to aid you
 - Ubuntu 24.04 has a differing architecture of the SSH service, and may flag the service even though it is operating fine.
 
 
-
 [!INCLUDE [azure-help-support](~/includes/azure-help-support.md)]
 
 [!INCLUDE [Third-party contact disclaimer](~/includes/third-party-contact-disclaimer.md)]

support/azure/virtual-machines/windows/windows-azure-guest-agent-tools-vmassist.md

@@ -13,24 +13,19 @@ ms.custom: sap:zzzz
 
 **Applies to:** :heavy_check_mark: Windows VMs
 
-The Microsoft Azure Windows VM Agent is a secure, lightweight process that manages virtual machine (VM) interaction with the Azure fabric controller. The Azure Windows VM Agent has a primary role in enabling and executing Azure virtual machine extensions. VM extensions enable post-deployment configuration of VMs, such as installing and configuring software. VM extensions also enable recovery features such as resetting the administrative password of a VM. Without the Azure Windows VM Agent, you can't run VM extensions.
-
-[Add Link]()
-
+## Overview
 
-## Tool overview
-
-### VM assist
+The Microsoft Azure Windows VM Agent is a secure, lightweight process that manages virtual machine (VM) interaction with the Azure fabric controller. The Azure Windows VM Agent has a primary role in enabling and executing Azure virtual machine extensions. VM extensions enable post-deployment configuration of VMs, such as installing and configuring software. VM extensions also enable recovery features such as resetting the administrative password of a VM. Without the Azure Windows VM Agent, you can't run VM extensions.
 
-#### Purpose  
+## Purpose  
 VM assist (Windows version) is a PowerShell script intended to be used to diagnose issues with the Azure Windows VM Guest Agent in addition to other issues related to the general health of the VM. This includes various information about the system such as firewall rules, running services, running drivers, installed software, NIC settings, and installed software, and installed Windows Updates.
 
 Output of the checks can be viewed in the PowerShell window the script is ran in. Additionally running VM assist generates a detailed .htm report showing the results of each check it performs and suggests mitigations for issues it finds.
 
-#### Key features
+## Key features
 Output of the checks can be viewed in the PowerShell window the script is ran in. Additionally running VM assist generates a detailed .htm report showing the results of each check it performs and suggests mitigations for issues it finds.
 
-#### Prerequisites
+## Prerequisites
 * Windows Server 2012 R2 and later versions of Windows
 * Windows 11 or later versions of the client
 * Windows Powershell 4.0+ and PowerShell 6.0+
@@ -39,7 +34,7 @@ Output of the checks can be viewed in the PowerShell window the script is ran in
 
 You can run the tool in any of the following manners.
 
-### 1. Download from GitHub and run within the VM 
+### Option 1: Download from GitHub and run within the VM 
 
 Download the scripts from GitHub, and then run them manually. To access the scripts, follow the resource links in the previous sections.
 Please see the GitHub page to see the latest instruction for how a you can [install VM assist](https://github.com//azure/azure-support-scripts/blob/master/vmassist/windows/README.md).
@@ -54,7 +49,7 @@ Or you can specify the full URL instead of the aka.ms short link -
 ```powershell
 (Invoke-WebRequest -Uri https://raw.githubusercontent.com//azure/azure-support-scripts/master/vmassist/windows/vmassist.ps1 -OutFile vmassist.ps1) | .\vmassist.ps1
 ```
-## Manual download and run
+### Option 2: Manual download and run
 Download:
 ```powershell
 [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
@@ -72,7 +67,8 @@ Set-ExecutionPolicy Bypass -Force
 .\vmassist.ps1
 ```
 
-## Download from browser
+### Option 3: Download from browser
+
  1. Download the file ```vmassist.ps1``` [from a web browser.](https://github.com//azure/azure-support-scripts/blob/master/vmassist/windows/vmassist.ps1)
  1. From an elevated PowerShell window, ensure you're in the same directory that you downloaded the script to, then run the following to run the script:
  ```powershell