Crear un catálogo de AWS

(/es-es/citrix-virtual-apps-desktops/2411/install-configure/machine-catalogs-create.html) describe los asistentes que crean un catálogo de máquinas. La siguiente información cubre detalles específicos de los entornos de virtualización de AWS.

Nota:

Antes de crear un catálogo de AWS, debe terminar de crear una conexión a AWS. Consulte (/es-es/citrix-virtual-apps-desktops/2411/install-configure/connections/connection-aws.html).

Limitación

A partir de Citrix Virtual Apps and Desktops™ 2203 LTSR y versiones posteriores, el complemento MCS AWS realiza la llamada a la API de AWS DescribeInstanceTypes y, si tiene éxito, MCS utiliza el nombre de inventario creado a partir de la respuesta de la API.

Por lo tanto, cuando actualice de CVAD 1912 a 2203 o posterior, inhabilite el permiso DefineInstanceType en AWS y, a continuación, actualice el catálogo existente mediante el comando Set-ProvScheme para que coincida con el esquema de nomenclatura de AWS. Después, vuelva a añadir los permisos DescribeInstanceType una vez completada la actualización del catálogo y la oferta de servicio coincida con el esquema de nomenclatura de AWS.

Configuración de red durante la preparación de la imagen

Durante la preparación de la imagen, se crea una máquina virtual (VM) de preparación basada en la VM original. Esta VM de preparación se desconecta de la red. Para desconectar la red de la VM de preparación, se crea un grupo de seguridad de red para denegar todo el tráfico entrante y saliente. Este grupo de seguridad de red persiste y se reutiliza. El nombre del grupo de seguridad de red es Citrix.XenDesktop.IsolationGroup-GUID, donde GUID se genera aleatoriamente.

Configurar la tenencia de AWS

AWS ofrece las siguientes opciones de tenencia:

• Tenencia compartida (el tipo predeterminado): Varias instancias de Amazon EC2 de diferentes clientes pueden residir en la misma pieza de hardware físico.
• Tenencia dedicada: Sus instancias EC2 se ejecutan solo en hardware con otras instancias que usted ha implementado. Otros clientes no utilizan la misma pieza de hardware.

Puede usar MCS para aprovisionar hosts dedicados de AWS mediante PowerShell.

Configurar la tenencia de hosts dedicados de AWS mediante PowerShell

Puede crear un catálogo de máquinas con la tenencia de host definida a través de PowerShell.

Un host dedicado de Amazon [EC2] es un servidor físico con capacidad de instancia [EC2] totalmente dedicada, lo que le permite usar licencias de software existentes por socket o por máquina virtual.

Los hosts dedicados tienen una utilización preestablecida basada en el tipo de instancia. Por ejemplo, un único host dedicado asignado de tipos de instancia C4 Large está limitado a ejecutar 16 instancias. Consulte el sitio de AWS para obtener más información.

Los requisitos para el aprovisionamiento en hosts de AWS incluyen:

• Una imagen BYOL (traiga su propia licencia) importada (AMI). Con los hosts dedicados, use y administre sus licencias existentes.
• Una asignación de hosts dedicados con suficiente utilización para satisfacer las solicitudes de aprovisionamiento.
• Habilitar la ubicación automática.

Para aprovisionar en un host dedicado en AWS mediante PowerShell, utilice el cmdlet New-ProvScheme con el parámetro TenancyType establecido en Host.

Consulte la documentación para desarrolladores de Citrix para obtener más información.

Capturar propiedades de máquina de las AMI

Cuando crea un catálogo para aprovisionar máquinas mediante Machine Creation Services (MCS) en AWS, selecciona una AMI para representar la imagen maestra/dorada de ese catálogo. A partir de esa AMI, MCS utiliza una instantánea del disco. En versiones anteriores, si quería roles o etiquetas en sus máquinas, utilizaba la consola de AWS para configurarlos individualmente. Esta funcionalidad está habilitada de forma predeterminada.

