Criar imagem de VM Local do Azure usando imagens do Azure Marketplace

Aplica-se a: Azure Local, versão 23H2

Este artigo descreve como criar imagens de máquina virtual (VM) para o Azure Local usando imagens de origem do Azure Marketplace. Você pode criar imagens de VM usando o portal do Azure ou a CLI do Azure e, em seguida, usar essas imagens de VM para criar VMs do Arc no Azure Local.

Pré-requisitos

Antes de começar, certifique-se de que os seguintes pré-requisitos foram concluídos.

CLI do Azure

• Certifique-se de revisar e preencher os pré-requisitos.

• Verifique se tem a função Azure Connected Machine Resource Manager. Para mais informações, consulte Atribuir funções do Azure.

• Se estiver usando um cliente para se conectar à sua instância local do Azure, consulte Conectar-se ao sistema remotamente.

Portal do Azure

• Certifique-se de revisar e preencher os pré-requisitos.

• Verifique se tem a função Azure Connected Machine Resource Manager. Para mais informações, consulte Atribuir funções do Azure.

Adicionar imagem de VM do Azure Marketplace

Você cria uma imagem de VM a partir de uma imagem do Azure Marketplace e usa essa imagem para implantar VMs em sua instância Local do Azure.

CLI do Azure

Siga estas etapas para criar uma imagem de VM usando a CLI do Azure.

Iniciar sessão e definir subscrição

1. Conecte-se a uma máquina em seu Azure Local.

2. Inicie sessão. Tipo:

   az login --use-device-code
   

3. Defina a sua subscrição.

   az account set --subscription <Subscription ID>
   

Definir alguns parâmetros

1. Defina parâmetros para a sua subscrição, grupo de recursos, localização, tipo de SO para a imagem. Substitua os parâmetros pelos < > valores apropriados.

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

   Os parâmetros são descritos na tabela a seguir:

   Parâmetro	Description
   subscription	Subscrição associada ao seu Azure Local.
   resource-group	Grupo de recursos para o seu Azure Local que você associa a esta imagem.
   name	Nome da imagem do marketplace para o Azure Local.
   customLocation	ID de recurso do local personalizado para seu Azure Local.
   location	Localização do seu Azure Local. Por exemplo, poderia ser eastus.
   os-type	Sistema operacional associado à imagem de origem. Pode ser Windows ou Linux.

   Aqui está um exemplo de saída:

   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"
   

Criar imagem de VM a partir da imagem do marketplace

1. Defina parâmetros adicionais que especifiquem a imagem de VM pretendida que você gostaria de criar. Você precisará incluir a oferta, o editor, o SKU e a versão para a imagem do mercado. Substitua os parâmetros pelos <> valores apropriados:

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

   Use a tabela a seguir para encontrar as imagens de mercado disponíveis e seus valores de atributo:

   Nome	Publisher	Oferecer	SKU
   Windows 11 Enterprise multi-sessão + Microsoft 365	MicrosoftWindowsDesktop	escritório-365	win11-23h2-avd-m365
   Windows 10 Enterprise multi-sessão + Microsoft 365	MicrosoftWindowsDesktop	escritório-365	win10-21h2-avd-m365 win10-22h2-avd-m365
   Windows 11 Pro	MicrosoftWindowsDesktop	Janelas-11	win11-23h2-pro
   Windows 11 Enterprise	MicrosoftWindowsDesktop	Janelas-11	win11-22h2-otorrinolaringologia win11-23h2-otorrinolaringologia win11-24h2-ent
   Windows 11 Enterprise multissessão	MicrosoftWindowsDesktop	Janelas-11	win11-22h2-avd Win11-23H2-AVD Win11-24H2-AVD
   Windows 10 Pro	MicrosoftWindowsDesktop	Janelas-10	win10-22h2-pro-g2
   Windows 10 Enterprise	MicrosoftWindowsDesktop	Janelas-10	win10-22h2-ent-g2
   Windows 10 Enterprise multissessão	MicrosoftWindowsDesktop	Janelas-10	win10-22h2-média
   Windows Server 2025 Datacenter: Edição do Azure	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-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 no Windows Server 2022	MicrosoftSQLServer	SQL2022-WS2022	empresa-gen2 padrão-gen2

   Se você quisesse criar uma imagem do Windows Server 2019 Datacenter, teria os seguintes parâmetros:

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

