Documentación de productos
Citrix DaaS
Ver PDF

Crear un catálogo de AWS

September 27, 2024
Contribución de: 
C

Crear catálogos de máquinas describe los asistentes con los que se crea un catálogo de máquinas. La siguiente información incluye 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 con AWS. Consulte Conexión con AWS.

Configuración de la red durante la preparación de imágenes

Durante la preparación de la imagen, se crea una máquina virtual (VM) de preparación basada en la máquina virtual original. Esta máquina virtual de preparación está desconectada de la red. Para desconectar la red de la máquina virtual 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 el GUID se genera aleatoriamente.

Arrendamiento de AWS

AWS ofrece estas opciones de arrendamiento: arrendamiento compartido (el tipo predeterminado) y arrendamiento dedicado. El arrendamiento compartido significa que es posible que varias instancias de Amazon EC2 de diferentes clientes residan en el mismo hardware físico. El arrendamiento dedicado significa que las instancias de EC2 se ejecutan únicamente en hardware con otras instancias que haya implementado. Los demás clientes no utilizan el mismo hardware.

Puede usar MCS para aprovisionar hosts dedicados de AWS a través de Studio o PowerShell.

Requisitos para el aprovisionamiento a los hosts de AWS

  • Una imagen (AMI) importada de BYOL (bring your own license). Con hosts dedicados, puede usar y administrar sus licencias existentes.
  • Una asignación de hosts dedicados con suficiente utilización para abarcar las solicitudes de aprovisionamiento.
  • Habilitar el emplazamiento automático.

Configurar el arrendamiento de host dedicado de AWS mediante Studio

Al utilizar MCS para crear un catálogo y, así, aprovisionar máquinas en AWS, la página Configuración de catálogo de máquinas > Seguridad presenta estas opciones:

  • Usar un hardware compartido. Esta configuración es adecuada para la mayoría de las implementaciones. Varios clientes comparten componentes de hardware aunque no interactúen entre sí. El uso de hardware compartido es la opción menos costosa para utilizar instancias de Amazon EC2.
  • Usar host dedicado. Un host dedicado de Amazon EC2 es un servidor físico con una capacidad de instancias de EC2 totalmente dedicada, lo que le permite utilizar licencias de software por socket o máquina virtual existentes. Los hosts dedicados tienen una utilización predeterminada basada en el tipo de instancia. Por ejemplo: un único host dedicado asignado de los tipos de instancia C4 Large está limitado a ejecutar 16 instancias. Consulte el sitio de AWS para obtener más información.

  • Usar instancia dedicada. Este parámetro es más adecuado para implementaciones con requisitos específicos de seguridad o de cumplimiento de normas. Con una instancia dedicada, seguirá disfrutando de las ventajas de tener un host separado de los demás clientes de AWS, pero sin pagar por todo el host. No es necesario preocuparse por la capacidad del host, pero se le cobrará una tarifa más alta por las instancias.

    Esta configuración es adecuada para implementaciones con restricciones de licencias o requisitos de seguridad que exigen el uso de un host dedicado. Con un host dedicado, dispone de un host físico completo, y se factura por hora. Al tener ese host, puede poner en marcha tantas instancias de EC2 como permita dicho host sin cargos adicionales.

Nota:

Puede eliminar discos de identidad de preparación disponibles si no hay ninguna tarea en curso de creación de catálogos o actualización de imágenes.

Configurar el arrendamiento de host dedicado de AWS mediante PowerShell

También puede aprovisionar hosts dedicados de AWS a través de PowerShell. Use el cmdlet New-ProvScheme con el parámetro TenancyType establecido en Host.

Capturar la propiedad de instancia de AWS

Cuando crea un catálogo para aprovisionar máquinas con Machine Creation Services (MCS) en AWS, selecciona una imagen AMI que represente la imagen maestra de ese catálogo. A partir de esa imagen AMI, MCS utiliza una instantánea del disco.

Sugerencia:

Para utilizar la captura de propiedades de instancias de AWS, debe tener una máquina virtual asociada a la imagen AMI.

MCS lee las propiedades de la instancia de la que se obtuvo la imagen AMI y aplica el rol y etiquetas de IAM (Administración de acceso e identidad) de la máquina a las máquinas aprovisionadas de un catálogo determinado. Cuando se utiliza esta función opcional, el proceso de creación de catálogos busca la instancia AMI de origen seleccionada, leyendo un conjunto limitado de propiedades. Estas propiedades se almacenan en una plantilla de inicio de AWS, que sirve para aprovisionar las máquinas de ese catálogo. Cualquier máquina del catálogo heredará 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: el depósito y objetos de S3, imágenes AMI, instantáneas y plantillas de inicio.

Sugerencia:

El etiquetado de los recursos transitorios de Citrix es optativo y se puede configurar mediante la propiedad personalizada AwsOperationalResourcesTagging. Para aplicar etiquetas correctamente y crear un catálogo de AWS con etiquetado de recursos operativos, no elimine la instancia de EC2 que se utilizó para crear la imagen AMI.

Capturar la propiedad de instancia de AWS

