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

Author: Learn Build Service GitHub App

AKS-Hybrid/media/aks-edge/akri-opc-plc-fqdn.png

@@ -8,7 +8,7 @@ ms.service: azure-stack
 ms.subservice: azure-stack-hci
 ms.custom:
   - devx-track-azurecli
-ms.date: 08/19/2024
+ms.date: 09/25/2024
 ---
 
 # Create Azure Stack HCI VM image using Azure Marketplace images
@@ -53,9 +53,9 @@ Follow these steps to create a VM image using the Azure CLI.
     ```azurecli
     $subscription = "<Subscription ID>"
     $resource_group = "<Resource group>"
+    $mktplaceImage = "<Marketplace image name>"
     $customLocationName = "<Custom location name>"
-    $customLocationID
-    /subscriptions/<Subscription ID>/resourcegroups/$resource_group/providers/microsoft.extendedlocation/customlocations/$customLocationName
+    $customLocationID = (az customlocation show --resource-group $resource_group --name "<custom_location_name_for_Azure_Stack_HCI_cluster>" --query id -o tsv)
     $location = "<Location for your Azure Stack HCI cluster>"
     $osType = "<OS of source image>"
     ```
@@ -65,7 +65,9 @@ Follow these steps to create a VM image using the Azure CLI.
     | Parameter      | Description                                                                                |
     |----------------|--------------------------------------------------------------------------------------------|
     | `subscription`   | Subscription associated with your Azure Stack HCI cluster.        |
-    | `resource-group` | Resource group for Azure Stack HCI cluster that you associate with this image.        |
+    | `resource-group` | Resource group for Azure Stack HCI cluster that you associate with this image.     |
+    | `name` | Name of the marketplace image for Azure Stack HCI cluster.  |
+    | `customLocation` | Resource ID of custom location for Azure Stack HCI cluster.   |
     | `location`       | Location for your Azure Stack HCI cluster. For example, this could be `eastus`. |
     | `os-type`         | Operating system associated with the source image. This can be Windows or Linux.           |
 
@@ -74,20 +76,24 @@ Follow these steps to create a VM image using the Azure CLI.
     ```
     PS C:\Users\azcli> $subscription = "<Subscription ID>"
     PS C:\Users\azcli> $resource_group = "myhci-rg"
+    PS C:\Users\azcli> $mktplaceImage= "myhci-marketplaceimage"
     PS C:\Users\azcli> $customLocationName = "myhci-cl"
+    PS C:\Users\azcli> $customerLocationID /subscriptions$subscription/resourcegroups/$resource_group/providers/microsoft.extendedlocation/customlocations/$customLocationName
     PS C:\Users\azcli> $location = "eastus"
     PS C:\Users\azcli> $ostype = "Windows"
     ```
 
 ### Create VM image from marketplace image
 
-1. Select a custom location to deploy your VM image. The custom location should correspond to the custom location for your Azure Stack HCI cluster. Get the custom location ID for your Azure Stack HCI cluster. Run the following command:
+1. Set additional parameters that specify the intended VM image you would like to create. You will need to include the offer, publisher, SKU, and version for the marketplace image. Replace the parameters in \< \> with the appropriate values:
 
     ```azurecli
-    $customLocationID=(az customlocation show --resource-group $resource_group --name "<custom_location_name_for_Azure_Stack_HCI_cluster>" --query id -o tsv)
+    $publisher = "<Publisher name>"
+    $offer = "<OS offer>"
+    $sku = "<Image SKU>"
     ```
 
-1. Create the VM image starting with a specified marketplace image. Make sure to specify the offer, publisher, SKU, and version for the marketplace image. Use the following table to find the available marketplace images and their attribute values:
+    Use the following table to find the available marketplace images and their attribute values:
 
     | Name | Publisher | Offer | SKU |
     |------|-----------|-------|------|
@@ -103,81 +109,86 @@ Follow these steps to create a VM image using the Azure CLI.
     | Windows Server 2019 | microsoftwindowsserver | windowsserver | 2019-datacenter-gensecond<br>2019-datacenter-core-g2 |
     | SQL Server 2022 Enterprise on Windows Server 2022 | microsoftsqlserver | sql2022-ws2022 | enterprise-gen2<br>standard-gen2 |
 