2. Crie a imagem da VM começando com uma imagem de mercado especificada:

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

Aqui está um exemplo de saída:

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

Para obter mais informações sobre esse comando da CLI, consulte az stack-hci-vm image.

Portal do Azure

Siga estas etapas para criar uma imagem de VM usando o portal do Azure. No portal do Azure para seu recurso Local do Azure, execute as seguintes etapas:

1. Vá para Imagens de VM de recursos>.

2. Selecione + Adicionar Imagem de VM e, na lista suspensa, selecione Adicionar imagem de VM do Azure Marketplace.

   

3. Na página Criar uma imagem, na guia Noções básicas, insira as seguintes informações:

   1. Subscrição. Selecione uma assinatura para associar à sua imagem de VM.

   2. Grupo de recursos. Crie um novo grupo de recursos ou selecione um grupo de recursos existente que você associa à imagem da VM.

   3. Localização personalizada. Selecione um local personalizado para implantar sua imagem de VM. O local personalizado deve corresponder ao local personalizado do seu Azure Local.

   4. Imagem para download. Selecione uma imagem de VM na lista de imagens no Azure Marketplace. A lista suspensa mostra todas as imagens do Azure Marketplace que são compatíveis com seu Azure Local.

   5. Salvar imagem como. Insira um nome para sua imagem de VM.

   6. Caminho de armazenamento. Selecione o caminho de armazenamento para a imagem da VM. Selecione Escolher automaticamente para que um caminho de armazenamento com alta disponibilidade seja selecionado automaticamente. Selecione Escolher manualmente para especificar um caminho de armazenamento para armazenar imagens de VM e arquivos de configuração na instância Local do Azure. Nesse caso, verifique se o caminho de armazenamento especificado tem espaço de armazenamento suficiente.

4. Selecione Revisão + Criar para criar sua imagem de VM.

   

5. Os parâmetros de entrada são validados. Se as validações forem bem-sucedidas, você poderá revisar os detalhes da imagem da VM e selecionar Criar.

   

6. Um trabalho de implantação de modelo do Azure Resource Manager é iniciado para a imagem da VM. A implantação da imagem leva alguns minutos para ser concluída. O tempo necessário para baixar a imagem depende do tamanho da imagem do Marketplace e da largura de banda de rede disponível para o download.

   

   Você pode acompanhar a implantação da imagem na grade de imagem da VM. Você pode ver a lista das imagens da VM que já foram baixadas e as que estão sendo baixadas no sistema.

   Para exibir mais detalhes de qualquer imagem, selecione o nome da imagem da VM na lista de imagens da VM.

7. Quando o download da imagem estiver concluído, a imagem da VM aparecerá na lista de imagens e o Status será exibido como Disponível.

   

   Se o download da imagem da VM falhar, os detalhes do erro serão mostrados na folha do portal.

   

Listar imagens de VM

Você precisa exibir a lista de imagens de VM para escolher uma imagem para gerenciar.

CLI do Azure

Siga estas etapas para listar a imagem da VM usando a CLI do Azure.

1. Execute o PowerShell como um administrador.

2. Defina alguns parâmetros.

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

3. Liste todas as imagens de VM associadas ao seu Azure Local. Execute o seguinte comando:

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

   Dependendo do comando usado, um conjunto correspondente de imagens associadas ao seu Azure Local é listado.

   • Se você especificar apenas a assinatura, o comando listará todas as imagens na assinatura.
   • Se você especificar a assinatura e o grupo de recursos, o comando listará todas as imagens no grupo de recursos.

   Estas imagens incluem:

   • Imagens de VM de imagens de marketplace.
   • Imagens personalizadas que residem na sua conta de Armazenamento do Azure ou que estão numa partilha local no seu sistema ou num cliente ligado ao seu sistema.

Aqui está um exemplo de saída.

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>

Para obter mais informações sobre esse comando da CLI, consulte az stack-hci-vm image list.

Portal do Azure

No portal do Azure do seu recurso Local do Azure, você pode acompanhar a implantação da imagem da VM na grade da imagem da VM. Você pode ver a lista das imagens da VM que já foram baixadas e as que estão sendo baixadas no seu sistema.

