Erstellen eines Azure Stack HCI-VM-Images mithilfe von Azure Marketplace-Images

• Überprüfen und abschließen Sie die Voraussetzungen.

• Wenn Sie einen Client zum Herstellen einer Verbindung mit Ihrem Azure Stack HCI-Cluster verwenden, lesen Sie "Remoteverbindung mit dem Cluster herstellen".

Überprüfen und abschließen Sie die Voraussetzungen.

Führen Sie die folgenden Schritte aus, um ein VM-Image mithilfe der Azure CLI zu erstellen.

Anmelden und Festlegen des Abonnements

1. Stellen Sie eine Verbindung mit einem Server auf Ihrem Azure Stack HCI-System her.

2. Anmelden. Typ:

   az login --use-device-code
   

3. Legen Sie Ihr Abonnement fest.

   az account set --subscription <Subscription ID>
   

Festlegen einiger Parameter

1. Legen Sie Parameter für Ihr Abonnement, die Ressourcengruppe, den Standort, den Betriebssystemtyp für das Image fest. Ersetzen Sie die Parameter < > durch die entsprechenden Werte.

   $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_Stack_HCI_cluster>" --query id -o tsv)
   $location = "<Location for your Azure Stack HCI cluster>"
   $osType = "<OS of source image>"
   

   Die Parameter werden in der folgenden Tabelle beschrieben:

   Parameter	Beschreibung
   subscription	Abonnement, das Ihrem Azure Stack HCI-Cluster zugeordnet ist.
   resource-group	Ressourcengruppe für Azure Stack HCI-Cluster, den Sie diesem Image zuordnen.
   name	Name des Marketplace-Images für Azure Stack HCI-Cluster.
   customLocation	Ressourcen-ID des benutzerdefinierten Speicherorts für Azure Stack HCI-Cluster.
   location	Speicherort für Ihren Azure Stack HCI-Cluster. Das kann beispielsweise eastus sein.
   os-type	Betriebssystem, das dem Quellimage zugeordnet ist. Dies kann Windows oder Linux sein.

   Hier ist eine Beispielausgabe:

   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"
   

Erstellen eines VM-Images aus dem Marketplace-Image

1. Legen Sie zusätzliche Parameter fest, die das beabsichtigte VM-Image angeben, das Sie erstellen möchten. Sie müssen das Angebot, den Herausgeber, die SKU und die Version für das Marketplace-Image einschließen. Ersetzen Sie die Parameter <> durch die entsprechenden Werte:

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

   Verwenden Sie die folgende Tabelle, um die verfügbaren Marketplace-Bilder und deren Attributwerte zu finden:

   Name	Herausgeber	Angebot	SKU
   Windows 11 Enterprise multi-session + Microsoft 365	microsoftwindowsdesktop	office-365	win11-21h2-avd-m365 win11-23h2-avd-m365
   Windows 10 Enterprise multi-session + 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 (mehrere Sitzungen)	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 für mehrere Sitzungen	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 unter Windows Server 2022	microsoftsqlserver	sql2022-ws2022	Enterprise-Gen2 standard-gen2

   Wenn Sie ein Windows Server 2019 Datacenter-Image erstellen möchten, haben Sie die folgenden Parameter:

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

2. Erstellen Sie das VM-Image beginnend mit einem angegebenen Marketplace-Image:

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

Hier ist eine Beispielausgabe:

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": "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" 
} 

Weitere Informationen zu diesem CLI-Befehl finden Sie unter az stack-hci-vm image.

Führen Sie die folgenden Schritte aus, um ein VM-Image mit dem Azure-Portal zu erstellen. Führen Sie im Azure-Portal Ihrer Azure Stack HCI-Clusterressource die folgenden Schritte aus:

1. Wechseln Sie zu Ressourcen-VM-Images>.

2. Wählen Sie +VM-Image hinzufügen und in der Dropdownliste " VM-Image hinzufügen" aus Azure Marketplace aus.

   