+    If you wanted to create a Windows Server 2019 Datacenter image, you would have the following parameters: 
+
 
     ```azurecli
-    az stack-hci-vm image create --subscription $subscription --resource-group $resource_group --custom-location $customLocationID --location $location --name "<VM_image_name>" --os-type $ostype --offer "windowsserver" --publisher "<publisher_name>" --sku "<SKU>" 
+    $publisher = "microsoftwindowsserver" 
+    $offer = "windowsserver" 
+    $sku = "2019-datacenter-gensecond"
     ```
 
-    A deployment job starts for the VM image.
-
-    In this example, the storage path was specified using the `--storage-path-id` flag and that ensured that the workload data (including the VM, VM image, non-OS data disk) is placed in the specified storage path.
-
-    If the flag is not specified, the workload data is automatically placed in a high availability storage path.
+1. Create the VM image starting with a specified marketplace image:
 
-The image deployment takes a few minutes to complete. The time taken to download the image depends on the size of the Marketplace image and the network bandwidth available for the download.
+    ```azurecli
+    az stack-hci-vm image create --resource-group $resource_group --custom-location $customLocationID --name $mktplaceImage --os-type $ostype --offer $offer --publisher $publisher --sku $sku 
+    ```
 
 Here's a sample output:
 
 ```
-PS C:\Users\azcli> $customLocationID=(az customlocation show --resource-group $resource_group --name "myhci-cl" --query id -o tsv)
-PS C:\Users\azcli> $customLocationID
-/subscriptions/<Subscription ID>/resourcegroups/myhci-rg/providers/microsoft.extendedlocation/customlocations/myhci-cl
-PS C:\Users\azcli> az stack-hci-vm image create --subscription $subscription --resource-group $resource_group --custom-location $customLocationID --location $location --name "myhci-marketplaceimage" --os-type $ostype --offer "windowsserver" --publisher "microsoftwindowsserver" --sku "2022-datacenter-azure-edition-core" --version "20348.2031.231006" --storage-path-id $storagepathid
-{
-  "extendedLocation": {
-    "name": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.ExtendedLocation/customLocations/myhci-cl",
-    "type": "CustomLocation"
-  },
-  "id": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/marketplacegalleryimages/myhci-marketplaceimage",
-  "location": "eastus",
-  "name": "myhci-marketplaceimage",
-  "properties": {
-    "identifier": {
-      "offer": "windowsserver",
-      "publisher": "microsoftwindowsserver",
-      "sku": "2022-datacenter-azure-edition-core"
-    },
-    "imagePath": null,
-    "osType": "Windows",
-    "provisioningState": "Succeeded",
-    "status": {
-      "downloadStatus": {
-        "downloadSizeInMB": 6750
-      },
-      "progressPercentage": 98,
-      "provisioningStatus": {
-        "operationId": "13be90e0-a780-45bf-a84a-ae91b6e5e468*A380D53083FF6B0A3A157ED7DFD00D33F6B3D40D5559D11AEAED6AD68F7F1A4A",
-        "status": "Succeeded"
-      }
-    },
-    "storagepathId": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/storagecontainers/myhci-storagepath",
-    "version": {
-      "name": "20348.2031.231006",
-      "properties": {
-        "storageProfile": {
-          "osDiskImage": {
-            "sizeInMB": 130050
-          }
-        }
-      }
-    }
-  },
-  "resourceGroup": "myhci-rg",
-  "systemData": {
-    "createdAt": "2023-10-27T21:43:15.920502+00:00",
-    "createdBy": "[email protected]",
-    "createdByType": "User",
-    "lastModifiedAt": "2023-10-27T22:06:15.092321+00:00",
-    "lastModifiedBy": "319f651f-7ddb-4fc6-9857-7aef9250bd05",
-    "lastModifiedByType": "Application"
-  },
-  "tags": null,
-  "type": "microsoft.azurestackhci/marketplacegalleryimages"
-}
-
-PS C:\Users\azcli>
+PS C:\Users\azcli> az stack-hci-vm image create --custom-location $cl --name $mktplaceImage --os-type $ostype --resource-group $rg --publisher $publisher --offer $offer --sku $sku 
+{ 
+  "extendedLocation": { 
+    "name": “/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.ExtendedLocation/customLocations/myhci-cl", 
+    "type": "CustomLocation" 
+  }, 
+  "id": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/marketplacegalleryimages/myhci-marketplaceimage", 
+\ 
+  "location": "eastus", 
+  "name": "myhci-marketplaceimage", 
+  "properties": { 
+    "cloudInitDataSource": null, 
+    "containerId": null, 
+    "hyperVGeneration": null, 
+    "identifier": { 
+      "offer": "windowsserver", 
+      "publisher": "microsoftwindowsserver", 
+      "sku": "2019-datacenter-gensecond" 
+    }, 
+    "osType": "Windows", 
+    "provisioningState": "Succeeded", 
+    "status": { 
+      "downloadStatus": { 
+        "downloadSizeInMb": 10832 
+      }, 
+      "errorCode": "", 
+      "errorMessage": "", 
+      "progressPercentage": 100, 
+      "provisioningStatus": { 
+        "operationId": "13efc468-7473-429f-911b-858c1e6fc1d5*B11A62EE76B08EF194F8293CDD40F7BC71BFB93255D5A99DD11B4167690752D9", 
+        "status": "Succeeded" 
+      } 
+    }, 
+    "version": { 
+      "name": "17763.6293.240905", 
+      "properties": { 
+        "storageProfile": { 
+          "osDiskImage": { 
+            "sizeInMb": 130050 
+          } 
+        } 
+      } 
+
+    } 
+  }, 
+  "resourceGroup": "myhci-rg", 
+  "systemData": { 
+    "createdAt": "2024-09-23T18:53:13.734389+00:00", 
+    "createdBy": "[email protected]", 
+    "createdByType": "User", 
+    "lastModifiedAt": "2024-09-23T19:06:07.532276+00:00", 
+    "lastModifiedBy": "319f651f-7ddb-4fc6-9857-7aef9250bd05", 
+    "lastModifiedByType": "Application" 
+  }, 
+
+  "tags": null, 
+  "type": "microsoft.azurestackhci/marketplacegalleryimages" 
+} 
 ```
 