Sugerencia:

Para usar la captura de propiedades de instancia de AWS, debe tener una máquina virtual asociada a la AMI.

Para mejorar este proceso, MCS lee las propiedades de la instancia de la que se tomó la AMI y aplica el rol de Identity Access Management (IAM) y las etiquetas de la máquina a las máquinas aprovisionadas para un catálogo determinado. Al usar esta función opcional, el proceso de creación del catálogo encuentra la instancia de origen de la AMI seleccionada, leyendo un conjunto limitado de propiedades. Estas propiedades se almacenan luego en una plantilla de lanzamiento de AWS, que se utiliza para aprovisionar máquinas para ese catálogo. Cualquier máquina del catálogo hereda las propiedades de instancia capturadas.

Las propiedades capturadas incluyen:

• Roles de IAM – aplicados a las instancias aprovisionadas.
• Etiquetas: aplicadas a las instancias aprovisionadas, sus discos y sus NIC. Estas etiquetas se aplican a los recursos transitorios de Citrix®, incluidos: cubos y objetos de S3, e AMI, instantáneas y plantillas de lanzamiento.

Consejo:

El etiquetado de los recursos transitorios de Citrix es opcional y se puede configurar mediante la propiedad personalizada AwsOperationalResourcesTagging.

Capturar la propiedad de instancia de AWS

Puede usar esta función especificando una propiedad personalizada, AwsCaptureInstanceProperties, al crear un esquema de aprovisionamiento para una conexión de alojamiento de AWS:

New-ProvScheme -CustomProperties "AwsCaptureInstanceProperties,true" …<standard provscheme parameters

Consulte la Citrix Developer Documentation para obtener más información.

Nota:

La AwsCaptureInstanceProperties está en desuso. En su lugar, recomendamos usar perfiles de máquina para especificar las propiedades de las máquinas virtuales.

Capturar propiedades de máquina a partir de perfiles de máquina

Al crear un catálogo para aprovisionar máquinas AWS mediante MCS, puede usar un perfil de máquina para preestablecer ciertas configuraciones de propiedades de máquina.

Para ello, siga estos pasos:

1. Almacene los perfiles de máquina en la misma zona de disponibilidad que los recursos donde está creando este catálogo.
2. En la página Machine Template del asistente de creación de catálogos, seleccione Use a machine profile. Se muestran los perfiles de máquina que se encuentran en la misma zona disponible que los recursos seleccionados.
3. Seleccione un perfil de máquina según sea necesario.

Nota:

Puede usar un perfil de máquina o una AMI para capturar las propiedades de la máquina. En Web Studio, al seleccionar Usar un perfil de máquina, la opción Aplicar propiedades de plantilla de máquina a máquinas virtuales se oculta automáticamente.

Etiquetar recursos operativos de AWS

Al crear un catálogo para aprovisionar máquinas en AWS mediante MCS, puede controlar si se aplican las propiedades de rol de IAM y de etiqueta a esas máquinas. También puede controlar si se aplican etiquetas de máquina a los recursos operativos.

Una Amazon Machine Image (AMI) representa un tipo de dispositivo virtual que se utiliza para crear una máquina virtual dentro del entorno de Amazon Cloud, comúnmente conocido como EC2. Se utiliza una AMI para implementar servicios que utilizan el entorno EC2. Al crear un catálogo para aprovisionar máquinas mediante MCS para AWS, se selecciona la AMI para que actúe como imagen de oro para ese catálogo.

Importante:

La creación de catálogos mediante la captura de una propiedad de instancia y una plantilla de inicio es necesaria para utilizar el etiquetado de recursos operativos.

Para crear un catálogo de AWS, primero debe crear una AMI para la instancia que desea que sea la imagen de oro. MCS lee las etiquetas de esa instancia y las incorpora a la plantilla de inicio. Las etiquetas de la plantilla de inicio se aplican a todos los recursos de Citrix creados en su entorno de AWS, incluidos:

