Creare un'immagine di macchina virtuale locale di Azure usando immagini di Azure Marketplace

Si applica a: Locale di Azure, versione 23H2

Questo articolo descrive come creare immagini di macchine virtuali per Azure Local usando immagini di origine da Azure Marketplace. È possibile creare immagini di macchine virtuali usando il portale di Azure o l'interfaccia della riga di comando di Azure e quindi usare queste immagini di macchina virtuale per creare macchine virtuali Arc in Locale di Azure.

Importante

Gli aggiornamenti più recenti potrebbero richiedere del tempo per riflettere sulle immagini della macchina virtuale quando vengono eseguite convalide aggiuntive.

Prerequisiti

Prima di iniziare, assicurarsi che i prerequisiti seguenti siano completati.

Interfaccia della riga di comando di Azure

• Assicurarsi di esaminare e completare i prerequisiti.

• Se si usa un client per connettersi all'istanza locale di Azure, vedere Connettersi al sistema in modalità remota.

Azure portal

Assicurarsi di esaminare e completare i prerequisiti.

Aggiungere un'immagine di macchina virtuale da Azure Marketplace

Si crea un'immagine di macchina virtuale a partire da un'immagine di Azure Marketplace e quindi si usa questa immagine per distribuire le macchine virtuali nell'istanza locale di Azure.

Interfaccia della riga di comando di Azure

Seguire questa procedura per creare un'immagine di macchina virtuale usando l'interfaccia della riga di comando di Azure.

Accedere e impostare la sottoscrizione

1. Connettersi a un computer in Locale di Azure.

2. Accedi. Tipo:

   az login --use-device-code
   

3. Impostare la sottoscrizione.

   az account set --subscription <Subscription ID>
   

Impostare alcuni parametri

1. Impostare i parametri per la sottoscrizione, il gruppo di risorse, la posizione, il tipo di sistema operativo per l'immagine. Sostituire i parametri in < > con i valori appropriati.

   $subscription = "<Subscription ID>"
   $resource_group = "<Resource group>"
   $mktplaceImage = "<Marketplace image name>"
   $customLocationName = "<Custom location name>"
   $customLocationID = (az customlocation show --resource-group $resource_group --name "<custom_location_name_for_Azure_Local>" --query id -o tsv)
   $location = "<Location for your Azure Local>"
   $osType = "<OS of source image>"
   

   I parametri vengono descritti nella tabella seguente:

   Parametro	Descrizione
   subscription	Sottoscrizione associata all'istanza locale di Azure.
   resource-group	Gruppo di risorse per l'istanza locale di Azure associata a questa immagine.
   name	Nome dell'immagine del marketplace per Azure Locale.
   customLocation	ID risorsa della posizione personalizzata per l'istanza locale di Azure.
   location	Località per l'istanza locale di Azure. Ad esempio, potrebbe essere eastus.
   os-type	Sistema operativo associato all'immagine di origine. Può trattarsi di Windows o Linux.

   Di seguito è riportato un output di esempio:

   PS C:\Users\azcli> $subscription = "<Subscription ID>"
   PS C:\Users\azcli> $resource_group = "mylocal-rg"
   PS C:\Users\azcli> $mktplaceImage= "mylocal-marketplaceimage"
   PS C:\Users\azcli> $customLocationName = "mylocal-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"
   

Creare un'immagine di macchina virtuale dall'immagine del marketplace

