Gérer des images de machine virtuelle locale Azure via l’interface CLI ou le portail

S’applique à : déploiements hyperconvergés d’Azure Local

Cet article explique comment gérer des images de machine virtuelle sur votre instance locale Azure. Vous pouvez créer des images de machine virtuelle à partir de différentes sources telles que la Place de marché Azure, azure Compute Gallery, les comptes de stockage Azure ou les partages locaux. Après avoir créé des images, vous pouvez répertorier, afficher des propriétés et les supprimer à l’aide d’Azure CLI ou du portail Azure.

Prerequisites

Avant de commencer, assurez-vous d’avoir :

Vérifiez que vous avez accès à une image de machine virtuelle locale Azure. Pour plus d’informations, consultez : Créer une image de machine virtuelle locale Azure via la Place de marché Azure OU via Azure Compute Gallery OU via un compte de stockage Azure OU via un partage local.

Liste des images de machine virtuelle

Pour identifier les images de votre instance locale Azure disponibles pour la gestion des machines virtuelles, vous pouvez afficher la liste complète des images de machine virtuelle.

Azure CLI
portail Azure

Pour répertorier l’image de machine virtuelle à l’aide d’Azure CLI, procédez comme suit :

Exécutez PowerShell en tant qu’administrateur.

Définissez certains paramètres. Par exemple, abonnement et groupe de ressources :

$subscription = "<Subscription ID associated with your Azure Local>"
$resource_group = "<Resource group name for your Azure Local>"

Répertoriez toutes les images de machine virtuelle associées à votre local Azure. Exécutez la commande suivante:
```
az stack-hci-vm image list --subscription $subscription --resource-group $resource_group
```

La commande retourne différents ensembles d’images en fonction des paramètres que vous spécifiez :

Abonnement uniquement : répertorie toutes les images de l’abonnement
Abonnement et groupe de ressources : répertorie toutes les images du groupe de ressources spécifique

Les résultats incluent des images de machines virtuelles provenant de :

Images de machines virtuelles à partir des images marketplace.
Images personnalisées qui résident dans :
- Votre compte stockage Azure
- Un partage local sur votre système
- Un client connecté à votre système

Voici un exemple de résultat :

PS C:\Users\azcli> az stack-hci-vm image list --subscription "<Subscription ID>" --resource-group "<Resource group>"
Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
[
  {
    "extendedLocation": {
      "name": "/subscriptions/<subscription ID>/resourcegroups/<resource group>/providers/microsoft.extendedlocation/customlocations/<custom location>",
      "type": "CustomLocation"
    },
    "id": "/subscriptions/<subscription ID>/resourceGroups/<resource group>/providers/microsoft.azurestackhci/marketplacegalleryimages/w
inServer2022Az-01",
    "location": "eastus",
    "name": "winServer2022Az-01",
    "properties": {
      "hyperVGeneration": "V2",
      "identifier": {
        "offer": "windowsserver",
        "publisher": "microsoftwindowsserver",
        "sku": "2022-datacenter-azure-edition-core"
      },
      "imagePath": null,
      "osType": "Windows",
      "provisioningState": "Succeeded",
      "status": {
        "downloadStatus": {
          "downloadSizeInMB": 6710
        },
        "progressPercentage": 100,
        "provisioningStatus": {
          "operationId": "<operation ID>",
          "status": "Succeeded"
        }
      },
      "storagepathId": null,
      "version": {
        "name": "20348.2031.231006",
        "properties": {
          "storageProfile": {
            "osDiskImage": {
              "sizeInMB": 130050
            }
          }
        }
      }
    },
    "resourceGroup": "mylocal-rg",
    "systemData": {
      "createdAt": "2023-10-30T21:44:53.020512+00:00",
      "createdBy": "guspinto@contoso.com",
      "createdByType": "User",
      "lastModifiedAt": "2023-10-30T22:08:25.495995+00:00",
      "lastModifiedBy": "bbbbbbbb-1111-2222-3333-cccccccccccc",
      "lastModifiedByType": "Application"
    },
    "tags": {},
    "type": "microsoft.azurestackhci/marketplacegalleryimages"
  }
]

Pour plus d’informations sur cette commande CLI, consultez az stack-hci-vm image list.

Afficher les propriétés de l’image de machine virtuelle

Passez en revue les propriétés détaillées d’une image de machine virtuelle avant de l’utiliser pour créer des machines virtuelles.

Azure CLI
portail Azure

Pour afficher les propriétés d’image à l’aide d’Azure CLI, procédez comme suit :

Exécutez PowerShell en tant qu’administrateur.

Définissez les paramètres suivants.

$subscription = "<Subscription ID>"
$resource_group = "<Azure Local resource group>"
$mktplaceImage = "<Marketplace image name>"

Afficher les propriétés d’image à l’aide de l’une des deux méthodes suivantes : ID d’image de la Place de marché ou nom et groupe de ressources

Méthode 1 : Utilisation de l’ID d’image de la Place de marché

Définissez le paramètre ID d’image :

$mktplaceImageID = "/subscriptions/<subscription ID>/resourceGroups/<resource group>/providers/Microsoft.AzureStackHCI/galleryimages/mylocal-marketplaceimage"

Exécutez la commande suivante :

az stack-hci-vm image show --ids $mktplaceImageID

Voici un exemple de résultat :