• Máquinas virtuales
• Discos de VM
• Interfaces de red de VM
• Buckets de S3
• Objetos de S3
• Plantillas de inicio
• AMI

Etiquetar un recurso operativo

Para usar PowerShell para etiquetar recursos:

1. Abra una ventana de PowerShell desde el host DDC.
2. Ejecute el comando asnp citrix para cargar los módulos de PowerShell específicos de Citrix.

Para etiquetar un recurso para una VM aprovisionada, utilice la nueva propiedad personalizada AwsOperationalResourcesTagging. La sintaxis de esta propiedad es:

New-ProvScheme -CustomProperties "AwsCaptureInstanceProperties,true; AwsOperationalResourcesTagging,true" …<standard provscheme parameters>

Copiar etiquetas en máquinas virtuales

Puede copiar etiquetas en NIC y discos (disco de identidad, disco de caché de escritura y disco del sistema operativo) que se especifican en el perfil de máquina a las máquinas virtuales recién creadas en un catálogo de máquinas MCS. Puede especificar estas etiquetas en cualquiera de las fuentes del perfil de máquina (instancia de VM de AWS o versión de plantilla de lanzamiento de AWS). Esta función es aplicable a catálogos de máquinas y máquinas virtuales persistentes y no persistentes.

Nota:

• En la consola de AWS EC2, no puede ver los valores de Etiquetar interfaces de red en Etiquetas de recursos de la versión de la plantilla de lanzamiento. Sin embargo, puede ejecutar el comando de PowerShell aws ec2 describe-launch-template-versions --launch-template-id lt-0bb652503d45dcbcd --versions 12 para ver las especificaciones de las etiquetas.
• Si una fuente de perfil de máquina (VM o versión de plantilla de lanzamiento) tiene dos interfaces de red (eni-1 y eni-2), y eni-1 tiene la etiqueta t1 y eni-2 tiene la etiqueta t2, entonces la VM obtiene las etiquetas de ambas interfaces de red.

Crear un catálogo utilizando un perfil de máquina

Puede utilizar un perfil de máquina para capturar las propiedades de hardware de una instancia EC2 (VM) o de una versión de plantilla de lanzamiento y aplicarlas a las máquinas aprovisionadas. Las propiedades capturadas pueden incluir, por ejemplo, propiedades de volumen EBS, tipo de instancia, optimización EBS, opciones de CPU, tipo de tenencia, capacidad de hibernación y otras configuraciones de AWS compatibles.

Puede utilizar una instancia EC2 de AWS (VM) o una versión de plantilla de lanzamiento de AWS como entrada del perfil de máquina.

Nota:

• Las propiedades del volumen EBS se derivan únicamente de un perfil de máquina.
• MCS aprovisiona las VM con discos de identidad de tipo de volumen GP3. Como el tipo de volumen GP3 es la opción más económica que ofrece AWS, esta función minimiza los costes. La implementación solo se aplica a las VM añadidas a un catálogo nuevo y a las VM nuevas añadidas a un catálogo existente. Las VM existentes creadas antes de esta función seguirán teniendo discos de identidad con tipo de volumen GP2, a menos que se restablezca el disco de identidad.

Consideraciones importantes

Consideraciones importantes al crear un catálogo de máquinas MCS:

• Si agrega parámetros de propiedades de hardware de máquina en los comandos New-ProvScheme y Set-ProvScheme, los valores proporcionados en los parámetros sobrescriben los valores del perfil de máquina.
• Si establece AwsCaptureInstanceProperties como true y no establece la propiedad MachineProfile, solo se capturan los roles y las etiquetas de IAM.

• No puede establecer AwsCaptureInstanceProperties y MachineProfile al mismo tiempo.

  **Nota:

  El AwsCaptureInstanceProperties está obsoleto.

