Udostępnij za pośrednictwem


Tworzenie lokalnego obrazu maszyny wirtualnej platformy Azure przy użyciu obrazów witryny Azure Marketplace

Dotyczy: Azure Local 2311.2 i nowsze

W tym artykule opisano sposób tworzenia obrazów maszyn wirtualnych dla usługi Azure Local przy użyciu obrazów źródłowych z witryny Azure Marketplace. Obrazy maszyn wirtualnych można tworzyć przy użyciu witryny Azure Portal lub interfejsu wiersza polecenia platformy Azure, a następnie używać tych obrazów maszyn wirtualnych do tworzenia maszyn wirtualnych usługi Arc w środowisku lokalnym platformy Azure.

Wymagania wstępne

Przed rozpoczęciem upewnij się, że zostały spełnione następujące wymagania wstępne.

  • Upewnij się, że przejrzysz wymagania wstępne i upewnisz się, że są spełnione.

  • Upewnij się, że masz rolę Azure Connected Machine Resource Manager. Aby uzyskać więcej informacji, zobacz Przypisywanie ról platformy Azure.

  • Upewnij się, że subskrypcja jest zarejestrowana u dostawcy zasobów Microsoft.EdgeMarketplace. Aby uzyskać więcej informacji, zobacz Rejestr dostawcy zasobów.

  • Jeśli używasz klienta do nawiązywania połączenia z wystąpieniem lokalnym platformy Azure, zobacz Zdalne nawiązywanie połączenia z systemem.

Dodawanie obrazu maszyny wirtualnej z witryny Azure Marketplace

Utworzysz obraz maszyny wirtualnej, zaczynając od obrazu witryny Azure Marketplace, a następnie użyjesz tego obrazu do wdrożenia maszyn wirtualnych w wystąpieniu lokalnym platformy Azure.

Wykonaj następujące kroki, aby utworzyć obraz maszyny wirtualnej przy użyciu interfejsu wiersza polecenia platformy Azure.

Logowanie się i ustawianie subskrypcji

  1. Nawiąż połączenie z maszyną w twoim lokalnym środowisku Azure.

  2. Zaloguj. Typ:

    az login --use-device-code
    
  3. Ustaw subskrypcję.

    az account set --subscription <Subscription ID>
    

Ustawianie niektórych parametrów

  1. Ustaw parametry dla subskrypcji, grupy zasobów, lokalizacji, typu systemu operacyjnego dla obrazu. Zastąp parametry w < > pliku odpowiednimi wartościami.

    $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>"
    

    Parametry zostały opisane w poniższej tabeli:

    Parametr Opis
    subscription Subskrypcja skojarzona z lokalną platformą Azure.
    resource-group Grupa zasobów dla lokalnej platformy Azure, którą skojarzysz z tym obrazem.
    name Nazwa obrazu witryny Marketplace dla usługi Azure Local.
    customLocation Identyfikator zasobu lokalizacji niestandardowej dla lokalnej usługi Azure.
    location Lokalizacja dla Azure Local. Na przykład może to być eastus.
    os-type System operacyjny skojarzony z obrazem źródłowym. Może to być system Windows lub Linux.

    Oto przykładowe dane wyjściowe:

    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"
    