Puede utilizar esta funcionalidad especificando una propiedad personalizada, AwsCaptureInstanceProperties, al crear un esquema de aprovisionamiento para una conexión de host de AWS:

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

Consulte el New-ProvScheme para obtener más información.

Nota:

AwsCaptureInstanceProperties se ha retirado. En su lugar, recomendamos usar perfiles de máquina para especificar las propiedades de las máquinas virtuales.

Etiquetar un recurso operativo de AWS

Una imagen AMI (Amazon Machine Image) representa un tipo de dispositivo virtual utilizado para crear una máquina virtual dentro del entorno de Amazon Cloud, conocido comúnmente como EC2. Puede utilizar una imagen AMI para implementar servicios que utilicen el entorno EC2. Cuando crea un catálogo para aprovisionar máquinas con MCS en AWS, selecciona una imagen AMI que sirve de imagen maestra 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 imagen AMI de la instancia que quiere que sirva de imagen maestra. MCS lee las etiquetas de esa instancia y las incorpora a la plantilla de inicio. A continuación, 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
  • Depósitos de S3
  • Objetos de S3
  • Plantillas de lanzamiento
  • Imágenes AMI

Aplicar propiedades de instancias de AWS y etiquetar recursos operativos en Studio

Al crear un catálogo para aprovisionar máquinas mediante MCS en AWS, puede decidir si aplicar las propiedades de etiqueta y el rol de IAM a esas máquinas. También puede decidir si aplicar etiquetas de máquina a los recursos operativos. Dispone de estas dos opciones:

Propiedades de plantilla y etiquetas de máquina de AWS

  • Aplicar propiedades de plantilla de máquina a máquinas virtuales
    • Controla si se aplican a las máquinas virtuales de este catálogo las propiedades de etiqueta y rol de IAM asociadas a la plantilla de máquina seleccionada.
  • Aplicar etiquetas de máquina a recursos operativos
    • Controla si aplicar etiquetas de máquina a cada elemento creado en el entorno de AWS que facilite el aprovisionamiento de máquinas. Los recursos operativos se crean como subproductos de la creación de catálogos. Constan de recursos temporales y persistentes, como la instancia de VM de preparación y Amazon Machine Image.

Etiquetar un recurso operativo con PowerShell

Para usar PowerShell para etiquetar recursos:

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

Para etiquetar un recurso para una máquina virtual aprovisionada, utilice la propiedad personalizada AwsOperationalResourcesTagging. La sintaxis de esta propiedad es:

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

Crear un catálogo de máquinas basado en perfiles de máquina con PowerShell

Puede usar un perfil de máquina para capturar las propiedades de hardware de una instancia de EC2 (VM) o versión de plantilla de inicio y aplicarlas a las máquinas aprovisionadas. Las propiedades que se capturan pueden incluir, por ejemplo, las propiedades del volumen de EBS, el tipo de instancia, la optimización de EBS, opciones de CPU, tipo de arrendamiento, capacidad de hibernación y otras configuraciones de AWS compatibles.

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

Nota:

Las propiedades del volumen de EBS se derivan únicamente de un perfil de máquina.

Consideraciones importantes

Consideraciones importantes a la hora de crear un catálogo de máquinas de 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 asigna a AwsCaptureInstanceProperties el valor true y no establece la propiedad MachineProfile, solo se capturarán los roles y etiquetas de IAM.

  • No puede establecer AwsCaptureInstanceProperties y MachineProfile al mismo tiempo.

    **Nota:

    AwsCaptureInstanceProperties se ha retirado.

  • 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
  • Solo puede habilitar AwsOperationalResourcesTagging si habilita AwsCaptureInstanceProperties o especifica un perfil de máquina.

Una consideración importante después de crear un catálogo de máquinas de MCS es:

  • No se puede cambiar un catálogo basado en perfiles de máquina a un catálogo no basado en perfiles 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. Complete la creación del catálogo.

Actualizar el perfil de las máquinas

Para actualizar el perfil de máquina en un catálogo al que inicialmente se aprovisionó un perfil de máquina, haga lo siguiente. También puede cambiar el tipo de arrendamiento y la capacidad de hibernación del origen del perfil de máquina mientras modifica un catálogo de máquinas de 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 inicio mediante PowerShell

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

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

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

  • Oferta de servicios
  • Redes
  • Grupos de seguridad
  • Tipo de arrendamiento

Nota:

Si la oferta de servicios no se proporciona en la plantilla de inicio del perfil de la máquina o como parámetro del comando New-ProvScheme, aparecerá el error correspondiente.

Para crear un catálogo con la versión de la plantilla de inicio como entrada del 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 una plantilla de inicio. 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 inicio como entrada del 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 un esquema de aprovisionamiento como un catálogo de broker. 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.

Actualizar el origen del perfil de máquina

También puede actualizar la entrada de un catálogo de perfiles de máquina de una máquina virtual a una versión de plantilla de inicio y de una versión de plantilla de inicio a una máquina virtual. 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 inicio:

     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 inicio 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 los discos de ID y sistema operativo