PS C:\Users\azcli> az stack-hci-vm image show --ids $mktplaceImageID
Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
{
  "extendedLocation": {
    "name": "/subscriptions/<subscription ID>/resourcegroups/<resource group>/providers/microsoft.extendedlocation/customlocations/<custom location>",
    "type": "CustomLocation"
  },
  "id": "/subscriptions/<subscription ID>/resourceGroups/<resource group>/providers/Microsoft.AzureStackHCI/galleryimages/mylocal-marketplaceimage",
  "location": "eastus",
  "name": "mylocal-marketplaceimage",
  "properties": {
    "containerName": null,
    "hyperVGeneration": null,
    "identifier": null,
    "imagePath": null,
    "osType": "Windows",
    "provisioningState": "Succeeded",
    "status": null,
    "version": null
  },
  "resourceGroup": "mylocal-rg",
  "systemData": {
    "createdAt": "2022-08-05T20:52:38.579764+00:00",
    "createdBy": "guspinto@microsoft.com",
    "createdByType": "User",
    "lastModifiedAt": "2022-08-05T20:52:38.579764+00:00",
    "lastModifiedBy": "guspinto@microsoft.com",
    "lastModifiedByType": "User"
  },
  "tags": null,
  "type": "microsoft.azurestackhci/galleryimages"
}

Méthode 2 : Utilisation du nom et du groupe de ressources

Exécutez la commande suivante :

az stack-hci-vm image show --name $mktplaceImage --resource-group $resource_group

Voici un exemple de résultat :

PS /home/user> az stack-hci-vm image show --name "2022-datacenter-azure-edition-hotpatch-01" --resource-group $resource_group  
{
  "extendedLocation": {
    "name": "/subscriptions/<subscription>/resourcegroups/<resource group>/providers/microsoft.extendedlocation/customlocations/<custom location>",
    "type": "CustomLocation"
  },
  "id": "/subscriptions/<subscription>/resourceGroups/<resource group>/providers/microsoft.azurestackhci/marketplacegalleryimages/2022-datacenter-azure-edition-hotpatch-01",
  "location": "eastus",
  "name": "2022-datacenter-azure-edition-hotpatch-01",
  "properties": {
    "cloudInitDataSource": null,
    "containerId": "/subscriptions/<subscription>/resourceGroups/<resource group>/providers/Microsoft.AzureStackHCI/storageContainers/<container name>",
    "hyperVGeneration": "V2",
    "identifier": {
      "offer": "windowsserver",
      "publisher": "microsoftwindowsserver",
      "sku": "2022-datacenter-azure-edition-hotpatch"
    },
    "osType": "Windows",
    "provisioningState": "Succeeded",
    "status": {
      "downloadStatus": {
        "downloadSizeInMb": 11424
      },
      "errorCode": "",
      "errorMessage": "",
      "progressPercentage": 100,
      "provisioningStatus": {
        "operationId": "<operation ID>",
        "status": "Succeeded"
      }
    },
    "version": {
      "name": "20348.3561.250409",
      "properties": {
        "storageProfile": {
          "osDiskImage": {
            "sizeInMb": 130050
          }
        }
      }
    }
  },
  "resourceGroup": "<Resource group>",
  "systemData": {
    "createdAt": "2025-04-28T19:04:53.484650+00:00",
    "createdBy": "Michael.Godfrey@adaptivecloudlab.com",
    "createdByType": "User",
    "lastModifiedAt": "2025-11-25T17:00:29.308006+00:00",
    "lastModifiedBy": "dddddddd-3333-4444-5555-eeeeeeeeeeee",
    "lastModifiedByType": "Application"
  },
  "tags": {},
  "type": "microsoft.azurestackhci/marketplacegalleryimages"
}

Supprimer l’image de machine virtuelle

Supprimez les images de machine virtuelle qui ne sont plus nécessaires ou si le téléchargement a échoué lors de la création.

Azure CLI
portail Azure

Pour supprimer une image de machine virtuelle à l’aide d’Azure CLI, procédez comme suit :

Exécutez PowerShell en tant qu’administrateur.

Définissez les paramètres suivants :

$subscription = "<Subscription ID>"
$resource_group = "<Azure Local resource group>"
$mktplaceImage = "<Marketplace image name>"

Supprimez une image de machine virtuelle existante. Exécutez la commande suivante:

az stack-hci-vm image delete --subscription $subscription --resource-group $resource_group --name $mktplaceImage --yes

Vous pouvez supprimer des images à l’aide des éléments suivants :

Nom et groupe de ressources
ID d’image

Après avoir supprimé une image, vous pouvez vérifier que l’image est supprimée.

Voici un exemple de sortie montrant la suppression par nom et par groupe de ressources :

PS C:\Users\azcli> $subscription = "<Subscription ID>"
PS C:\Users\azcli> $resource_group = "<Resource group>"
PS C:\Users\azcli> $mktplaceImage = "mymylocal-marketplaceimage"
PS C:\Users\azcli> az stack-hci-vm image delete --name $mktplaceImage --resource-group $resource_group
    
Are you sure you want to perform this operation? (y/n): y
PS C:\Users\azcli> az stack-hci-vm image show --name $mktplaceImage --resource-group $resource_group
    
ResourceNotFound: The Resource 'Microsoft.AzureStackHCI/marketplacegalleryimages/myhci-marketplaceimage' under resource group '<resource group>' was not found. For more details please go to https://aka.ms/ARMResourceNotFoundFix

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2026-08-13

Gérer des images de machine virtuelle locale Azure via l’interface CLI ou le portail

Prerequisites

Liste des images de machine virtuelle

Afficher les propriétés de l’image de machine virtuelle

Supprimer l’image de machine virtuelle

Commentaires

Ressources supplémentaires