Tworzenie obrazu maszyny wirtualnej na podstawie obrazu z witryny Marketplace

  1. Ustaw dodatkowe parametry określające zamierzony obraz maszyny wirtualnej, który chcesz utworzyć. Musisz uwzględnić ofertę, wydawcę, jednostkę SKU i wersję obrazu witryny Marketplace. Zastąp parametry w pliku <> odpowiednimi wartościami:

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

    Skorzystaj z poniższej tabeli, aby znaleźć dostępne obrazy z witryny Marketplace i ich wartości atrybutów:

    Nazwisko Wydawca Oferta jednostka magazynowa (SKU)
    Wiele sesji systemu Windows 11 Enterprise i platforma Microsoft 365 Microsoft Windows Desktop office-365 win11-23h2-avd-m365
    win11-24h2-avd-m365
    Wiele sesji systemu Windows 10 Enterprise i platforma Microsoft 365 Microsoft Windows Desktop office-365 win10-21h2-avd-m365
    Windows 11 Pro Microsoft Windows Desktop windows-11 win11-23h2-pro
    Windows 11 Enterprise Microsoft Windows Desktop windows-11 win11-22h2-ent
    win11-23h2-ent
    win11-24h2-ent
    Windows 11 Enterprise z obsługą wielu sesji Microsoft Windows Desktop windows-11 win11-22h2-avd
    win11-23h2-avd
    win11-24h2-avd
    Windows 10 Pro Microsoft Windows Desktop windows-10 win10-22h2-pro-g2
    Windows 10 Enterprise Microsoft Windows Desktop windows-10 win10-22h2-ent-g2
    Windows 10 Enterprise w trybie wielosesyjnym Microsoft Windows Desktop windows-10 win10-22h2-avd
    Windows Server 2025 Datacenter: Azure Edition microsoftwindowsserver windowsserver 2025-datacenter-azure-edition-smalldisk
    2025-datacenter-azure-edition-core
    2025 Datacenter Azure Edition
    Windows Server 2022 Datacenter: Azure Edition microsoftwindowsserver windowsserver 2022-datacenter-azure-edition-aktualizacja-na-gorąco
    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 w systemie Windows Server 2022 microsoftsqlserver sql2022-ws2022 enterprise-gen2 (platforma drugiej generacji)
    standard gen2

    Jeśli chcesz utworzyć obraz systemu Windows Server 2019 Datacenter, masz następujące parametry:

    $publisher = "microsoftwindowsserver" 
    $offer = "windowsserver" 
    $sku = "2019-datacenter-gensecond"
    
  2. Utwórz obraz maszyny wirtualnej rozpoczynający się od określonego obrazu z witryny Marketplace:

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

Oto przykładowe dane wyjściowe:

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

Aby uzyskać więcej informacji na temat tego polecenia interfejsu wiersza poleceń, zobacz az stack-hci-vm image.

Lista obrazów maszyn wirtualnych

Aby wybrać obraz do zarządzania, musisz wyświetlić listę obrazów maszyn wirtualnych.

Wykonaj następujące kroki, aby wyświetlić listę obrazów maszyn wirtualnych przy użyciu interfejsu wiersza polecenia platformy Azure.

  1. Uruchom program Powershell jako Administrator.

  2. Ustaw parametry.

    $subscription = "<Subscription ID associated with your Azure Local>"
    $resource_group = "<Resource group name for your Azure Local>"
    
  3. Wyświetl listę wszystkich obrazów VM skojarzonych z Azure Local. Uruchom następujące polecenie:

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

    W zależności od używanego polecenia zostanie wyświetlony odpowiedni zestaw obrazów skojarzonych z lokalną platformą Azure.

    • Jeśli określisz tylko subskrypcję, polecenie wyświetli listę wszystkich obrazów w subskrypcji.
    • Jeśli określisz zarówno subskrypcję, jak i grupę zasobów, polecenie wyświetli listę wszystkich obrazów w grupie zasobów.

    Te obrazy obejmują:

    • Obrazy maszyn wirtualnych z witryny Marketplace.
    • Obrazy niestandardowe, które znajdują się na koncie usługi Azure Storage lub znajdują się w udziale lokalnym w systemie lub kliencie połączonym z systemem.

Oto przykładowe dane wyjściowe.

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>

Aby uzyskać więcej informacji na temat tego polecenia CLI, zobacz az stack-hci-vm image list.

Wyświetlanie właściwości obrazu maszyny wirtualnej

Możesz wyświetlić właściwości obrazu maszyny wirtualnej, zanim użyjesz go do utworzenia maszyny wirtualnej. Wykonaj następujące kroki, aby wyświetlić właściwości obrazu:

Wykonaj następujące kroki, aby wyświetlić właściwości obrazu przy użyciu interfejsu wiersza polecenia platformy Azure:

  1. Uruchom program Powershell jako Administrator.

  2. Ustaw następujące parametry.

    $subscription = "<Subscription ID>"
    $resource_group = "<Azure Local resource group>"
    $mktplaceImage = "<Marketplace image name>"
    
  3. Właściwości obrazu można wyświetlić na dwa różne sposoby: określ identyfikator lub określ nazwę i grupę zasobów. Wykonaj następujące kroki podczas określania identyfikatora obrazu witryny Marketplace:

    1. Ustaw następujący parametr.

      $mktplaceImageID = "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/galleryimages/mylocal-marketplaceimage"
      
    2. Uruchom następujące polecenie, aby wyświetlić właściwości.

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

      Oto przykładowe dane wyjściowe dla tego polecenia:

      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> 
      