1. Impostare parametri aggiuntivi che specificano l'immagine di macchina virtuale desiderata da creare. Sarà necessario includere l'offerta, l'editore, lo SKU e la versione per l'immagine del marketplace. Sostituire i parametri in <> con i valori appropriati:

   $publisher = "<Publisher name>"
   $offer = "<OS offer>"
   $sku = "<Image SKU>"
   

   Usare la tabella seguente per trovare le immagini del Marketplace disponibili e i relativi valori di attributo:

   Nome	Autore	Offerta	SKU
   Windows 11 Enterprise multisessione + Microsoft 365	microsoftwindowsdesktop	office-365	win11-21h2-avd-m365 win11-23h2-avd-m365
   Windows 10 Enterprise multisessione + Microsoft 365	microsoftwindowsdesktop	office-365	win10-21h2-avd-m365 win10-22h2-avd-m365
   Windows 11 Pro	microsoftwindowsdesktop	windows-11	win11-21h2-pro win11-22h2-pro win11-23h2-pro
   Windows 11 Enterprise	microsoftwindowsdesktop	windows-11	win11-21h2-ent win11-22h2-ent win11-23h2-ent
   Windows 11 Enterprise multisessione	microsoftwindowsdesktop	windows-11	win11-21h2-avd win11-22h2-avd win11-23h2-avd
   Windows 10 Pro	microsoftwindowsdesktop	windows-10	win10-22h2-pro-g2
   Windows 10 Enterprise	microsoftwindowsdesktop	windows-10	win10-22h2-ent-g2
   Windows 10 Enterprise multisessione	microsoftwindowsdesktop	windows-10	win10-22h2-avd
   Windows Server 2022 Datacenter: Azure Edition	microsoftwindowsserver	windowsserver	2022-datacenter-azure-edition-hotpatch 2022-datacenter-azure-edition-core 2022-datacenter-azure-edition
   Windows Server 2019	microsoftwindowsserver	windowsserver	2019-datacenter-gensecond 2019-datacenter-core-g2
   SQL Server 2022 Enterprise in Windows Server 2022	microsoftsqlserver	sql2022-ws2022	enterprise-gen2 standard-gen2

   Se si vuole creare un'immagine di Windows Server 2019 Datacenter, sono disponibili i parametri seguenti:

   $publisher = "microsoftwindowsserver" 
   $offer = "windowsserver" 
   $sku = "2019-datacenter-gensecond"
   

2. Creare l'immagine della macchina virtuale a partire da un'immagine del marketplace specificata:

   az stack-hci-vm image create --resource-group $resource_group --custom-location $customLocationID --name $mktplaceImage --os-type $ostype --offer $offer --publisher $publisher --sku $sku 
   

Di seguito è riportato un output di esempio:

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/mylocal-rg/providers/Microsoft.ExtendedLocation/customLocations/mylocal-cl", 
    "type": "CustomLocation" 
  }, 
  "id": "/subscriptions/<Subscription ID>/resourceGroups/mylocal-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": "mylocal-rg", 
  "systemData": { 
    "createdAt": "2024-09-23T18:53:13.734389+00:00", 
    "createdBy": "guspinto@contoso.com", 
    "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" 
} 

Per altre informazioni su questo comando dell'interfaccia della riga di comando, vedere az stack-hci-vm image.

Azure portal

Seguire questa procedura per creare un'immagine di macchina virtuale usando portale di Azure. In portale di Azure per la risorsa locale di Azure seguire questa procedura:

1. Passare a Risorse immagini>di macchine virtuali.

2. Selezionare + Aggiungi immagine macchina virtuale e nell'elenco a discesa selezionare Aggiungi immagine macchina virtuale da Azure Marketplace.

   

3. Nella pagina Crea un'immagine immettere le informazioni seguenti nella scheda Informazioni di base:

   1. Sottoscrizione. Selezionare una sottoscrizione da associare all'immagine della macchina virtuale.

   2. Gruppo di risorse. Creare un gruppo di risorse nuovo o selezionare un gruppo di risorse esistente associato all'immagine della macchina virtuale.

   3. Percorso personalizzato. Selezionare un percorso personalizzato per distribuire l'immagine della macchina virtuale. La posizione personalizzata deve corrispondere alla posizione personalizzata per l'istanza locale di Azure.

   4. Immagine da scaricare. Selezionare un'immagine di macchina virtuale dall'elenco di immagini in Azure Marketplace. L'elenco a discesa mostra tutte le immagini di Azure Marketplace compatibili con l'istanza locale di Azure.

   5. Salvare l'immagine con nome. Immettere un nome per l'immagine della macchina virtuale.

   6. Percorso di archiviazione. Selezionare il percorso di archiviazione per l'immagine della macchina virtuale. Selezionare Scegli automaticamente per selezionare automaticamente un percorso di archiviazione con disponibilità elevata. Selezionare Scegliere manualmente per specificare un percorso di archiviazione per archiviare immagini e file di configurazione delle macchine virtuali nell'istanza locale di Azure. In questo caso, assicurarsi che il percorso di archiviazione specificato disponga di spazio di archiviazione sufficiente.

4. Selezionare Rivedi e crea per creare l'immagine della macchina virtuale.

   

5. I parametri di input vengono convalidati. Se le convalide hanno esito positivo, è possibile esaminare i dettagli dell'immagine della macchina virtuale e selezionare Crea.

   

