Creación de una imagen de máquina virtual local de Azure mediante imágenes de Azure Marketplace

Se aplica a: Azure Local, versión 23H2

En este artículo se describe cómo crear imágenes de máquina virtual (VM) para Azure Local mediante imágenes de origen de Azure Marketplace. Puede crear imágenes de máquina virtual mediante Azure Portal o la CLI de Azure y, a continuación, usar estas imágenes de máquina virtual para crear máquinas virtuales de Arc en Azure Local.

Importante

Las actualizaciones más recientes pueden tardar algún tiempo en reflejarse en las imágenes de máquina virtual a medida que se realizan validaciones adicionales.

Requisitos previos

Antes de comenzar, asegúrese de que se completan los siguientes requisitos previos.

CLI de Azure

• Asegúrese de revisar y completar los requisitos previos.

• Si usa un cliente para conectarse a la instancia local de Azure, consulte Conexión al sistema de forma remota.

Azure Portal

Asegúrese de revisar y completar los requisitos previos.

Adición de una imagen de máquina virtual desde Azure Marketplace

Cree una imagen de máquina virtual a partir de una imagen de Azure Marketplace y, a continuación, use esta imagen para implementar máquinas virtuales en la instancia local de Azure.

CLI de Azure

Siga estos pasos para crear una imagen de máquina virtual mediante la CLI de Azure.

Inicio de sesión y establecimiento de la suscripción

1. Conéctese a una máquina en Azure Local.

2. Inicia sesión. Escriba:

   az login --use-device-code
   

3. Establezca la suscripción.

   az account set --subscription <Subscription ID>
   

Configure algunos parámetros.

1. Establezca parámetros para la suscripción, el grupo de recursos, la ubicación, el tipo de sistema operativo para la imagen. Reemplace los parámetros de < > por los valores adecuados.

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

   Los parámetros se describen en la tabla siguiente:

   Parámetro	Descripción
   subscription	Suscripción asociada a Azure Local.
   resource-group	Grupo de recursos para la instancia local de Azure que asocia a esta imagen.
   name	Nombre de la imagen de Marketplace para Azure Local.
   customLocation	Identificador de recurso de la ubicación personalizada para Azure Local.
   location	Ubicación de Azure Local. Por ejemplo, podría ser eastus.
   os-type	Sistema operativo asociado a la imagen de origen. Puede ser Windows o Linux.

   Este es una salida de ejemplo:

   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"
   

Creación de una imagen de máquina virtual a partir de una imagen de Marketplace

1. Establezca parámetros adicionales que especifiquen la imagen de máquina virtual deseada que desea crear. Deberá incluir la oferta, el publicador, la SKU y la versión de la imagen de Marketplace. Reemplace los parámetros de por <> los valores adecuados:

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

   Use la tabla siguiente para buscar las imágenes de Marketplace disponibles y sus valores de atributo:

   Nombre	Publicador	Oferta	SKU
   Windows 11 Empresas multisesión + Microsoft 365	microsoftwindowsdesktop	office-365	win11-21h2-avd-m365 win11-23h2-avd-m365
   Sesión múltiple de Windows 10 Enterprise + 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
   Sesión múltiple de Windows 11 Enterprise	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
   Sesión múltiple de Windows 10 Enterprise	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 en Windows Server 2022	microsoftsqlserver	sql2022-ws2022	enterprise-gen2 standard-gen2

   Si desea crear una imagen de Windows Server 2019 Datacenter, tendría los parámetros siguientes:

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

2. Cree la imagen de máquina virtual a partir de una imagen de Marketplace 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 
   

Este es una salida de ejemplo:

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 más información sobre este comando de la CLI, consulte az stack-hci-vm image.

Azure Portal

Siga estos pasos para crear una imagen de máquina virtual mediante Azure Portal. En Azure Portal para el recurso local de Azure, siga estos pasos:

1. Vaya a Imágenes de máquina virtual de recursos>.

2. Seleccione + Agregar imagen de máquina virtual y, en la lista desplegable, seleccione Agregar imagen de máquina virtual desde Azure Marketplace.

   