+For more information on this CLI command, see [az stack-hci-vm image](/cli/azure/stack-hci-vm/image).
+
 # [Azure portal](#tab/azureportal)
 
 Follow these steps to create a VM image using the Azure portal. In the Azure portal of your Azure Stack HCI cluster resource, take the following steps:

AKS-Hybrid/media/aks-networks/review-and-create-static.png

@@ -5,16 +5,16 @@ ms.service: azure-stack
 ms.subservice: azure-stack-hci
 ms.custom: devx-track-azurecli
 ms.topic: include
-ms.date: 11/06/2023
+ms.date: 09/24/2024
 ---
 
 1. Run PowerShell as an administrator.
-1. Set the following parameters.
+1. Set the following parameters:
 
     ```azurecli
     $subscription = "<Subscription ID>"
     $resource_group = "<Cluster resource group>"
-    $galleryImageName = "<Gallery image name>"    
+    $mktplaceImage = "<Markeplace image name>"    
     ```
 
 1. Remove an existing VM image. Run the following command:

azure-stack/hci/manage/virtual-machine-image-azure-marketplace.md

@@ -5,7 +5,7 @@ ms.service: azure-stack
 ms.subservice: azure-stack-hci
 ms.custom: devx-track-azurecli
 ms.topic: include
-ms.date: 11/06/2023
+ms.date: 09/24/2024
 ---
 
 Follow these steps to list VM image using Azure CLI.
@@ -93,4 +93,6 @@ inServer2022Az-01",
   }
 ]
 PS C:\Users\azcli>
-```
+```
+
+For more information on this CLI command, see [az stack-hci-vm image list](/cli/azure/stack-hci-vm/image#az-stack-hci-vm-image-list).