Puede crear un catálogo persistente y no persistente de máquinas virtuales con claves de AWS KMS (clave administrada por el cliente y clave administrada por AWS) que se puede usar para cifrar el disco del sistema operativo y el disco de identidad (ID).

  • Las claves administradas por AWS se rotan automáticamente cada año.
  • La rotación automática de las claves administradas por el cliente es opcional y se puede administrar manualmente.

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

Para el cifrado del sistema operativo y los discos de ID, configure una de las siguientes opciones:

  • Use 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 de KMS)
  • Use un origen de perfil de máquina (máquina virtual o plantilla de inicio) 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 los volúmenes o las instantáneas de EBS sin cifrar existentes, ni modificar la clave de KMS de un volumen cifrado existente. Para ello, debe:

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

Consulte los siguientes documentos de AWS:

Crear un catálogo con cifrado de disco

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

  • Imagen maestra
  • Perfil de máquina

Consideraciones al usar la entrada de perfil de máquina:

  • La clave de KMS de la entrada del perfil de máquina tiene prioridad sobre la clave de KMS de la imagen maestra.
  • Si no se proporciona ninguna entrada de perfil de máquina, se usa la clave de 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 contiene asignaciones de dispositivos de bloques, los dispositivos de bloques 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 la máquina también debe tener un dispositivo definido en /dev/sda1.
  • Si no hay ninguna clave en el origen del perfil de máquina y la imagen maestra no está cifrada, los discos de las máquinas virtuales del catálogo no se cifran.
  • Cuando la imagen maestra está cifrada, una plantilla de inicio o VM de origen de perfil de máquina debe tener un volumen raíz cifrado para que se considere una entrada válida.

Modificar un catálogo existente

Puede modificar un catálogo existente mediante el comando Set-ProvScheme de PowerShell para tener:

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

Consideraciones importantes:

  • Los volúmenes de nuevas máquinas virtuales que se agregan al catálogo se cifran con la nueva clave de KMS.
  • Para actualizar los parámetros de cifrado cuando hay un perfil de máquina existente, ejecute Set-ProvScheme con un nuevo perfil de máquina.
  • No puede modificar un catálogo existente para que pase de tener volúmenes cifrados a volúmenes no cifrados. No puede actualizar la imagen de una AMI maestra cifrada a una AMI maestra no cifrada.

Copiar etiquetas en máquinas virtuales

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

Nota:

  • En la consola AWS EC2, no puede ver los valores de Etiquetar interfaces de red en las etiquetas de recursos de versión de la plantilla de inicio. No obstante, 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 un origen de perfil de máquina (máquina virtual o versión de plantilla de inicio) tiene dos interfaces de red (eni-1 y eni-2), y eni-1 tiene la etiqueta t1 y eni-2 tiene la etiqueta t2, la VM obtiene las etiquetas de las dos interfaces de red.

Filtrar instancias de VM con PowerShell

Una instancia de máquina virtual de AWS que utilice como máquina virtual 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 máquinas virtuales de AWS que se pueden usar como máquinas virtuales de entrada de perfil de máquina, puede usar el comando Get-HypInventoryItem. El comando puede buscar en páginas y filtrar el inventario de máquinas virtuales 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 la cantidad de elementos que devolverán.
    • -Skip: El valor predeterminado es 0. Esto controla la cantidad de elementos que se deben omitir 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 por los registros:
    • -ForwardDirection: El valor predeterminado es True. Esto se usa junto con -MaxRecords para devolver el siguiente conjunto de registros coincidentes o el conjunto anterior de registros coincidentes.
    • -ContinuationToken: Devuelve los elementos inmediatamente después (o antes si ForwardDirection es false), pero sin incluir el elemento indicado en ContinuationToken.

Ejemplos de paginación:

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

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

  • Para devolver diez 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 termine 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 comience en la plantilla de máquina asociada al ContinuationToken correspondiente:

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

Filtros:

Se admiten estos parámetros opcionales adicionales para el filtrado. Puede combinar estos parámetros con las opciones de paginación.

  • -ContainsName "my_name": Si la cadena dada coincide con parte del nombre de una AMI, la AMI se incluye en el resultado de 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 de 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 la etiqueta Not Tagged coincide con elementos que no tienen la etiqueta especificada en su lista de etiquetas. El valor de la etiqueta All values coincide con 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 indicado en el filtro.

  • -Id "ami-0a2d913927e0352f3": Si la AMI coincide con el ID proporcionado, se incluye en el resultado de 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 filtrado AdditionalData muestra plantillas o máquinas virtuales en función de 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 agregar un parámetro -Warn para indicar las máquinas virtuales incompatibles. Las máquinas virtuales se incluyen en un campo de AdditionalData denominado Warning. Por ejemplo:

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

Qué hacer a continuación

Más información

Crear un catálogo de AWS
September 27, 2024
Contribución de: 
C
September 27, 2024
Contribución de: 
C

En este artículo

Comentarios sobre el sitio | Your privacy choices footer linkSus opciones de privacidad | Condiciones legales y de privacidad | Preferencias de cookies | Parámetros de consentimiento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.