• Si no se proporciona un perfil de máquina, debe proporcionar explícitamente los valores de las siguientes propiedades:

  • Grupo de seguridad
  • ENI o red virtual
• Puede habilitar AwsOperationalResourcesTagging solo si habilita AwsCaptureInstanceProperties o especifica un perfil de máquina.

Consideraciones importantes después de crear un catálogo de máquinas MCS:

• No se puede cambiar un catálogo de basado en perfil de máquina a un catálogo no basado en perfil de máquina.

Crear un catálogo de máquinas mediante un perfil de máquina

Para crear un catálogo de máquinas mediante un perfil de máquina:

1. Abra una ventana de PowerShell.
2. Ejecute asnp citrix* para cargar los módulos de PowerShell específicos de Citrix.

3. Cree un grupo de identidades si aún no se ha creado. Por ejemplo,

   New-AcctIdentityPool -IdentityPoolName idPool -NamingScheme ms## -Domain abcdf -NamingSchemeType Numeric
   <!--NeedCopy-->
   

4. Ejecute el comando New-ProvScheme. Por ejemplo:

   New-ProvScheme -ProvisioningSchemeName demet-test-1
   -HostingUnitUid aa633238-9xxd-4cf6-80e8-232a758a1xx1
   -IdentityPoolUid 34d5b088-e312-416f-907d-16573xxxxxc4
   -CleanOnBoot
   -MasterImageVM 'XDHyp:\HostingUnits\cvad-test-scalestress\citrix-demet-ami.0 (ami-0ca813xxxxxx061ef).template'
   -MachineProfile 'XdHyp:\HostingUnits\cvad-test-scalestress\us-east-1a.availabilityzone\machine-profile-instance i (i-0xxxxxxxx).vm'
   <!--NeedCopy-->
   

5. Termine de crear el catálogo. Para obtener más información, consulte Citrix PowerShell SDK.

Actualizar el perfil de máquina

Para actualizar el perfil de máquina en un catálogo que se aprovisionó inicialmente con un perfil de máquina, haga lo siguiente. También puede cambiar el tipo de tenencia y la capacidad de hibernación del origen del perfil de máquina al editar un catálogo de máquinas MCS.

1. Ejecute el comando Set-ProvScheme. Por ejemplo,

   Set-ProvScheme `
   -ProvisioningSchemeUid "<ID" `
   -MachineProfile "XDHyp:\HostingUnits\abc\us-east-1a.availabilityzone\citrix-cvad-machineprofile-instance (i-0xxxxxxxx).vm"
   <!--NeedCopy-->
   

Crear un catálogo con la versión de la plantilla de lanzamiento

Puede crear un catálogo de máquinas MCS con una versión de plantilla de lanzamiento como entrada de perfil de máquina. También puede actualizar la entrada de un catálogo de perfiles de máquina de una VM a una versión de plantilla de lanzamiento y de una versión de plantilla de lanzamiento a una VM.

En la consola de AWS EC2, puede proporcionar la información de configuración de la instancia de una plantilla de lanzamiento junto con el número de versión. Cuando especifica la versión de la plantilla de lanzamiento como entrada de perfil de máquina al crear o actualizar un catálogo de máquinas, las propiedades de esa versión de la plantilla de lanzamiento se copian en las VM VDA aprovisionadas.

Las siguientes propiedades se pueden proporcionar mediante la entrada del perfil de máquina o explícitamente como parámetros en los comandos New-ProvScheme o Set-ProvScheme. Si se proporcionan en los comandos New-ProvScheme o Set-ProvScheme, tienen prioridad sobre los valores del perfil de máquina de estas propiedades.

• Oferta de servicio
• Redes
• Grupos de seguridad
• Tipo de tenencia

Nota:

Si la oferta de servicio no se proporciona en la plantilla de lanzamiento del perfil de máquina o como parámetro en el comando New-ProvScheme, recibirá un error apropiado.

