Merge pull request #269398 from rayoef/update-linux-vm-exec-doc

Added context that was removed in previous update

Author: prmerger-automator[bot]

articles/virtual-machines/linux/quick-create-cli.md

@@ -1,23 +1,37 @@
 ---
 title: 'Quickstart: Use the Azure CLI to create a Linux Virtual Machine'
-description: Create a Linux virtual machine using the Azure CLI.
+description: In this quickstart, you learn how to use the Azure CLI to create a Linux virtual machine
 author: chasecrum
 ms.service: virtual-machines
 ms.collection: linux
 ms.topic: quickstart
 ms.date: 02/28/2024
-ms.author: chasecrum
+ms.author: jushiman
 ms.reviewer: jushiman
 ms.custom: mvc, devx-track-azurecli, mode-api, innovation-engine, linux-related-content
 ---
 
-# Create a Linux virtual machine on Azure
+# Quickstart: Create a Linux virtual machine with the Azure CLI on Azure
+
+**Applies to:** :heavy_check_mark: Linux VMs
 
 [![Deploy to Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/?Microsoft_Azure_CloudNative_clientoptimizations=false&feature.canmodifyextensions=true#view/Microsoft_Azure_CloudNative/SubscriptionSelectionPage.ReactView/tutorialKey/CreateLinuxVMAndSSH)
 
+This quickstart shows you how to use the Azure CLI to deploy a Linux virtual machine (VM) in Azure. The Azure CLI is used to create and manage Azure resources via either the command line or scripts.
+
+If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
+
+## Launch Azure Cloud Shell
+
+The Azure Cloud Shell is a free interactive shell that you can use to run the steps in this article. It has common Azure tools preinstalled and configured to use with your account. 
+
+To open the Cloud Shell, just select **Try it** from the upper right corner of a code block. You can also open Cloud Shell in a separate browser tab by going to [https://shell.azure.com/bash](https://shell.azure.com/bash). Select **Copy** to copy the blocks of code, paste it into the Cloud Shell, and select **Enter** to run it.
+
+If you prefer to install and use the CLI locally, this quickstart requires Azure CLI version 2.0.30 or later. Run `az --version` to find the version. If you need to install or upgrade, see [Install Azure CLI]( /cli/azure/install-azure-cli).
+
 ## Define environment variables
 
-The First step is to define the environment variables.
+The first step is to define the environment variables. Environment variables are commonly used in Linux to centralize configuration data to improve consistency and maintainability of the system. Create the following environment variables to specify the names of resources that you create later in this tutorial:
 
 ```bash
 export RANDOM_ID="$(openssl rand -hex 3)"
@@ -30,11 +44,11 @@ export MY_VM_IMAGE="Canonical:0001-com-ubuntu-minimal-jammy:minimal-22_04-lts-ge
 
 ## Log in to Azure using the CLI
 
-In order to run commands in Azure using the CLI, you need to log in first. This is done using the `az login` command.
+In order to run commands in Azure using the CLI, you need to log in first. Log in using the `az login` command.
 
 ## Create a resource group
 
-A resource group is a container for related resources. All resources must be placed in a resource group. The following command creates a resource group with the previously defined $MY_RESOURCE_GROUP_NAME and $REGION parameters.
+A resource group is a container for related resources. All resources must be placed in a resource group. The [az group create](/cli/azure/group) command creates a resource group with the previously defined $MY_RESOURCE_GROUP_NAME and $REGION parameters.
 
 ```bash
 az group create --name $MY_RESOURCE_GROUP_NAME --location $REGION
@@ -59,7 +73,9 @@ Results:
 
 ## Create the virtual machine
 
-To create a VM in this resource group, we need to use the `vm create` command. In the following code example, we provided the `--generate-ssh-keys` flag, which causes the CLI to look for an available ssh key in `~/.ssh`. If one is found, it is used. If not, one is generated and stored in `~/.ssh`. We also provide the `--public-ip-sku Standard` flag to ensure that the machine is accessible via a public IP address. Finally, we deploy the latest `Ubuntu 22.04` image.
+To create a VM in this resource group, use the `vm create` command. 
+
+The following example creates a VM and adds a user account. The `--generate-ssh-keys` parameter causes the CLI to look for an available ssh key in `~/.ssh`. If one is found, that key is used. If not, one is generated and stored in `~/.ssh`. The `--public-ip-sku Standard` parameter ensures that the machine is accessible via a public IP address. Finally, we deploy the latest `Ubuntu 22.04` image.
 
 All other values are configured using environment variables.
 
@@ -74,7 +90,7 @@ az vm create \
     --public-ip-sku Standard
 ```
 
-Results:
+It takes a few minutes to create the VM and supporting resources. The following example output shows the VM create operation was successful.
 
 <!-- expected_similarity=0.3 -->
 ```json
@@ -105,7 +121,7 @@ az vm extension set \
 
 ## Store IP address of VM in order to SSH
 
-Run the following command to store the IP Address of the VM as an environment variable:
+Run the following command to store the IP address of the VM as an environment variable:
 
 ```bash
 export IP_ADDRESS=$(az vm show --show-details --resource-group $MY_RESOURCE_GROUP_NAME --name $MY_VM_NAME --query publicIps --output tsv)