Aktualizowanie obrazu maszyny wirtualnej

Ważne

Najnowsze aktualizacje mogą zająć trochę czasu, aby odzwierciedlić się na obrazach maszyn wirtualnych w miarę wykonywania dodatkowych weryfikacji.

Gdy nowy zaktualizowany obraz jest dostępny w witrynie Azure Marketplace, obrazy maszyn wirtualnych w środowisku lokalnym platformy Azure stają się nieaktualne i powinny zostać zaktualizowane. Operacja aktualizacji nie polega na bezpośredniej aktualizacji obrazu. Zamiast tego można zobaczyć, dla których obrazów maszyn wirtualnych jest dostępny zaktualizowany obraz, i wybrać obrazy do zaktualizowania. Po aktualizacji operacja tworzenia obrazu maszyny wirtualnej używa nowego zaktualizowanego obrazu.

Aby zaktualizować obraz maszyny wirtualnej, wykonaj następujące kroki w witrynie Azure Portal.

  1. Aby sprawdzić, czy aktualizacja jest dostępna, wybierz obraz maszyny wirtualnej z widoku listy.

    Zrzut ekranu przedstawiający dostępność aktualizacji obrazu maszyny wirtualnej do pobrania.

    W bloku Przegląd zostanie wyświetlony baner przedstawiający nowy obraz maszyny wirtualnej dostępny do pobrania, jeśli jest dostępny. Aby zaktualizować nowy obraz, wybierz ikonę strzałki.

    Zrzut ekranu przedstawiający nowy obraz maszyny wirtualnej dostępny do pobrania w szczegółach obrazu maszyny wirtualnej.

  2. Przejrzyj szczegóły obrazu, a następnie wybierz pozycję Przejrzyj i utwórz. Domyślnie nowy obraz używa tej samej grupy zasobów i szczegółów wystąpienia co poprzedni obraz.

    Nazwa nowego obrazu jest inkrementowana w oparciu o nazwę poprzedniego obrazu. Na przykład istniejący obraz o nazwie winServer2022-01 będzie miał zaktualizowany obraz o nazwie winServer2022-02.

    Zrzut ekranu przedstawiający okno dialogowe Przegląd i tworzenie nowego obrazu maszyny wirtualnej.

  3. Aby ukończyć operację, wybierz pozycję Utwórz.

    Zrzut ekranu przedstawiający okno dialogowe Tworzenie obrazu dla nowego obrazu maszyny wirtualnej.

    Po utworzeniu nowego obrazu maszyny wirtualnej utwórz maszynę wirtualną przy użyciu nowego obrazu i sprawdź, czy maszyna wirtualna działa prawidłowo. Po weryfikacji możesz usunąć stary obraz maszyny wirtualnej.

Usuwanie obrazu maszyny wirtualnej

Możesz usunąć obraz maszyny wirtualnej, jeśli pobieranie zakończy się niepowodzeniem z jakiegoś powodu lub jeśli obraz nie jest już potrzebny. Wykonaj następujące kroki, aby usunąć obrazy maszyn wirtualnych.

  1. Uruchom program Powershell jako Administrator.

  2. Ustaw następujące parametry:

    $subscription = "<Subscription ID>"
    $resource_group = "<Azure Local resource group>"
    $mktplaceImage = "<Markeplace image name>"    
    
  3. Usuń istniejący obraz maszyny wirtualnej. Uruchom następujące polecenie:

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

Obraz można usunąć na dwa sposoby:

  • Określ nazwę i grupę zasobów.
  • Określ identyfikator.

Po usunięciu obrazu możesz sprawdzić, czy obraz zostanie usunięty. Oto przykładowe dane wyjściowe, gdy obraz został usunięty, określając nazwę i grupę zasobów.

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>

Następne kroki