Para crear un catálogo utilizando la versión de la plantilla de lanzamiento como entrada de perfil de máquina:

1. Abra una ventana de PowerShell.
2. Ejecute asnp citrix* para cargar los módulos de PowerShell específicos de Citrix.

3. Obtenga la lista de versiones de la plantilla de lanzamiento de una plantilla de lanzamiento. Por ejemplo:

   XDHyp:\HostingUnits\test\test-mp-sard (lt-01xxxxx).launchtemplate> ls | Select FullPath
   <!--NeedCopy-->
   

4. Cree un grupo de identidades si no se ha creado. Por ejemplo:

   New-AcctIdentityPool `
   -IdentityPoolName "abc11" `
   -NamingScheme "abc1-##" `
   -NamingSchemeType Numeric `
   -Domain "citrix-xxxxxx.local" `
   -ZoneUid "xxxxxxxx" `
   <!--NeedCopy-->
   

5. Cree un esquema de aprovisionamiento con una versión de plantilla de lanzamiento como entrada de perfil de máquina. Por ejemplo:

   New-ProvScheme `
   -ProvisioningSchemeName "MPLT1" `
   -HostingUnitUid "c7f71f6a-3f45-4xxx-xxxx-xxxxxxxxxx" `
   -IdentityPoolUid "bf3a6ba2-1f80-4xxx-xxxx-xxxxxxxxx" `
   -MasterImageVM "XDHyp:\HostingUnits\xxxd-ue1a\apollo-non-persistent-vda-win2022 (ami-0axxxxxxxxxxx).template" `
   -CleanOnBoot `
   -MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-01xxxxx).launchtemplate\lt-01xxxxx (1).launchtemplateversion"
   <!--NeedCopy-->
   

6. Registre el esquema de aprovisionamiento como un catálogo de intermediario. Por ejemplo:

   New-BrokerCatalog -Name "MPLT1" `
   -AllocationType Random `
   -Description "Machine profile catalog" `
   -ProvisioningSchemeId fe7df345-244e-4xxxx-xxxxxxxxx `
   -ProvisioningType Mcs `
   -SessionSupport MultiSession `
   -PersistUserChanges Discard
   <!--NeedCopy-->
   

7. Complete la creación del catálogo. Para obtener más información, consulte Citrix PowerShell SDK

También puede actualizar la entrada de un catálogo de perfil de máquina de una VM a una versión de plantilla de lanzamiento y de una versión de plantilla de lanzamiento a una VM. Por ejemplo:

• Para actualizar la entrada de un catálogo de perfiles de máquina de una VM a una versión de plantilla de lanzamiento:

   Set-ProvScheme -ProvisioningSchemeName "CloudServiceOfferingTest" `
   -MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-0bxxxxxxxxxxxx).launchtemplate\lt-0bxxxxxxxxxxxx (1).launchtemplateversion"
   <!--NeedCopy-->
  

• Para actualizar la entrada de un catálogo de perfiles de máquina de una versión de plantilla de lanzamiento a una VM:

   Set-ProvScheme -ProvisioningSchemeName "CloudServiceOfferingTest" `
   -MachineProfile "XDHyp:\HostingUnits\sard-ue1a\us-east-1a.availabilityzone\apollo-non-persistent-vda-win2022-2 (i-08xxxxxxxxx).vm"
   <!--NeedCopy-->
  

Cifrar discos de SO e ID

Puede crear catálogos de máquinas virtuales persistentes y no persistentes con claves AWS KMS (clave administrada por el cliente y clave administrada por AWS) que se pueden usar para cifrar el disco del SO y el disco de identidad.

• Las claves administradas por AWS se rotan automáticamente cada año.
• Las claves administradas por el cliente son opcionales para la rotación automática y se pueden administrar manualmente.

Puede consultar los siguientes documentos de AWS para obtener más información sobre las claves KMS:

• Conceptos de AWS KMS
• Cómo funciona la rotación automática de claves.