6. Viene avviato un processo di distribuzione del modello di Azure Resource Manager per l'immagine della macchina virtuale. Il completamento della distribuzione delle immagini richiede alcuni minuti. Il tempo necessario per scaricare l'immagine dipende dalle dimensioni dell'immagine del Marketplace e dalla larghezza di banda di rete disponibile per il download.

   

   È possibile tenere traccia della distribuzione dell'immagine nella griglia delle immagini della macchina virtuale. È possibile visualizzare l'elenco delle immagini di macchina virtuale già scaricate e quelle scaricate nel sistema.

   Per visualizzare altri dettagli di qualsiasi immagine, selezionare il nome dell'immagine della macchina virtuale dall'elenco di immagini di macchina virtuale.

7. Al termine del download dell'immagine, l'immagine della macchina virtuale viene visualizzata nell'elenco delle immagini e lo stato viene visualizzato come Disponibile.

   

   Se il download dell'immagine della macchina virtuale ha esito negativo, i dettagli dell'errore vengono visualizzati nel pannello del portale.

   

Elencare le immagini delle macchine virtuali

È necessario visualizzare l'elenco delle immagini delle macchine virtuali per scegliere un'immagine da gestire.

Interfaccia della riga di comando di Azure

Seguire questa procedura per elencare l'immagine della macchina virtuale usando l'interfaccia della riga di comando di Azure.

1. Esegui PowerShell come amministratore.

2. Impostare alcuni parametri.

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

3. Elencare tutte le immagini di macchina virtuale associate all'istanza locale di Azure. Esegui questo comando:

   az stack-hci-vm image list --subscription $subscription --resource-group $resource_group
   

   A seconda del comando usato, viene elencato un set corrispondente di immagini associate all'istanza locale di Azure.

   • Se si specifica solo la sottoscrizione, il comando elenca tutte le immagini nella sottoscrizione.
   • Se si specificano sia la sottoscrizione che il gruppo di risorse, il comando elenca tutte le immagini nel gruppo di risorse.

   Queste immagini includono:

   • Immagini di macchine virtuali dalle immagini del Marketplace.
   • Immagini personalizzate che risiedono nell'account Archiviazione di Azure o che si trovano in una condivisione locale nel sistema o in un client connesso al sistema.

Di seguito è riportato un output di esempio.

PS C:\Users\azcli> az stack-hci-vm image list --subscription "<Subscription ID>" --resource-group "myhci-rg"
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/myhci-rg/providers/microsoft.extendedlocation/customlocations/myhci-cl",
      "type": "CustomLocation"
    },
    "id": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/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": "19742d69-4a00-4086-8f17-4dc1f7ee6681*E1E9889F0D1840B93150BD74D428EAE483CB67B0904F9A198C161AD471F670ED",
          "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": "319f651f-7ddb-4fc6-9857-7aef9250bd05",
      "lastModifiedByType": "Application"
    },
    "tags": {},
    "type": "microsoft.azurestackhci/marketplacegalleryimages"
  }
]
PS C:\Users\azcli>

Per altre informazioni su questo comando dell'interfaccia della riga di comando, vedere az stack-hci-vm image list.

Azure portal

Nella portale di Azure della risorsa locale di Azure è possibile tenere traccia della distribuzione dell'immagine della macchina virtuale nella griglia delle immagini della macchina virtuale. È possibile visualizzare l'elenco delle immagini di macchina virtuale già scaricate e quelle scaricate nel sistema.

Seguire questa procedura per visualizzare l'elenco delle immagini delle macchine virtuali in portale di Azure.

1. Nella portale di Azure passare alla risorsa locale di Azure.

2. Passare a Risorse immagini > di macchine virtuali.

3. Nel riquadro destro è possibile visualizzare l'elenco delle immagini della macchina virtuale.

   

Visualizzare le proprietà dell'immagine della macchina virtuale

È consigliabile visualizzare le proprietà delle immagini di macchina virtuale prima di usare l'immagine per creare una macchina virtuale. Seguire questa procedura per visualizzare le proprietà dell'immagine:

Interfaccia della riga di comando di Azure

Seguire questa procedura per usare l'interfaccia della riga di comando di Azure per visualizzare le proprietà di un'immagine:

1. Esegui PowerShell come amministratore.

2. Impostare i parametri seguenti.

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

3. È possibile visualizzare le proprietà delle immagini in due modi diversi: specificare l'ID o specificare il nome e il gruppo di risorse. Per specificare l'ID immagine del Marketplace, seguire questa procedura:

   1. Impostare il parametro seguente.

      $mktplaceImageID = "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/galleryimages/mylocal-marketplaceimage"
      

   2. Eseguire il comando seguente per visualizzare le proprietà.

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

      Ecco un output di esempio per questo comando:

      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/myhci-rg/providers/microsoft.extendedlocation/customlocations/mylocal-cl",
          "type": "CustomLocation"
        },
        "id": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/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"
      }
      PS C:\Users\azcli> 
      