3. Geben Sie auf der Registerkarte "Grundlagen" auf der Seite "Bild erstellen" die folgenden Informationen ein:

   1. Abonnement. Wählen Sie ein Abonnement aus, das Ihrem VM-Image zugeordnet werden soll.

   2. Ressourcengruppe. Erstellen Sie eine neue Oder wählen Sie eine vorhandene Ressourcengruppe aus, die Sie dem VM-Image zuordnen.

   3. Benutzerdefinierter Speicherort. Wählen Sie einen benutzerdefinierten Speicherort aus, um Ihr VM-Image bereitzustellen. Der benutzerdefinierte Speicherort sollte dem benutzerdefinierten Speicherort für Ihren Azure Stack HCI-Cluster entsprechen.

   4. Bild, das heruntergeladen werden soll. Wählen Sie ein VM-Image aus der Liste der Images in Azure Marketplace aus. In der Dropdownliste werden alle Azure Marketplace-Images angezeigt, die mit Ihrem Azure Stack HCI-Cluster kompatibel sind.

   5. Bild speichern unter. Geben Sie einen Namen für Ihr VM-Image ein.

   6. Speicherpfad. Wählen Sie den Speicherpfad für Ihr VM-Image aus. Wählen Sie "Automatisch auswählen" aus, damit ein Speicherpfad mit automatischer Hoher Verfügbarkeit ausgewählt wird. Wählen Sie "Manuell auswählen", um einen Speicherpfad zum Speichern von VM-Images und Konfigurationsdateien im Azure Stack HCI-Cluster anzugeben. Stellen Sie in diesem Fall sicher, dass der angegebene Speicherpfad über ausreichend Speicherplatz verfügt.

4. Wählen Sie "Überprüfen" und "Erstellen" aus, um Ihr VM-Image zu erstellen.

   

5. Die Eingabeparameter werden überprüft. Wenn die Überprüfungen erfolgreich sind, können Sie die Vm-Imagedetails überprüfen und "Erstellen" auswählen.

   

6. Ein Azure Resource Manager-Vorlagenbereitstellungsauftrag wird für das VM-Image gestartet. Die Imagebereitstellung dauert einige Minuten, bis sie abgeschlossen sind. Die Zeit zum Herunterladen des Bilds hängt von der Größe des Marketplace-Images und der für den Download verfügbaren Netzwerkbandbreite ab.

   

   Sie können die Imagebereitstellung im VM-Imageraster nachverfolgen. Sie können die Liste der VM-Images sehen, die bereits heruntergeladen wurden, und die, die auf den Cluster heruntergeladen werden.

   Wenn Sie weitere Details zu einem beliebigen Image anzeigen möchten, wählen Sie den Namen des VM-Images aus der Liste der VM-Images aus.

7. Wenn der Download des Bilds abgeschlossen ist, wird das VM-Image in der Liste der Bilder angezeigt, und der Status wird als verfügbar angezeigt.

   

   Wenn der Download des VM-Images fehlschlägt, werden die Fehlerdetails im Portalblatt angezeigt.

   

Führen Sie die folgenden Schritte aus, um das VM-Image mithilfe der Azure CLI auflisten.

1. Führen Sie PowerShell als Administrator aus.

2. Legen Sie einige Parameter fest.

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

3. Auflisten aller VM-Images, die Ihrem Cluster zugeordnet sind. Führen Sie den folgenden Befehl aus:

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

   Je nach verwendetem Befehl werden eine entsprechende Gruppe von Bildern aufgeführt, die dem Azure Stack HCI-Cluster zugeordnet sind.

   • Wenn Sie nur das Abonnement angeben, listet der Befehl alle Bilder im Abonnement auf.
   • Wenn Sie sowohl das Abonnement als auch die Ressourcengruppe angeben, listet der Befehl alle Bilder in der Ressourcengruppe auf.

   Zu diesen Images gehören:

   • VM-Images aus Marketplace-Images.
   • Benutzerdefinierte Bilder, die sich in Ihrem Azure Storage-Konto befinden oder sich in einer lokalen Freigabe auf Ihrem Cluster oder einem client befinden, der mit dem Cluster verbunden ist.