Para el cifrado de discos de SO e ID, configure una de las siguientes opciones:

• Utilice una imagen maestra cifrada (por ejemplo, una AMI creada a partir de una instancia o instantánea que contenga un volumen raíz de EBS cifrado con una clave KMS)
• Utilice un origen de perfil de máquina (VM o plantilla de lanzamiento) que contenga un volumen raíz de EBS cifrado.

Limitaciones

Tenga en cuenta las siguientes limitaciones:

• Actualmente, MCS solo admite un disco en la AMI de imagen maestra.

• No puede cifrar directamente volúmenes o instantáneas de EBS existentes sin cifrar, ni modificar la clave KMS de un volumen cifrado existente. Para ello, debe:

  1. Crear una nueva instantánea de ese volumen.
  2. Crear un nuevo volumen a partir de esa instantánea.
  3. Cifrar el nuevo volumen.

Consulte los siguientes documentos de AWS:

• Cifrar recursos sin cifrar
• Limitaciones del cifrado automático o predeterminado de volúmenes EBS: Cifrar automáticamente volúmenes de Amazon EBS existentes y nuevos.

Crear un catálogo con cifrado de disco

Puede crear un catálogo de máquinas MCS con cifrado de disco mediante:

• Imagen maestra
• Perfil de máquina

Consideraciones al usar la entrada del perfil de máquina para el cifrado de disco:

• La clave KMS de la entrada del perfil de máquina tiene prioridad sobre la clave KMS de la imagen maestra.
• Si no se proporciona ninguna entrada de perfil de máquina, se utiliza la clave KMS de la AMI de la imagen maestra para cifrar los discos de las máquinas virtuales del catálogo.
• Si el perfil de máquina tiene asignaciones de dispositivos de bloque presentes, los dispositivos de bloque presentes en la plantilla de imagen maestra (AMI) y el perfil de máquina deben coincidir. Por ejemplo, si la AMI tiene un dispositivo definido en /dev/sda1, el perfil de máquina también debe tener un dispositivo definido en /dev/sda1.
• Si no hay ninguna clave en el origen del perfil de la máquina y la imagen maestra no está cifrada, los discos de las VM del catálogo no se cifran.
• Cuando la imagen maestra está cifrada, una VM de origen de perfil de máquina o una plantilla de lanzamiento debe tener un volumen raíz cifrado para considerarse una entrada válida.

Modificar un catálogo existente

Puede modificar un catálogo existente mediante Set-ProvScheme para tener:

• Una entrada de perfil de máquina con un volumen que contenga una nueva clave KMS.
• Una AMI de plantilla de imagen maestra cifrada con una nueva clave KMS.

Consideraciones importantes

• Los volúmenes de las nuevas VM añadidas al catálogo se cifran con la nueva clave KMS.
• Para actualizar la configuración de cifrado cuando ya existe un perfil de máquina, ejecute Set-ProvScheme con un nuevo perfil de máquina.
• No puede modificar un catálogo existente para pasar de tener volúmenes cifrados a volúmenes sin cifrar. No puede realizar una actualización de imagen de una AMI maestra cifrada a una AMI maestra sin cifrar.

Habilitar NitroTPM y el arranque seguro UEFI para instancias de VM

Al crear un catálogo, ahora puede seleccionar una imagen maestra (AMI) con NitroTPM y/o arranque seguro UEFI habilitados. En consecuencia, las VM aprovisionadas en el catálogo también se habilitan con NitroTPM y/o arranque seguro UEFI. Esta implementación garantiza que las VM estén protegidas y sean de confianza. Para obtener más información sobre NitroTPM y el arranque seguro UEFI, consulte la documentación de Amazon.

Limitaciones

• Actualmente, puede usar NitroTPM y el arranque seguro en todas las regiones de AWS (incluidas las regiones de AWS GovCloud (EE. UU.)) excepto China.
• No puede habilitar NitroTPM y el arranque seguro UEFI en catálogos existentes. Si desea un catálogo con NitroTPM y el arranque seguro UEFI habilitados, cree un nuevo catálogo.