3. En la página Crear una imagen , en la pestaña Aspectos básicos , escriba la siguiente información:

   1. Suscripción. Seleccione una suscripción para asociarla a la imagen de máquina virtual.

   2. Grupo de recursos. Cree nuevo o seleccione un grupo de recursos existente que asocie a la imagen de máquina virtual.

   3. Ubicación personalizada. Seleccione una ubicación personalizada para implementar la imagen de máquina virtual. La ubicación personalizada debe corresponder a la ubicación personalizada de Azure Local.

   4. Imagen que se va a descargar. Seleccione una imagen de máquina virtual en la lista de imágenes de Azure Marketplace. En la lista desplegable se muestran todas las imágenes de Azure Marketplace que son compatibles con Azure Local.

   5. Guarde la imagen como. Escriba un nombre para la imagen de máquina virtual.

   6. Ruta de acceso de almacenamiento. Seleccione la ruta de acceso de almacenamiento de la imagen de máquina virtual. Seleccione Elegir automáticamente para tener una ruta de acceso de almacenamiento con alta disponibilidad seleccionada automáticamente. Seleccione Elegir manualmente para especificar una ruta de acceso de almacenamiento para almacenar imágenes de máquina virtual y archivos de configuración en la instancia local de Azure. En este caso, asegúrese de que la ruta de acceso de almacenamiento especificada tenga suficiente espacio de almacenamiento.

4. Seleccione Revisar y crear para crear la imagen de máquina virtual.

   

5. Los parámetros de entrada se validan. Si las validaciones se realizan correctamente, puede revisar los detalles de la imagen de máquina virtual y seleccionar Crear.

   

6. Se inicia un trabajo de implementación de plantillas de Azure Resource Manager para la imagen de máquina virtual. La implementación de la imagen tarda unos minutos en completarse. El tiempo necesario para descargar la imagen depende del tamaño de la imagen de Marketplace y del ancho de banda de red disponible para la descarga.

   

   Puede realizar un seguimiento de la implementación de imágenes en la cuadrícula de imágenes de máquina virtual. Puede ver la lista de las imágenes de máquina virtual que ya están descargadas y las que se están descargando en el sistema.

   Para ver más detalles de cualquier imagen, seleccione el nombre de la imagen de máquina virtual en la lista de imágenes de máquina virtual.

7. Una vez completada la descarga de la imagen, la imagen de máquina virtual se muestra en la lista de imágenes y el estado se muestra como Disponible.

   

   Si se produce un error en la descarga de la imagen de máquina virtual, los detalles del error se muestran en la hoja del portal.

   

Enumeración de imágenes de máquina virtual

Debe ver la lista de imágenes de máquina virtual para elegir una imagen que se va a administrar.

CLI de Azure

Siga estos pasos para enumerar la imagen de máquina virtual mediante la CLI de Azure.

1. Ejecute PowerShell como administrador.

2. Configure algunos parámetros.

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

3. Enumere todas las imágenes de máquina virtual asociadas a Azure Local. Ejecute el siguiente comando:

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

   Según el comando usado, se mostrará un conjunto correspondiente de imágenes asociadas a Azure Local.

   • Si especifica solo la suscripción, el comando muestra todas las imágenes de la suscripción.
   • Si especifica tanto la suscripción como el grupo de recursos, el comando muestra todas las imágenes del grupo de recursos.

   Estas imágenes incluyen:

   • Imágenes de máquina virtual de imágenes de Marketplace.
   • Imágenes personalizadas que residen en su cuenta de Azure Storage o están en un recurso compartido local en el sistema o en un cliente conectado al sistema.

Esta es una salida de ejemplo.

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 más información sobre este comando de la CLI, consulte az stack-hci-vm image list.

Azure Portal

En Azure Portal del recurso local de Azure, puede realizar un seguimiento de la implementación de la imagen de máquina virtual en la cuadrícula de imágenes de máquina virtual. Puede ver la lista de las imágenes de máquina virtual que ya están descargadas y las que se están descargando en el sistema.

Siga estos pasos para ver la lista de imágenes de máquina virtual en Azure Portal.

1. En Azure Portal, vaya al recurso local de Azure.

2. Vaya a Imágenes de máquina virtual de recursos>.

3. En el panel derecho, puede ver la lista de imágenes de máquina virtual.

   

Visualización de las propiedades de la imagen de máquina virtual