Azure portal

Nella portale di Azure della risorsa locale di Azure seguire questa procedura:

1. Passare a Risorse immagini>di macchine virtuali. Nel riquadro destro viene visualizzato un elenco di immagini di macchine virtuali.

   

2. Selezionare il nome dell'immagine della macchina virtuale per visualizzare le proprietà.

   

Aggiornare l'immagine della macchina virtuale

Quando una nuova immagine aggiornata è disponibile in Azure Marketplace, le immagini delle macchine virtuali in Locale di Azure diventano non aggiornate e devono essere aggiornate. L'operazione di aggiornamento non è un aggiornamento sul posto dell'immagine. È invece possibile visualizzare le immagini di macchina virtuale disponibili per un'immagine aggiornata e selezionare le immagini da aggiornare. Dopo l'aggiornamento, l'operazione di creazione dell'immagine della macchina virtuale usa la nuova immagine aggiornata.

Per aggiornare un'immagine di macchina virtuale, seguire questa procedura in portale di Azure.

1. Per verificare se è disponibile un aggiornamento, selezionare un'immagine di macchina virtuale nella visualizzazione elenco.

   

   Nel pannello Panoramica viene visualizzato un banner che mostra la nuova immagine della macchina virtuale disponibile per il download, se disponibile. Per eseguire l'aggiornamento alla nuova immagine, selezionare l'icona a forma di freccia.

   

2. Esaminare i dettagli dell'immagine e quindi selezionare Rivedi e crea. Per impostazione predefinita, la nuova immagine usa lo stesso gruppo di risorse e i dettagli dell'istanza dell'immagine precedente.

   Il nome della nuova immagine viene incrementato in base al nome dell'immagine precedente. Ad esempio, un'immagine esistente denominata winServer2022-01 avrà un'immagine aggiornata denominata winServer2022-02.

   

3. Per completare l'operazione, selezionare Crea.

   

   Dopo aver creato la nuova immagine della macchina virtuale, creare una macchina virtuale usando la nuova immagine e verificare che la macchina virtuale funzioni correttamente. Dopo la verifica, è possibile eliminare l'immagine precedente della macchina virtuale.

   Nota

   In questa versione non è possibile eliminare un'immagine di macchina virtuale se la macchina virtuale associata a tale immagine è in esecuzione. Arrestare la macchina virtuale e quindi eliminare l'immagine della macchina virtuale.

Eliminare l'immagine della macchina virtuale

È possibile eliminare un'immagine di macchina virtuale se il download non riesce per qualche motivo o se l'immagine non è più necessaria. Seguire questa procedura per eliminare le immagini della macchina virtuale.

Interfaccia della riga di comando di Azure

1. Esegui PowerShell come amministratore.

2. Imposta i parametri seguenti:

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

3. Rimuovere un'immagine di macchina virtuale esistente. Esegui questo comando:

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

È possibile eliminare l'immagine in due modi:

• Specificare il nome e il gruppo di risorse.
• Specificare l'ID.

Dopo aver eliminato un'immagine, è possibile verificare che l'immagine sia stata rimossa. Ecco un output di esempio quando l'immagine è stata eliminata specificando il nome e il gruppo di risorse.

PS C:\Users\azcli> $subscription = "<Subscription ID>"
PS C:\Users\azcli> $resource_group = "mylocal-rg"
PS C:\Users\azcli> $mktplaceImage = "mymylocal-marketplaceimage"
PS C:\Users\azcli> az stack-hci-vm image delete --name $mktplaceImage --resource-group $resource_group
Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
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
Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
ResourceNotFound: The Resource 'Microsoft.AzureStackHCI/marketplacegalleryimages/myhci-marketplaceimage' under resource group 'mylocal-rg' was not found. For more details please go to https://aka.ms/ARMResourceNotFoundFix
PS C:\Users\azcli>

Azure portal

Nella portale di Azure della risorsa locale di Azure seguire questa procedura:

1. Passare a Risorse immagini>di macchine virtuali.

2. Nell'elenco di immagini di macchine virtuali visualizzate nel riquadro destro selezionare l'icona del cestino accanto all'immagine della macchina virtuale che si vuole eliminare.

   

3. Quando viene richiesto di confermare l'eliminazione, selezionare Sì.

   

Dopo l'eliminazione dell'immagine della macchina virtuale, l'elenco delle immagini della macchina virtuale viene aggiornato per riflettere l'immagine eliminata.

Passaggi successivi

• Creare reti logiche