Pasos clave

1. Configure su entorno de AWS.
2. Cree una conexión a AWS.
3. Cree una imagen maestra (AMI) con NitroTPM y/o arranque seguro UEFI habilitados.
4. Cree un catálogo de máquinas seleccionando la imagen maestra con NitroTPM y arranque seguro UEFI habilitados en el menú de creación de catálogos de Web Studio o al crear un esquema de aprovisionamiento mediante comandos de PowerShell.

Las máquinas virtuales añadidas al catálogo creado tienen NitoTPM y arranque seguro UEFI habilitados.

Cree una AMI que admita NitroTPM y arranque seguro UEFI

1. Puede crear una AMI a partir de una máquina virtual que tenga NitroTPM y/o arranque seguro UEFI habilitados.

   1. Cree la instancia a partir de las imágenes del marketplace de AWS. Por ejemplo, busque TPM-Windows_Server-2022-English-Full-Base on the aws-marketplace.
   2. Descargue VDA de sesión única o múltiple.
   3. Cree una AMI a partir de esa máquina virtual.

2. Utilice el comando register-image:

   --boot-mode (string)
   --tpm-support (string)
   <!--NeedCopy-->
   

   Para obtener más información, consulte register-image.

Consulte los siguientes documentos de AWS:

• Determine los modos de arranque admitidos de un tipo de instancia EC2
• Requisitos para usar NitroTPM con instancias de Amazon EC2(https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/enable-nitrotpm-prerequisites.html)/.

Puede abrir una ventana de PowerShell desde el host de Delivery Controller™ para comprobar si un elemento específico:

• la oferta de servicio admite NitroTPM o el arranque seguro UEFI

   (Get-Item -Path “XDHyp:\HostingUnits\aws\T3 Medium Instance.serviceoffering”).AdditionalData.BootMode
   (Get-Item -Path “XDHyp:\HostingUnits\aws\T3 Medium Instance.serviceoffering”).AdditionalData.NitroTpmSupportVersions
   <!--NeedCopy-->
  

• la plantilla admite NitroTPM o el arranque seguro UEFI

   (Get-HypInventoryItem -LiteralPath “XDHyp:\HostingUnits\aws” -ResourceType “template -Id “ID”).AdditionalData.BootMode
  
   (Get-HypInventoryItem -LiteralPath “XDHyp:\HostingUnits\aws” -ResourceType “template -Id “ID”).AdditionalData.TpmSupport
   <!--NeedCopy-->
  

Actualizar la oferta de servicio del catálogo existente

Puede cambiar la oferta de servicio de un catálogo existente mediante Set-ProvScheme. El cambio se aplica a las máquinas virtuales recién agregadas. Sin embargo, se producen errores en los siguientes escenarios:

Filtrar instancias de VM

Una instancia de AWS EC2 que utilice como VM de perfil de máquina debe ser compatible para que el catálogo de máquinas se cree y funcione correctamente. Para enumerar las instancias de AWS EC2 que se pueden usar como VM de entrada de perfil de máquina, puede usar el comando Get-HypInventoryItem. El comando puede paginar y filtrar el inventario de VM disponibles en una unidad de alojamiento.

Paginación:

Get-HypInventoryItem admite dos modos de paginación:

• El modo de paginación utiliza los parámetros -MaxRecords y -Skip para devolver conjuntos de elementos:
  • -MaxRecords: El valor predeterminado es 1. Esto controla cuántos elementos se devuelven.
  • -Skip: El valor predeterminado es 0. Esto controla cuántos elementos se omiten desde el principio absoluto (o el final absoluto) de la lista en el hipervisor.