Siga estas etapas para exibir a lista de imagens de VM no portal do Azure.

1. No portal do Azure, vá para o recurso Local do Azure.

2. Vá para > de VM de recursos.

3. No painel direito, você pode exibir a lista de imagens da VM.

   

Exibir propriedades da imagem da VM

Talvez você queira exibir as propriedades das imagens da VM antes de usá-la para criar uma VM. Siga estas etapas para exibir as propriedades da imagem:

CLI do Azure

Siga estas etapas para usar a CLI do Azure para exibir as propriedades de uma imagem:

1. Execute o PowerShell como um administrador.

2. Defina os seguintes parâmetros.

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

3. Você pode exibir as propriedades da imagem de duas maneiras diferentes: especificar ID ou especificar nome e grupo de recursos. Siga as seguintes etapas ao especificar o ID da imagem do Marketplace:

   1. Defina o seguinte parâmetro.

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

   2. Execute o seguinte comando para exibir as propriedades.

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

      Aqui está uma saída de exemplo para este 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> 
      

Portal do Azure

No portal do Azure do seu recurso Local do Azure, execute as seguintes etapas:

1. Vá para Imagens de VM de recursos>. No painel direito, uma lista de imagens de VM é exibida.

   

2. Selecione o nome da imagem da VM para exibir as propriedades.

   

Atualizar imagem da VM

Importante

As atualizações mais recentes podem levar algum tempo para refletir em suas imagens de VM à medida que validações adicionais são executadas.

Quando uma nova imagem atualizada está disponível no Azure Marketplace, as imagens da VM no seu Azure Local tornam-se obsoletas e devem ser atualizadas. A operação de atualização não é uma atualização in-loco da imagem. Em vez disso, você pode ver para quais imagens de VM uma imagem atualizada está disponível e selecionar imagens para atualizar. Após a atualização, a operação de criação de imagem de VM usa a nova imagem atualizada.

Para atualizar uma imagem de VM, use as etapas a seguir no portal do Azure.

1. Para ver se uma atualização está disponível, selecione uma imagem de VM na exibição de lista.

   

   Na folha Visão geral, você verá um banner que mostra a nova imagem da VM disponível para download, se houver uma disponível. Para atualizar para a nova imagem, selecione o ícone de seta.

   

2. Reveja os detalhes da imagem e, em seguida, selecione Rever e criar. Por padrão, a nova imagem usa o mesmo grupo de recursos e detalhes da instância que a imagem anterior.

   O nome da nova imagem é incrementado com base no nome da imagem anterior. Por exemplo, uma imagem existente chamada winServer2022-01 terá uma imagem atualizada chamada winServer2022-02.

   

3. Para concluir a operação, selecione Criar.

   

   Depois que a nova imagem da VM for criada, crie uma VM usando a nova imagem e verifique se a VM funciona corretamente. Após a verificação, você pode excluir a imagem antiga da VM.

Excluir imagem da VM

Talvez você queira excluir uma imagem de VM se o download falhar por algum motivo ou se a imagem não for mais necessária. Siga estas etapas para excluir as imagens da VM.

CLI do Azure

1. Execute o PowerShell como um administrador.

2. Defina os seguintes parâmetros:

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

3. Remova uma imagem de VM existente. Execute o seguinte comando:

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

Você pode excluir a imagem de duas maneiras:

• Especifique o nome e o grupo de recursos.
• Especifique o ID.

Depois de excluir uma imagem, você pode verificar se ela foi removida. Aqui está uma saída de exemplo quando a imagem foi excluída, especificando o nome e o grupo de recursos.

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>

Portal do Azure

No portal do Azure do seu recurso Local do Azure, execute as seguintes etapas:

1. Vá para Imagens de VM de recursos>.

2. Na lista de imagens de VM exibidas no painel direito, selecione o ícone da lixeira ao lado da imagem da VM que você deseja excluir.

   

3. Quando solicitado a confirmar a exclusão, selecione Sim.

   

Depois que a imagem da VM é excluída, a lista de imagens da VM é atualizada para refletir a imagem excluída.

Próximos passos

• Criar redes lógicas