Es posible que desee ver las propiedades de las imágenes de máquina virtual antes de usar la imagen para crear una máquina virtual. Siga estos pasos para ver las propiedades de la imagen:

CLI de Azure

Siga estos pasos para usar la CLI de Azure para ver las propiedades de una imagen:

1. Ejecute PowerShell como administrador.

2. Establezca los parámetros siguientes.

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

3. Puede ver las propiedades de la imagen de dos maneras diferentes: especificar el identificador o especificar el nombre y el grupo de recursos. Siga estos pasos al especificar el identificador de imagen de Marketplace:

   1. Establezca el siguiente parámetro.

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

   2. Ejecute el siguiente comando para ver las propiedades.

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

      Esta es una salida de ejemplo 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> 
      

Azure Portal

En Azure Portal del recurso local de Azure, realice los pasos siguientes:

1. Vaya a Imágenes de máquina virtual de recursos>. En el panel derecho, se muestra una lista de imágenes de máquina virtual.

   

2. Seleccione el nombre de la imagen de máquina virtual para ver las propiedades.

   

Actualización de la imagen de máquina virtual

Cuando hay disponible una nueva imagen actualizada en Azure Marketplace, las imágenes de máquina virtual de Azure Local se vuelven obsoletas y deben actualizarse. La operación de actualización no es una actualización local de la imagen. En su lugar, puede ver en qué imágenes de máquina virtual está disponible una imagen actualizada y seleccionar las imágenes que desea actualizar. Después de actualizar, la operación crear imagen de máquina virtual usa la nueva imagen actualizada.

Para actualizar una imagen de máquina virtual, siga estos pasos en Azure Portal.

1. Para ver si hay una actualización disponible, seleccione una imagen de máquina virtual en la vista de lista.

   

   En la hoja Información general , verá un banner que muestra la nueva imagen de máquina virtual disponible para su descarga, si hay una disponible. Para actualizar a la nueva imagen, seleccione el icono de flecha.

   

2. Revise los detalles de la imagen y, a continuación, seleccione Revisar y crear. De forma predeterminada, la nueva imagen usa los mismos detalles de instancia y grupo de recursos que la imagen anterior.

   El nombre de la nueva imagen se incrementa en función del nombre de la imagen anterior. Por ejemplo, una imagen existente denominada winServer2022-01 tendrá una imagen actualizada denominada winServer2022-02.

   

3. Para completar la operación, seleccione Crear.

   

   Una vez creada la nueva imagen de máquina virtual, cree una máquina virtual con la nueva imagen y compruebe que la máquina virtual funciona correctamente. Después de la comprobación, puede eliminar la imagen de máquina virtual antigua.

   Nota:

   En esta versión, no se puede eliminar una imagen de máquina virtual si la máquina virtual asociada a esa imagen se está ejecutando. Detenga la máquina virtual y elimine la imagen de la máquina virtual.

Eliminación de la imagen de máquina virtual

Es posible que quiera eliminar una imagen de máquina virtual si se produce un error en la descarga por algún motivo o si la imagen ya no es necesaria. Siga estos pasos para eliminar las imágenes de máquina virtual.

CLI de Azure

1. Ejecute PowerShell como administrador.

2. Establezca los siguientes parámetros:

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

3. Quite una imagen de máquina virtual existente. Ejecute el siguiente comando:

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

Puede eliminar la imagen de dos maneras:

• Especifique el nombre y el grupo de recursos.
• Especifique el identificador.

Después de eliminar una imagen, puede comprobar que la imagen se quita. Esta es una salida de ejemplo cuando se eliminó la imagen especificando el nombre y el 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>

Azure Portal

En Azure Portal del recurso local de Azure, realice los pasos siguientes:

1. Vaya a Imágenes de máquina virtual de recursos>.

2. En la lista de imágenes de máquina virtual que se muestran en el panel derecho, seleccione el icono de papelera junto a la imagen de máquina virtual que desea eliminar.

   

3. Cuando se le pida que confirme la eliminación, seleccione Sí.

   

Una vez eliminada la imagen de máquina virtual, la lista de imágenes de máquina virtual se actualiza para reflejar la imagen eliminada.

Pasos siguientes

• Creación de redes lógicas