• El modo de desplazamiento utiliza los parámetros -MaxRecords, -ForwardDirection y -ContinuationToken para permitir el desplazamiento de los registros:
  • -ForwardDirection: El valor predeterminado es True. Se utiliza junto con -MaxRecords para devolver el siguiente conjunto de registros coincidentes o el conjunto anterior de registros coincidentes.
  • -ContinuationToken: Devuelve los elementos inmediatamente posteriores (o anteriores si ForwardDirection es false), pero sin incluir el elemento dado en el ContinuationToken.

Ejemplos de paginación:

• Para devolver un único registro de la plantilla de máquina con el nombre más bajo. El campo AdditionalData tiene el TotalItemsCount y el TotalFilteredItemsCount:

   Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template
   <!--NeedCopy-->
  

• Para devolver 10 registros de la plantilla de máquina con el nombre más bajo:

   Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 10 | select Name
   <!--NeedCopy-->
  

• Para devolver una matriz de registros que terminan con el nombre más alto:

   Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -ForwardDirection $False -MaxRecords 10 | select Name
   <!--NeedCopy-->
  

• Para devolver una matriz de registros que comienzan en la plantilla de máquina asociada con el ContinuationToken dado:

   Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -ContinuationToken "ami-07xxxxxxxxxx" -MaxRecords 10
   <!--NeedCopy-->
  

Filtrado:

Los siguientes parámetros opcionales adicionales son compatibles para el filtrado. Puede combinar estos parámetros con las opciones de paginación.

• -ContainsName "my_name": Si la cadena dada coincide con parte de un nombre de AMI, entonces la AMI se incluye en el resultado Get. Por ejemplo:

   Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 100 -ContainName ‘apollo’ | select Name
   <!--NeedCopy-->
  

• -Tags '{ "Key0": "Value0", "Key1": "Value1", "Key2": "Value2" }': Si una AMI tiene al menos una de estas etiquetas, se incluye en el resultado Get. Por ejemplo:

   Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 100 -Tags '{"opex owner": "Not tagged"}' | select Name
   <!--NeedCopy-->
  

  Nota:

  Se admiten dos valores de etiqueta. El valor de etiqueta Sin etiquetar coincide con los elementos que no tienen la etiqueta dada en su lista de etiquetas. El valor de etiqueta Todos los valores coincide con los elementos que tienen la etiqueta, independientemente del valor de la etiqueta. De lo contrario, la coincidencia solo se produce si el elemento tiene la etiqueta y el valor es igual al proporcionado en el filtro.

• -Id "ami-0a2d913927e0352f3": Si la AMI coincide con el ID dado, se incluye en el resultado Get. Por ejemplo:

   Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -Id ami-xxxxxxxxxxxxx
   <!--NeedCopy-->
  

Filtrado en el parámetro AdditionalData:

El parámetro de filtro AdditionalData enumera plantillas o máquinas virtuales según su capacidad, oferta de servicio o cualquier propiedad que se encuentre en AdditionalData. Por ejemplo:

(Get-HypInventoryItem -ResourceType "launchtemplateversion" -LiteralPath "XDHyp:\HostingUnits\aws" -MaxRecords 200).AdditionalData
<!--NeedCopy-->

También puede añadir un parámetro -Warn para indicar las máquinas virtuales incompatibles. Las máquinas virtuales se incluyen con un campo AdditionalData llamado Warning. Por ejemplo:

(Get-HypInventoryItem -ResourceType "launchtemplateversion" -LiteralPath "XDHyp:\HostingUnits\aws" -MaxRecords 200 -Template "ami-015xxxxxxxxx" -Warn $true).AdditionalData
<!--NeedCopy-->

Pasos siguientes

• Si este es el primer catálogo creado, Web Studio le guía para crear un grupo de entrega
• Para revisar todo el proceso de configuración, consulte Instalar y configurar
• Para administrar catálogos, consulte Administrar catálogos de máquinas y Administrar un catálogo de AWS

Más información

• Crear y administrar conexiones y recursos
• Conexión a AWS
• Crear catálogos de máquinas