Hier ist eine Beispielausgabe.

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": "myhci-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>

Weitere Informationen zu diesem CLI-Befehl finden Sie in der Imageliste "az stack-hci-vm".

Im Azure-Portal Ihrer Azure Stack HCI-Clusterressource können Sie die VM-Imagebereitstellung im VM-Imageraster nachverfolgen. Sie können die Liste der VM-Images sehen, die bereits heruntergeladen wurden, und die, die auf den Cluster heruntergeladen werden.

Führen Sie die folgenden Schritte aus, um die Liste der VM-Images in Azure-Portal anzuzeigen.

1. Wechseln Sie im Azure-Portal zu Ihrer Azure Stack HCI-Clusterressource.

2. Wechseln Sie zu Ressourcen-VM-Images>.

3. Im rechten Bereich können Sie die Liste der VM-Images anzeigen.

   

Führen Sie die folgenden Schritte aus, um die Eigenschaften eines Bilds mithilfe der Azure CLI anzuzeigen:

1. Führen Sie PowerShell als Administrator aus.

2. Legen Sie die folgenden Parameter fest.

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

3. Sie können Bildeigenschaften auf zwei verschiedene Arten anzeigen: ID angeben oder Namen und Ressourcengruppe angeben. Führen Sie die folgenden Schritte aus, wenn Sie die Marketplace-Image-ID angeben:

   1. Legen Sie den folgenden Parameter fest.

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

   2. Führen Sie den folgenden Befehl aus, um die Eigenschaften anzuzeigen.

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

      Hier ist eine Beispielausgabe für diesen Befehl:

      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/myhci-cl",
          "type": "CustomLocation"
        },
        "id": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/galleryimages/myhci-marketplaceimage",
        "location": "eastus",
        "name": "myhci-marketplaceimage",
        "properties": {
          "containerName": null,
          "hyperVGeneration": null,
          "identifier": null,
          "imagePath": null,
          "osType": "Windows",
          "provisioningState": "Succeeded",
          "status": null,
          "version": null
        },
        "resourceGroup": "myhci-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> 
      

Führen Sie im Azure-Portal Ihrer Azure Stack HCI-Clusterressource die folgenden Schritte aus:

1. Wechseln Sie zu Ressourcen-VM-Images>. Im rechten Bereich wird eine Liste der VM-Images angezeigt.

   

2. Wählen Sie den Namen des virtuellen Computers aus, um die Eigenschaften anzuzeigen.

   

1. Führen Sie PowerShell als Administrator aus.

2. Legen Sie die folgenden Parameter fest:

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

3. Entfernen Sie ein vorhandenes VM-Image. Führen Sie den folgenden Befehl aus:

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

Sie können das Bild auf zwei Arten löschen:

• Geben Sie Namen und Ressourcengruppe an.
• Geben Sie die ID an.

Nachdem Sie ein Bild gelöscht haben, können Sie überprüfen, ob das Bild entfernt wurde. Hier sehen Sie eine Beispielausgabe, als das Bild gelöscht wurde, indem Sie den Namen und die Ressourcengruppe angeben.

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> 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 'myhci-rg' was not found. For more details please go to https://aka.ms/ARMResourceNotFoundFix
PS C:\Users\azcli>

Führen Sie im Azure-Portal Ihrer Azure Stack HCI-Clusterressource die folgenden Schritte aus:

1. Wechseln Sie zu Ressourcen-VM-Images>.

2. Wählen Sie in der Liste der VM-Images, die im rechten Bereich angezeigt werden, das Papierkorbsymbol neben dem VM-Image aus, das Sie löschen möchten.

   

3. Wenn Sie aufgefordert werden, den Löschvorgang zu bestätigen, wählen Sie "Ja" aus.

   

Nachdem das VM-Image gelöscht wurde, wird die Liste der VM-Images aktualisiert, um das gelöschte Image widerzuspiegeln.