Refreshed, reflowed, converted to link refs

Author: mikefrobbins

docs-ref-conceptual/Latest-version/azure-cli-vm-tutorial-1.md

@@ -1,7 +1,6 @@
 ---
-title: Create virtual machine (VM) on a virtual network (VNet) prerequisites – Azure CLI | Microsoft Docs
+title: Create virtual machine (VM) on a virtual network (VNet) prerequisites
 description: Prerequisites for creating a virtual machines (VM) on a virtual network (VNet) with the Azure CLI.
-ms.date: 09/19/2024
 ms.topic: tutorial
 ms.service: azure-cli
 ms.custom: devx-track-azurecli
@@ -10,24 +9,31 @@ keywords: azure cli create vm, virtual machine in azure cli, shell variables
 
 # Overview and Prerequisites
 
-In this tutorial, you learn how to create a virtual network (VNet) and deploy a virtual machine (VM) to the VNet with the Azure CLI. This tutorial
-also covers Azure CLI specific concepts such as shell variables and output queries.
+In this tutorial, you learn how to create a virtual network (VNet) and deploy a virtual machine (VM)
+to the VNet with the Azure CLI. This tutorial also covers Azure CLI specific concepts such as shell
+variables and output queries.
 
-This tutorial can be completed with the interactive experience offered through Azure Cloud Shell, or you may [install the CLI](install-azure-cli.md)
-locally.
+This tutorial can be completed with the interactive experience offered through Azure Cloud Shell, or
+you may [install the CLI][04] locally.
 
-Use __ctrl-shift-v__ (__cmd-shift-v__ on macOS) to paste tutorial text into Azure Cloud Shell.
+Use <kbd>ctrl</kbd>+<kbd>shift</kbd>+<kbd>v</kbd> (<kbd>cmd</kbd>+<kbd>shift</kbd>+<kbd>v</kbd> on
+macOS) to paste tutorial text into Azure Cloud Shell.
 
 [!INCLUDE [include](~/articles/reusable-content/azure-cli/azure-cli-prepare-your-environment.md)]
 
 ## Shell variables
 
-Shell variables store values for future use and can be used to pass values to command parameters. Shell variables allow for the reuse of commands, both on their own and in scripts. This tutorial uses shell variables for easier customization of command parameters. To use your own parameter values instead of using the provided values, change the values assigned to the shell variables. For more information about shell variables, see [Use shell variables](./azure-cli-variables.md#use-shell-variables).
+Shell variables store values for future use and can be used to pass values to command parameters.
+Shell variables allow for the reuse of commands, both on their own and in scripts. This tutorial
+uses shell variables for easier customization of command parameters. To use your own parameter
+values instead of using the provided values, change the values assigned to the shell variables. For
+more information about shell variables, see [Use shell variables][01].
 
 ## Create a resource group
 
-In Azure, all resources are allocated in a resource management group. Resource groups provide logical groupings of resources
-that make them easier to work with as a collection. Use the [az group create](/cli/azure/group#az_group_create) command to create a resource group named `VMTutorialResources`.
+In Azure, all resources are allocated in a resource management group. Resource groups provide
+logical groupings of resources that make them easier to work with as a collection. Use the
+[az group create][03] command to create a resource group named `VMTutorialResources`.
 
 # [Bash](#tab/bash)
 
@@ -49,22 +55,33 @@ $location = "eastus"
 az group create --name $resourceGroup --location $location
 ```
 
-***
+---
 
 ## Create a resource group in interactive mode
 
-Interactive mode offers new AI functionalities that allow the user to run and search for commands more efficiently. To get a better understanding of required parameters and steps related to `az group create`, try out Azure CLI in interactive mode by running the `az interactive` command. Please note that all commands throughout this tutorial can be run in interactive mode.
+Interactive mode offers new AI functionalities that allow the user to run and search for commands
+more efficiently. To get a better understanding of required parameters and steps related to
+`az group create`, try out Azure CLI in interactive mode by running the `az interactive` command.
+Please note that all commands throughout this tutorial can be run in interactive mode.
 
 ```azurecli
 # install interactive mode
 az interactive
 ```
 
-In the following example, the command recommendation feature in interactive mode lists and defines all of the required parameters needed for `az group create`:
+In the following example, the command recommendation feature in interactive mode lists and defines
+all of the required parameters needed for `az group create`:
 
 ```azurecli
 # get options for az group create
 az>> az group create
 ```
 
-![Azure Interactive Hint](./media/az-interactive-vm-tutorial-hint.png)
+![Azure Interactive Hint][02]
+
+<!-- link references -->
+
+[01]: ./azure-cli-variables.md#use-shell-variables
+[02]: ./media/az-interactive-vm-tutorial-hint.png
+[03]: /cli/azure/group#az_group_create
+[04]: install-azure-cli.md