Documentación de productos
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Ver PDF

Administrar catálogos de máquinas

April 7, 2026
Contribución de: 
C C

Nota:

A partir de la versión 2511, Citrix Web Studio (basado en web) es la única consola de administración para Citrix Virtual Apps and Desktops™. Citrix Studio (basado en MMC) se ha quitado del instalador. Este artículo se aplica solo a Web Studio. Para obtener información sobre Citrix Studio, consulta el artículo equivalente en Citrix Virtual Apps and Desktops 7 2212 o versiones anteriores.

Introducción

  • Puedes agregar o quitar máquinas de un catálogo de máquinas, cambiar su nombre, modificar la descripción o administrar las cuentas de equipo de Active Directory de un catálogo.

El mantenimiento de los catálogos también puede incluir asegurarse de que cada máquina tenga las últimas actualizaciones del sistema operativo. Esto incluye actualizaciones de antivirus, actualizaciones del sistema operativo o cambios de configuración.

  • Los catálogos que contienen máquinas aleatorias agrupadas creadas con Machine Creation Services™ (MCS) mantienen las máquinas actualizando la imagen maestra utilizada en el catálogo y, a continuación, actualizando las máquinas. Este método te permite actualizar de forma eficiente un gran número de máquinas de usuario.

  • Para los catálogos que contienen máquinas estáticas asignadas permanentemente y para los catálogos de máquinas de acceso remoto a PC, administras las actualizaciones de las máquinas de los usuarios fuera de Web Studio. Realiza esta tarea de forma individual o colectiva mediante herramientas de distribución de software de terceros.

  • Para obtener información sobre cómo crear y administrar conexiones a hipervisores de host, consulta Conexiones y recursos.

  • Nota:

  • MCS no es compatible con Windows 10 IoT Core y Windows 10 IoT Enterprise. Consulta el sitio de Microsoft para obtener más información.

  • Acerca de las instancias persistentes

Al actualizar un catálogo de MCS creado con instancias persistentes o dedicadas, las máquinas nuevas creadas para el catálogo utilizan la imagen actualizada. Las instancias preexistentes siguen utilizando la instancia original. El proceso de actualización de una imagen se realiza de la misma manera que para cualquier otro tipo de catálogo. Ten en cuenta lo siguiente:

  • Con los catálogos de discos persistentes, las máquinas preexistentes no se actualizan a la nueva imagen, pero las máquinas nuevas que se agreguen al catálogo utilizan la nueva imagen.
  • Para los catálogos de discos no persistentes, la imagen de la máquina se actualiza la próxima vez que se restablece la máquina.
    • Con los catálogos de máquinas persistentes, la actualización de la imagen también actualiza las instancias del catálogo que la utilizan.
    • Para los catálogos que no son persistentes, si quieres imágenes diferentes para máquinas diferentes, las imágenes deben residir en catálogos separados.

  • Administrar catálogos de máquinas

    • Puedes administrar un catálogo de máquinas de dos maneras:
  • Usar Web Studio

Usar Web Studio

  1. Usa la función de búsqueda para localizar un catálogo de máquinas específico. Consulta Buscar instancias para obtener instrucciones.
  2. En los resultados de la búsqueda, selecciona un catálogo según sea necesario.
  3. Consulta la siguiente tabla para ver las descripciones de las columnas del catálogo.

  4. Consulta la siguiente tabla para ver las descripciones de las columnas del catálogo.

    Columna Descripción
    Catálogo de máquinas

    		El nombre y el tipo de asignación del catálogo. Los tipos de asignación incluyen
    • Aleatorio: Las máquinas del catálogo se asignan a un usuario de forma aleatoria.
    • Permanente: Las máquinas del catálogo se asignan a un usuario de forma permanente.
    Tipo de máquina




    		El tipo de sesión admitido de las máquinas del catálogo. Los valores posibles incluyen
    • Tipo de SO: SO multisesión (virtual); Datos de usuario: Descartar.
    • Tipo de SO: SO multisesión (virtual); Datos de usuario: En disco local
    • Tipo de SO: SO de sesión única (acceso remoto a PC)
    • Tipo de SO: SO de sesión única (virtual); Datos de usuario: Descartar
    • Tipo de SO: SO de sesión única (virtual); Datos de usuario: En disco local
    Recuento de máquinas El recuento de máquinas en el catálogo y el método de aprovisionamiento. Los posibles métodos de aprovisionamiento incluyen: Machine Creation Services (máquina MCS), Manual y Citrix Provisioning™ Services.
    Recuento asignado El número de máquinas del catálogo asignadas a un grupo de entrega.
    Carpeta La ubicación del catálogo dentro del árbol de Catálogos de máquinas. Muestra el nombre de la carpeta en la que se encuentra el catálogo (incluida la barra invertida final), o - si el catálogo está en el nivel raíz.
    Actualización de VDA Estado de actualización de VDA. Los valores posibles incluyen: No configurado, Programado, Disponible y Actualizado.
Estado de la imagen El estado de la actualización de la imagen del catálogo. Aplicable solo a catálogos de máquinas no persistentes. Los valores posibles incluyen: Totalmente actualizado, Parcialmente actualizado, Actualizaciones pendientes, Preparando

  1. Haz clic en una ficha en el panel de detalles inferior para obtener más información sobre un catálogo seleccionado.

    Ficha Descripción
  • |——|——–|
  • Detalles Resume la configuración clave del catálogo de máquinas, como el tipo de máquina, el método de aprovisionamiento, la cuenta de servicio, el sistema operativo y la versión de VDA, lo que te permite ver y administrar tus recursos rápidamente.
  • Propiedades de la plantilla



    		Disponible solo para catálogos aprovisionados por MCS.
    Muestra información detallada de aprovisionamiento para el catálogo seleccionado, que incluye
    • Propiedades de la plantilla de máquina
    • Detalles específicos del hipervisor
    • Propiedades del perfil de máquina
    Máquinas Muestra una lista paginada de nombres de máquinas en el catálogo seleccionado.
    Grupos de entrega
    		Disponible para catálogos de PC remoto.
    Muestra los grupos de entrega asociados al catálogo seleccionado. Muestra el nombre del grupo de entrega y la asociación del catálogo.
    Etiquetas
    		No disponible en entornos multiusuario.
    Muestra el nombre y la descripción de las etiquetas asignadas al catálogo de máquinas seleccionado.
    Administración del entorno de trabajo Solo visible cuando el servicio WEM está aprovisionado y accesible.
    • ^^ ^^ Muestra la configuración de optimización del sistema de administración del entorno de trabajo.
  • Información de costes Aplicable solo a catálogos de Azure MCS, muestra
  • ^^

    		^^ • Coste total incurrido en los últimos 30 días.
    • Una comparación entre el coste total actual de 30 días y el período anterior de 30 días.
    El acceso requiere el permiso de Citrix Administración de costes > Administrar > Leer coste (predeterminado para administradores de la nube) para ver la ficha, y el permiso de Azure Microsoft.CostManagement/query/read para ver los detalles de los costes.
    Solucionar problemas Muestra errores o advertencias del catálogo con acciones recomendadas.

Antes de empezar:

  • Asegúrate de que el host de virtualización tenga suficientes procesadores, memoria y almacenamiento para alojar las máquinas adicionales.
    • Asegúrate de tener suficientes cuentas de equipo de Active Directory sin usar. Si usas cuentas existentes, el número de máquinas que puedes agregar está limitado por el número de cuentas disponibles.

    • Si usas Web Studio para crear cuentas de equipo de Active Directory para las máquinas adicionales, debes tener los permisos de administrador de dominio adecuados.

    • Para agregar máquinas a un catálogo:
  1. Inicia sesión en Web Studio.
  2. Selecciona Catálogos de máquinas en el panel izquierdo.
  3. Selecciona un catálogo de máquinas y, a continuación, selecciona Agregar máquinas en la barra de acciones.
  4. Selecciona el número de máquinas virtuales que quieres agregar.
  5. Si no hay suficientes cuentas de Active Directory existentes para el número de máquinas virtuales que vas a agregar, selecciona el dominio y la ubicación donde se crean las cuentas. Especifica un esquema de nombres de cuenta, usando signos de almohadilla para indicar dónde aparecen números o letras secuenciales. No uses una barra diagonal (/) en un nombre de OU. Un nombre no puede empezar con un número. Por ejemplo, un esquema de nombres como PC-Sales-## (con 0-9 seleccionado) da como resultado cuentas de equipo llamadas PC-Sales-01, PC-Sales-02, PC-Sales-03, etc.
  6. Si usas cuentas de Active Directory existentes, busca las cuentas o haz clic en Importar y especifica un archivo .csv que contenga los nombres de las cuentas. Asegúrate de que haya suficientes cuentas para todas las máquinas que vas a agregar. Web Studio administra estas cuentas. Permite que Web Studio restablezca las contraseñas de todas las cuentas, o especifica la contraseña de la cuenta, que debe ser la misma para todas las cuentas.

Las máquinas se crean como un proceso en segundo plano y puede llevar mucho tiempo cuando se crean muchas máquinas. La creación de máquinas continúa incluso si cierras Web Studio.

Después de eliminar una máquina de un catálogo de máquinas, los usuarios ya no pueden acceder a ella, por lo que, antes de eliminar una máquina, asegúrate de que:

-  Los datos de usuario se han copiado o ya no son necesarios.
-  Todos los usuarios han cerrado sesión. Activar el modo de mantenimiento impide que se establezcan nuevas conexiones a una máquina.
-  Las máquinas están apagadas.

Para eliminar máquinas de un catálogo:

  1. Inicia sesión en Web Studio.
      1. Selecciona Catálogos de máquinas en el panel izquierdo.
      1. Selecciona un catálogo y, a continuación, selecciona Ver máquinas en la barra de acciones.
  2. Selecciona una o varias máquinas y, a continuación, selecciona Eliminar en la barra de acciones.

Elige si quieres eliminar las máquinas que se van a quitar. Si eliges eliminar las máquinas, indica si las cuentas de Active Directory de esas máquinas se conservan, se deshabilitan o se eliminan.

-  1.  En la página **Descripción**, cambia la descripción del catálogo.
  1. Selecciona Catálogos de máquinas en el panel izquierdo.
  2. Selecciona un catálogo y, a continuación, selecciona Modificar catálogo de máquinas en la barra de acciones.
  3. En la página Ámbitos, cambia los ámbitos.

  4. En la página NIC, realiza las siguientes acciones:

    • Para cambiar la asignación de subred de una NIC, selecciona una red en el campo Red asociada.
    • Para agregar una asignación de subred, selecciona Agregar NIC, selecciona una red en el campo Red asociada y haz clic en Guardar.

    Solo las subredes presentes en el host asociado al catálogo aparecen en el campo Red asociada.

    Solo puedes agregar NIC a catálogos de máquinas de Azure sin perfiles de máquina.

    Nota:

    • Para los catálogos de máquinas de AWS, no puedes asignar la misma subred a más de una NIC.
  • Para los catálogos de máquinas con perfiles de máquina, el número de NIC del catálogo debe ser igual al número de NIC del perfil de máquina.
  • Esta función no es compatible con los hipervisores de IBM Cloud.
  • Esta función solo es compatible con Nutanix Prism Element en el caso de los hipervisores de Nutanix.

  1. Es posible que veas otras páginas según el tipo de catálogo.

    Para los catálogos creados con una imagen de Azure Resource Manager, las siguientes páginas están visibles. Ten en cuenta que los cambios que realices solo se aplican a las máquinas que agregues al catálogo más adelante. Las máquinas existentes permanecen sin cambios.

    • En la página Máquinas virtuales, cambia el tamaño de la máquina y las zonas de disponibilidad donde quieres crear máquinas.

      Nota:

      • Solo se muestran los tamaños de máquina compatibles con el catálogo.
      • Si es necesario, selecciona Mostrar solo los tamaños de máquina utilizados en otros catálogos de máquinas para filtrar la lista de tamaños de máquina.
      • Para los catálogos de Azure, si ZRS es la Redundancia de almacenamiento en la página Tipos de almacenamiento y licencias, recibirás una advertencia que sugiere borrar la selección de zona y dejar que Azure administre las zonas de disponibilidad de la VM.

    • En la página Perfil de máquina, elige si quieres usar o cambiar un perfil de máquina.

      Nota:

      Para los catálogos de Azure, cuando modificas un perfil de máquina que incluye zonas de disponibilidad y eliges ZRS para la redundancia de almacenamiento, una advertencia sugiere que borres la selección de zona.

    • (Visible solo cuando el catálogo está configurado con un grupo de host dedicado) En la página Grupo de host dedicado, elige si quieres cambiar un grupo de host.

    • En la página Tipos de almacenamiento y licencias, elige si quieres cambiar el tipo de redundancia de almacenamiento (para el catálogo de Azure), el tipo de almacenamiento, el tipo de licencia y la configuración de Azure Computer Gallery (disponible solo cuando se utiliza Colocar imagen preparada en Azure Gallery).

    Nota:

    Si la configuración recién seleccionada no es compatible con el tamaño de máquina actual, aparece un cuadro de diálogo de advertencia que te informa de que cambiar la configuración restablece la configuración del tamaño de máquina. Si eliges continuar, aparece un punto rojo junto al menú Máquinas virtuales, lo que te indica que selecciones un nuevo tamaño de máquina.

    • En la página Tipo de licencia, elige si quieres cambiar la configuración de la licencia de Windows o de Linux.

    Para los catálogos de Acceso con PC remoto, las siguientes páginas están visibles:

    • En la página Administración de energía, cambia la configuración de administración de energía y selecciona una conexión de administración de energía.
    • En la página Unidades organizativas, agrega o quita UO de Active Directory.

  2. Haz clic en Aplicar para aplicar los cambios que has realizado y haz clic en Guardar para salir.

  1. Inicia sesión en Web Studio.
  2. Selecciona Catálogos de máquinas en el panel izquierdo.
  3. Selecciona un catálogo y, a continuación, selecciona Cambiar nombre del catálogo de máquinas en la barra de acciones.
  4. Introduce el nuevo nombre.

Mover un catálogo a una zona diferente

Si tu implementación tiene más de una zona, puedes mover un catálogo de una zona a otra.

Mover un catálogo a una zona diferente, que no sea la del hipervisor que contiene las VM de ese catálogo, afecta al rendimiento.

  1. Inicia sesión en Web Studio.
  2. Selecciona Catálogos de máquinas en el panel izquierdo.
  3. Selecciona un catálogo y, a continuación, selecciona Mover en la barra de acciones.
  4. Selecciona la zona a la que quieres mover el catálogo.

Antes de eliminar un catálogo, asegúrate de que:

-  Todos los usuarios hayan cerrado sesión y no tengas ninguna sesión desconectada en ejecución.
  • El modo de mantenimiento esté activado para todas las máquinas del catálogo, de modo que no se puedan establecer nuevas conexiones.
  • Todas las máquinas del catálogo estén apagadas.
  • El catálogo no esté asociado a un grupo de entrega. En otras palabras, el grupo de entrega no contenga máquinas del catálogo.

Para eliminar un catálogo:

  1. Inicia sesión en Web Studio.
  2. Selecciona Catálogos de máquinas en el panel izquierdo.
  3. Selecciona un catálogo y, a continuación, selecciona Eliminar catálogo de máquinas en la barra de acciones.
  4. Indica si las máquinas del catálogo se eliminan. Si eliges eliminar las máquinas, indica si las cuentas de equipo de Active Directory de esas máquinas se conservan, se deshabilitan o se eliminan.

Convertir catálogos MCS heredados en Azure a catálogos basados en perfiles de máquina

Para convertir un catálogo de máquinas no basado en perfiles de máquina en un catálogo de máquinas basado en perfiles de máquina, completa los siguientes pasos:

  1. En la página Catálogos de máquinas, haz clic con el botón derecho en el nombre del Catálogo de máquinas que quieres convertir y, a continuación, selecciona Modificar catálogo de máquinas.
  2. En la página Modificar catálogo de máquinas > Perfil de máquina, selecciona la casilla de verificación Usar un perfil de máquina (obligatorio para Microsoft Entra ID).
  3. Haz clic en Seleccionar un perfil de máquina.
    1. En la página Seleccionar un perfil de máquina, selecciona una máquina virtual o una plantilla de inicio para usarla como perfil de máquina.
  1. Si algunas configuraciones actuales difieren de las nuevas configuraciones del perfil de máquina, selecciona la opción requerida para las configuraciones que quieres usar y haz clic en Continuar.
  2. Haz clic en Aplicar.

Nota:

Actualmente, esta función solo es compatible con Azure, AWS y VMware.

Para administrar cuentas de Active Directory en un catálogo de máquinas, puedes:

  • Liberar cuentas de máquina no utilizadas quitando las cuentas de equipo de Active Directory de los catálogos de SO de sesión única y de SO de varias sesiones. Esas cuentas se pueden usar luego para otras máquinas.

    • Agregar cuentas para que, cuando se agreguen más máquinas al catálogo, las cuentas de equipo ya estén disponibles. No uses una barra diagonal (/) en un nombre de OU.

    • Para administrar cuentas de Active Directory:

  1. Inicia sesión en Web Studio.
  2. Selecciona Catálogos de máquinas en el panel izquierdo.
  3. Selecciona un catálogo y, a continuación, selecciona Administrar cuentas de AD en la barra de acciones.

  4. Elige si quieres agregar o eliminar cuentas de equipo. Si agregas cuentas, especifica qué hacer con las contraseñas de las cuentas: restablecerlas todas o introducir una contraseña que se aplique a todas las cuentas.

    Es posible que debas restablecer las contraseñas si no conoces las contraseñas actuales de las cuentas; debes tener permiso para realizar un restablecimiento de contraseña. Al introducir una contraseña, esta se cambia en las cuentas a medida que se importan. Al eliminar una cuenta, elige si la cuenta de Active Directory se conserva, se deshabilita o se elimina.

Indica si las cuentas de Active Directory se conservan, se deshabilitan o se eliminan al quitar máquinas de un catálogo o al eliminar un catálogo.

-  Te recomendamos que guardes copias o instantáneas de las imágenes maestras antes de actualizar las máquinas del catálogo. La base de datos mantiene un registro histórico de las imágenes maestras utilizadas con cada catálogo de máquinas. Puedes revertir las máquinas de un catálogo para usar la versión anterior de la imagen maestra. Realiza esta tarea si los usuarios encuentran problemas con las actualizaciones que implementaste en sus escritorios. Esto minimiza el tiempo de inactividad del usuario. No elimines, muevas ni cambies el nombre de las imágenes maestras. No puedes revertir un catálogo para usarlas.

-  Después de actualizar una máquina, esta se reinicia automáticamente.

Actualizar o crear una imagen maestra

Antes de actualizar el catálogo de máquinas, actualiza una imagen maestra existente o crea una en tu hipervisor host.

  1. En tu hipervisor, toma una instantánea de la máquina virtual actual y asígnale un nombre significativo. Esta instantánea se puede usar para revertir (restaurar) las máquinas del catálogo, si es necesario.
  2. Si es necesario, enciende la imagen maestra e inicia sesión.
  3. Instala las actualizaciones o realiza los cambios necesarios en la imagen maestra.
  4. Apaga la máquina virtual.
  5. Toma una instantánea de la máquina virtual. Asígnale un nombre significativo que se reconozca cuando el catálogo se actualice en Web Studio. Aunque Web Studio puede crear una instantánea, Citrix recomienda que la crees mediante la consola de administración del hipervisor. Luego, selecciona esa instantánea en Web Studio. Este proceso te permite proporcionar un nombre y una descripción significativos en lugar de un nombre generado automáticamente. Para las imágenes maestras de GPU, solo puedes cambiar la imagen maestra a través de la consola de XenServer®.

Cambiar la imagen maestra

Para preparar e implementar la actualización en todas las máquinas de un catálogo:

  1. Inicia sesión en Web Studio.
  2. Selecciona Catálogos de máquinas en el panel izquierdo.
  3. Selecciona un catálogo y, a continuación, selecciona Cambiar imagen maestra en la barra de acciones.
  4. En la página Imagen, selecciona el host y la imagen que quieres implementar.

    Consejo:

    Para un catálogo creado con MCS, puedes anotar su imagen agregando una nota para la imagen. Una nota puede contener hasta 500 caracteres. Cada vez que cambias la imagen maestra, se crea una entrada relacionada con la nota, tanto si agregas una nota como si no. Si actualizas un catálogo sin agregar una nota, la entrada aparece como nula (-). Para ver el historial de notas de la imagen, selecciona el catálogo, haz clic en Propiedades de la plantilla en el panel inferior y, a continuación, haz clic en Ver historial de notas.

  5. En la página Estrategia de implementación, elige cuándo se actualizan las máquinas del catálogo de máquinas con la nueva imagen maestra: en el siguiente apagado o inmediatamente.

    Nota:

    La página Estrategia de implementación no está disponible para máquinas virtuales persistentes porque la implementación solo se aplica a máquinas virtuales no persistentes.

  6. Verifica la información en la página Resumen y, a continuación, haz clic en Finalizar. Cada máquina se reinicia automáticamente después de actualizarse.

    • Para realizar un seguimiento del progreso de la actualización, busca el catálogo en Catálogos de máquinas para ver la barra de progreso en línea y el gráfico de progreso paso a paso.

Al actualizar un catálogo directamente con el SDK de PowerShell, en lugar de Web Studio, especifica una plantilla de hipervisor (VMTemplates). Úsala como alternativa a una imagen o a una instantánea de una imagen.

Para implementar una nueva imagen maestra en un catálogo de máquinas basado en Azure:

  1. Desde Web Studio, selecciona Catálogos de máquinas en el panel izquierdo.
  2. Selecciona un catálogo de Azure y, a continuación, selecciona Cambiar imagen maestra en la barra de acciones.
  3. En la página Cambiar imagen maestra, selecciona una imagen en Imagen maestra. El panel enumera todas las imágenes que pertenecen a la misma región que las de Recursos.

  • Estrategia de implementación:

  • La actualización de imágenes en el siguiente apagado afectará inmediatamente a cualquier máquina que no esté en uso actualmente, es decir, a las máquinas que no tienen una sesión de usuario activa. Un sistema en uso recibe la actualización cuando finaliza la sesión activa actual. Ten en cuenta lo siguiente:

  • No se pueden iniciar nuevas sesiones hasta que la actualización se haya completado en las máquinas aplicables.
  • En el caso de máquinas con SO de sesión única, las máquinas se actualizan inmediatamente cuando la máquina no está en uso o cuando los usuarios no han iniciado sesión.
  • En el caso de un SO multisesión con máquinas secundarias, los reinicios no se producen automáticamente. Para aplicar la imagen maestra actualizada, reinicia las máquinas mediante Studio, PowerShell o Workspace. Reiniciar desde las máquinas o el hipervisor no aplica la actualización.

Sugerencia:

Limita el número de máquinas que se reinician mediante la configuración avanzada de una conexión de host. Usa esta configuración para modificar las acciones realizadas para un catálogo determinado; la configuración avanzada varía según el hipervisor.

Revertir la imagen maestra

Después de implementar una imagen maestra actualizada o nueva, puedes revertirla. Este proceso podría ser necesario si surgen problemas con las máquinas recién actualizadas. Al revertir, las máquinas del catálogo se revierten a la última imagen funcional. Las nuevas funciones que requieren la imagen más reciente ya no estarán disponibles. Al igual que con la implementación, revertir una máquina incluye un reinicio.

  1. Inicia sesión en Web Studio.
  2. Selecciona Catálogos de máquinas en el panel izquierdo.
  3. Selecciona el catálogo y, a continuación, selecciona Revertir imagen maestra en la barra de acciones.
  4. Especifica cuándo aplicar la imagen maestra anterior a las máquinas, como se describe en la sección anterior para la operación de implementación.

La reversión se aplica solo a las máquinas que deben revertirse. Las máquinas que no se actualizan con la imagen maestra nueva o actualizada no reciben mensajes de notificación y no se les fuerza a cerrar sesión.

Para seguir el progreso de la reversión, busca el catálogo en Catálogos de máquinas para ver la barra de progreso en línea y el gráfico de progreso paso a paso.

  • Cambiar el nivel funcional o deshacer el cambio

Cambia el nivel funcional del catálogo de máquinas después de actualizar los VDA de las máquinas a una versión más reciente. Citrix recomienda actualizar todos los VDA a la versión más reciente para habilitar el acceso a todas las funciones más nuevas.

Antes de cambiar el nivel funcional de un catálogo de máquinas:

  • Inicia las máquinas actualizadas para que se registren con el Controller. Este proceso permite a Web Studio determinar que las máquinas del catálogo necesitan una actualización.

    • Para cambiar el nivel funcional de un catálogo:
  1. Inicia sesión en Web Studio.
  2. Selecciona Catálogos de máquinas en el panel izquierdo.
  3. Selecciona el catálogo. La ficha Detalles del panel inferior muestra la información de la versión.
  4. Selecciona Cambiar nivel funcional. Si Web Studio detecta que el catálogo necesita una actualización, muestra un mensaje. Sigue las indicaciones. Si una o varias máquinas no se pueden actualizar, un mensaje explica el motivo. Para asegurarte de que todas las máquinas funcionen correctamente, Citrix recomienda que resuelvas los problemas de las máquinas antes de hacer clic en Cambiar para continuar.

Una vez completado el cambio de catálogo, puedes revertir las máquinas a sus versiones de VDA anteriores seleccionando el catálogo y, a continuación, seleccionando Deshacer cambio de nivel funcional en la barra de acciones.

  • Antes de clonar un catálogo, ten en cuenta las siguientes consideraciones:

  • No puedes cambiar la configuración asociada al sistema operativo y a la administración de máquinas. El catálogo clonado hereda esa configuración del original.

Nota:

Si seleccionas un catálogo de Azure para clonar y seleccionas una imagen maestra, el panel enumera todas las imágenes que pertenecen a la misma región que las de Recursos.

  • Clonar un catálogo puede tardar un tiempo en completarse. Si es necesario, selecciona Ocultar progreso para ejecutar la clonación en segundo plano.
  • El catálogo clonado hereda el nombre del original y tiene el sufijo Copy. Puedes cambiar el nombre. Consulta Cambiar el nombre de un catálogo.
  • Una vez completada la clonación, asegúrate de asignar el catálogo clonado a un grupo de entrega.
  1. Inicia sesión en Web Studio y, a continuación, selecciona Catálogos de máquinas en el panel izquierdo.
  2. Selecciona un catálogo y, a continuación, selecciona Clonar en la barra de acciones.
  3. En la ventana Clonar catálogo de máquinas seleccionado, consulta la configuración del catálogo clonado y configura los ajustes según corresponda. Selecciona Siguiente para ir a la página siguiente.
  4. En la página Resumen, consulta un resumen de la configuración y selecciona Finalizar para iniciar la clonación.
  5. Si es necesario, selecciona Ocultar progreso para ejecutar la clonación en segundo plano.

Organizar catálogos mediante carpetas

Puedes crear carpetas para organizar los catálogos y facilitar el acceso. Por ejemplo, puedes organizar los catálogos por tipo de imagen o por estructura de la organización.

Sugerencia:

Puedes establecer tu vista predeterminada preferida (vista de carpeta o de lista) para el nodo Catálogos de máquinas haciendo clic en el icono Carpeta en la parte superior derecha de la barra de acciones.

Antes de empezar, planifica cómo organizar tus catálogos. Ten en cuenta lo siguiente:

  • Puedes anidar carpetas hasta cinco niveles de profundidad (excluyendo la carpeta raíz predeterminada).
  • Una carpeta de catálogo puede contener catálogos y subcarpetas.

  • Todos los nodos de Web Studio (como Catálogos de máquinas, Grupos de entrega, Aplicaciones y Grupos de aplicaciones) comparten el mismo árbol de carpetas en el back-end. Para evitar conflictos de nombres al cambiar el nombre o mover carpetas, usa nombres únicos para las carpetas de primer nivel en los diferentes nodos.

    Si creas una carpeta mediante el cmdlet SDK New-BrokerAdminFolder y quieres que aparezca en el nodo Catálogos de máquinas, debes agregar los metadatos ContainsMachineCatalogs mediante el cmdlet Set-BrokerAdminFolderMetadata.

    Ejemplo:

     Set-BrokerAdminFolderMetadata -AdminFolderId {adminFolderUid} -Name ContainsMachineCatalogs -Value true
 <!--NeedCopy-->

Para crear una carpeta de catálogo, sigue estos pasos:

  1. Selecciona Catálogos de máquinas en el panel izquierdo.
  2. En la jerarquía de carpetas, selecciona una carpeta y, a continuación, selecciona Crear carpeta en la barra de Acciones.
  3. Introduce un nombre para la nueva carpeta y, a continuación, haz clic en Listo.

Sugerencia:

Si creas una carpeta en una ubicación no deseada, puedes arrastrarla a la ubicación correcta.

  • Puedes mover un catálogo entre carpetas. Los pasos detallados son los siguientes:

    1. Selecciona Catálogos de máquinas en el panel izquierdo.
    1. Visualiza los catálogos por carpeta. También puedes activar Ver todo encima de la jerarquía de carpetas para ver todos los catálogos a la vez.
    1. Haz clic con el botón derecho en un catálogo y, a continuación, selecciona Mover catálogo de máquinas.
    1. Selecciona la carpeta a la que quieres mover el catálogo y, a continuación, haz clic en Listo.

Sugerencia:

Puedes arrastrar un catálogo a una carpeta.

  • Administrar carpetas de catálogos

Puedes eliminar, renombrar y mover carpetas de catálogos.

Solo puedes eliminar una carpeta si esta y sus subcarpetas no contienen catálogos.

Para administrar una carpeta, sigue los pasos que se indican a continuación:

    1. Selecciona Catálogos de máquinas en el panel izquierdo.
    1. En la jerarquía de carpetas, selecciona una carpeta y, a continuación, selecciona una acción en la barra de Acciones según sea necesario:
    • Para renombrar la carpeta, selecciona Renombrar carpeta.
    • Para eliminar la carpeta, selecciona Eliminar carpeta.
    • Para mover la carpeta, selecciona Mover carpeta.
    1. Sigue las instrucciones en pantalla para completar los pasos restantes.

Actualizar VDA

  • Puedes usar la interfaz de Studio para actualizar los VDA con facilidad. Para obtener más información y una guía paso a paso, consulta la documentación del Servicio de actualización de VDA de Citrix.

Nota:

Esta función se aplica solo a los catálogos de MCS.

  • Los catálogos fallidos se marcan con un icono de error. Para ver los detalles, ve a la ficha Solucionar problemas de cada catálogo. Antes de reintentar la creación del catálogo, ten en cuenta las siguientes consideraciones:

  • Primero, comprueba la información de solución de problemas y resuelve los problemas. La información describe los problemas encontrados y proporciona recomendaciones para resolverlos.
  • No puedes cambiar la configuración asociada al sistema operativo y la administración de máquinas. El catálogo hereda esa configuración del original.

  • La creación puede tardar un tiempo en completarse. Si es necesario, selecciona Ocultar progreso para ejecutar la creación en segundo plano.

  • Para reintentar la creación de un catálogo, haz lo siguiente:

    1. Desde Web Studio, selecciona Catálogos de máquinas en el panel izquierdo.
    1. Selecciona el catálogo y, a continuación, ve a su ficha Solucionar problemas.
  1. Haz clic en el hipervínculo de reintento para reintentar la creación del catálogo.
  2. En el asistente que aparece, cambia la configuración donde sea necesario. Si no es necesario realizar cambios, puedes ir directamente a la página de Resumen.
  3. Cuando hayas terminado, selecciona Finalizar para iniciar la creación.

Inscribir VDA no aprovisionados por MCS mediante tokens

Ahora puedes generar y administrar tokens de inscripción para VDA no aprovisionados por MCS. Esta implementación permite el registro de VDA a través de WebSocket sin aprovisionar los VDA con MCS. Esta función también es compatible con Linux Virtual Delivery Agent, Citrix Virtual Delivery Agent para macOS y VDA no unidos a un dominio con Citrix Virtual Apps™ and Desktops.

Antes de empezar

  1. Configura tu sitio. Para obtener más información, consulta Crear un sitio.
  2. Instala certificados TLS en los Delivery Controllers. Para obtener más información, consulta Instalar certificados de servidor TLS en Controllers.
  3. Instala la CA raíz y la CA intermedia en el VDA para confiar en el Delivery Controller.

  4. Habilita la conexión WebSocket en el Delivery Controller. Ejecuta el siguiente comando en cada Delivery Controller presente en tu sitio:

    New-ItemProperty "HKLM:\SOFTWARE\Citrix\DesktopServer\WorkerProxy" -Name "WebSocket_Enabled" -PropertyType "DWord" -Value 1 -Force
<!--NeedCopy-->

    Nota:

    Asegúrate de reiniciar los Delivery Controllers después de habilitar WebSocket.

Generar tokens de inscripción

  • Después de decidir habilitar la inscripción basada en tokens para máquinas no aprovisionadas por Citrix, primero debes generar tokens por catálogo de máquinas y, a continuación, compartirlos con los administradores de instalación de VDA.

  • Un token de inscripción presenta las siguientes características:

  • Rango de registro: 1–5000 máquinas VDA
  • Período de validez: hasta 14 días

Para generar un token para un catálogo usando Web Studio, sigue estos pasos:

    1. En Web Studio > Catálogos de máquinas, localiza un catálogo no aprovisionado por MCS, que tenga Método de aprovisionamiento: Manual mostrado en la columna Recuento de máquinas.
    1. Haz clic con el botón derecho en el catálogo y, a continuación, selecciona Administrar tokens de inscripción.
        1. En la página Generar token de inscripción que aparece, proporciona la siguiente información del token:
      • Escribe un nombre para el token.
      • Introduce su período de validez. El período no debe ser superior a 14 días. El token es válido solo durante el período especificado.
      • (Opcional) Selecciona una conexión de host para la administración de energía de los VDA inscritos con el token. Las opciones incluyen todas las conexiones de host de la zona de este catálogo.
      • Introduce los límites de uso del token (entre 1 y 5000).
  1. Haz clic en Generar.
      1. En la ventana Token generado correctamente que aparece, copia el token y guárdalo en un lugar seguro, o haz clic en Descargar para descargarlo en la carpeta Descargas.

    Un registro de token aparece en la lista de tokens.

    • Generación de token

  2. Comparte el token con los administradores de instalación de VDA.

    • Para obtener más información sobre cómo instalar VDA y un token en máquinas, consulta Instalar VDA.

Administrar tokens 

-  Tienes dos opciones para revocar un token y dejarlo no disponible para la inscripción de VDA:
  • Revocar: Revoca el token, pero lo conserva en la lista para fines de registro.
  • Eliminar: Revoca el token y lo elimina de la lista.

Nota:

Los tokens caducados se eliminan automáticamente en 14 días.

Inscribir máquinas en catálogos mediante la herramienta de inscripción de VDA de WebSocket

La herramienta de inscripción de VDA de WebSocket facilita la inscripción basada en tokens para máquinas VDA. Esta herramienta te ayuda a convertir una conexión en una conexión WebSocket agregando el VDA al catálogo de máquinas mediante el token de inscripción.

Nota: - > Esta herramienta está diseñada para inscribir máquinas VDA que no se han inscrito en ningún catálogo de máquinas.

-  Sigue las instrucciones para ejecutar la herramienta de inscripción:
  1. Inicia sesión en el VDA.
  2. Localiza la herramienta EnrollMachine.exe, en C:\Program Files\Citrix\Virtual Desktop Agent\Web Socket Vda Enrollment Tool.
  3. Ejecuta la herramienta con los parámetros de entrada adecuados. Por ejemplo, EnrollMachine.exe -websocket_token_string:xxxxxxxxx

La siguiente tabla describe los parámetros de entrada de la herramienta de inscripción:

Nombre del parámetro Obligatorio Descripción Ejemplo
-websocket_token_stdin Sí

Lee el token de inscripción. .\EnrollMachine.exe -websocket_token_stdin
-websocket_token_string Lee el token de inscripción directamente del parámetro de línea de comandos. .\EnrollMachine.exe -websocket_token_string:<token>
-websocket_token_file:[token-file-path] Lee el token de inscripción de la ruta proporcionada. .\EnrollMachine.exe -websocket_token_file:C:\token\test2.txt
log:[log-file-path] No Muestra los registros de la herramienta de inscripción. .\EnrollMachine.exe log:[C:\ProgramData\Citrix\EnrollMachine\EnrollMachine.txt]
-help No Muestra un breve texto de ayuda. .\EnrollMachine.exe -help

Después de una inscripción correcta, recibirás un mensaje de éxito en la herramienta y en los registros. Asegúrate de iniciar sesión en Web Studio para verificar que la máquina VDA se ha agregado al catálogo y que el estado de la máquina está registrado.

Solución de problemas

De forma predeterminada, puedes encontrar los registros de la herramienta de inscripción en:

C:\ProgramData\Citrix\EnrollMachine\EnrollMachine.txt

  • Si has especificado una ruta diferente para los registros, puedes usar log:[log-file-path] para recuperarlos.

  • La siguiente tabla enumera los códigos devueltos por la herramienta de inscripción:

  • Código Cadena Descripción
  • |–|–|–|
  • 0 Correcto El VDA se ha agregado correctamente al catálogo de máquinas.
  • -1 Argumento no válido El parámetro de entrada en el token de inscripción no es válido.
  • -2 BrokerAgentNotFound No se encuentra el servicio del agente de broker.
  • -3 Token no válido El token introducido no es válido.
  • -4 Faltan reclamaciones obligatorias del token Faltan las reclamaciones obligatorias para el token, por ejemplo, CustomerId o URI de inscripción.
    -5 Error interno Se ha producido un error general.
  • -6 Tiempo de espera agotado La tarea ha agotado el tiempo de espera.
    -7 No se pudo determinar el estado de unión de la máquina a AD El servicio que devuelve el estado de unión de la máquina a AD falló.
    -8 ADMachineFailedToFindSid El servicio que devuelve el SID de la máquina AD falló.
    -9 Error en la solicitud de inscripción La solicitud falló debido a un error HTTP.
  • -10 Faltan campos obligatorios en la respuesta de inscripción A la respuesta de la herramienta de inscripción le falta el parámetro VirtualSiteId.
    -11 Permiso insuficiente No tienes el permiso necesario para ejecutar la tarea.
    -12 No se pudo determinar el estado de unión de la máquina a Aad El servicio que comprueba el estado de unión de la máquina a AD arroja un error.
    -13 AadMachineFailedToFindDeviceId El parámetro adicional AAD device id agregado por el sistema está vacío.
  • -14 AadDeviceIdNotValid El parámetro adicional AAD device id agregado por el sistema no es un GUID válido.
    -15 NoValidMacAddress Dirección MAC no válida.
    -16 FailedToGetComputerHostNameForVdaInstanceName No se pudo obtener el nombre de host del equipo para establecer el parámetro adicional VdaInstanceName.
    -17 VirtualDesktopAgentRegistryKeyFailedToOpen No se pudo abrir la clave de registro del VDA para escribir la lista de controladores de entrega.
  • -18 El token fallido alcanzó el recuento máximo El token fallido alcanzó el recuento máximo.

Usar PowerShell

-  Esta sección detalla cómo puedes administrar catálogos usando PowerShell:

-  [Recuperar advertencias y errores asociados a un catálogo](/es-es/citrix-virtual-apps-desktops/install-configure/machine-catalogs-manage.html#retrieve-warnings-and-errors-associated-with-a-catalog)
-  [Agregar descripciones a una imagen](/es-es/citrix-virtual-apps-desktops/install-configure/machine-catalogs-manage.html#add-descriptions-to-an-image)

Puedes obtener errores y advertencias históricos para comprender los problemas con tu catálogo de máquinas MCS y solucionarlos.

Usando comandos de PowerShell, puedes:

-  Obtener una lista de errores o advertencias
-  Cambiar el estado de la advertencia de **Nuevo** a **Reconocido**
  • Eliminar los errores o advertencias

Para ejecutar los comandos de PowerShell:

-  1.  Abre una ventana de PowerShell.
  1. Ejecuta asnp citrix* para cargar los módulos de PowerShell específicos de Citrix.

Para obtener una lista de errores y advertencias:

Ejecuta el comando Get-ProvOperationEvent.

  • Sin parámetros: Obtiene todos los errores y advertencias
  • Con los parámetros LinkedObjectType y LinkedObjectUid: Obtiene todos los errores y advertencias asociados a un esquema de aprovisionamiento específico
  • Con el parámetro EventId: Obtiene un error o advertencia específico que coincida con este ID de evento
  • Con el parámetro Filter: Obtiene errores o advertencias mediante un filtro personalizado

Para cambiar el estado de los errores o advertencias de Nuevo a Reconocido:

Ejecuta el comando Confirm-ProvOperationEvent.

  • Con el parámetro EventId: Establece el estado de un error o advertencia específico que coincida con este ID de evento. Puedes obtener el EventId de un error o advertencia específico como salida del comando Get-ProvOperationEvent
  • Con los parámetros LinkedObjectType y LinkedObjectUid: Establece el estado de todos los errores y advertencias asociados a un esquema de aprovisionamiento específico
  • Con el parámetro All: Establece el estado de todos los errores y advertencias como Reconocido

Para eliminar los errores o advertencias:

Ejecuta el comando Remove-ProvOperationEvent.

  • Con el parámetro EventId: Elimina un error o advertencia específico que coincida con este ID de evento. Puedes obtener el EventId de un error o advertencia específico como salida del comando Get-ProvOperationEvent
  • Con los parámetros LinkedObjectType y LinkedObjectUid: Elimina todos los errores y advertencias asociados a un esquema de aprovisionamiento específico
  • Con el parámetro All: Elimina todos los errores o advertencias

Para obtener más información, consulta el SDK de PowerShell de Citrix.

    -  ## Eliminar máquinas sin acceso al hipervisor

    -  Al eliminar una VM o un esquema de aprovisionamiento, MCS necesita quitar etiquetas de la VM y, a veces, también del disco base, para que los recursos incluidos en las opciones de eliminación ya no sean rastreados o identificados por MCS. Sin embargo, algunos de estos recursos solo son accesibles a través del hipervisor. Usa la opción `PurgeDBOnly` en el comando de PowerShell `Remove-ProvVM` para eliminar objetos de recursos de VM, como la VM, el disco base, la imagen en ACG, etc., de la base de datos incluso cuando no haya acceso al hipervisor.

-  Esta opción está habilitada en:
  • todos los hipervisores compatibles
    • VM persistentes y no persistentes

Limitaciones 

-  No puedes usar los comandos -PurgeDBOnly y -ForgetVM al mismo tiempo.

Usar el comando PurgeDBOnly

Al ejecutar el comando de PowerShell Remove-ProvVM -ProvisioningSchemeName SCVMM-MC -VMName SCVMM01 -ForgetVM, la operación de eliminación podría fallar en los siguientes escenarios:

-  La conexión del host está en modo de mantenimiento
  • Credenciales no válidas
  • Fallo de autenticación
  • Operación no autorizada
  • El hipervisor es inalcanzable

Nota:

  • Remove-provVM -ForgetVM solo se dirige a las VM persistentes. Si una de las VM de la lista no es persistente, la operación falla.

Cuando la operación falla porque el hipervisor es inalcanzable, aparece el siguiente mensaje:

  • Intenta usar la opción -PurgeDBOnly para limpiar la base de datos de DDC.

Usa la opción -PurgeDBOnly en el comando de PowerShell Remove-ProvVM para eliminar referencias de una VM de la base de datos de MCS. Por ejemplo,

  • Remove-ProvVM -ProvisioningSchemeName SCVMM-MC -VMName SCVMM01 -PurgeDBOnly

Agregar descripciones a una imagen

Puedes agregar descripciones informativas sobre los cambios relacionados con las actualizaciones de imágenes para los catálogos de máquinas. Usa esta función para agregar una descripción al crear un catálogo o al actualizar una imagen maestra existente para un catálogo. También puedes mostrar información para cada imagen maestra en el catálogo. Usa los siguientes comandos para agregar o ver descripciones de imágenes:

-  Para agregar una nota al crear un catálogo de máquinas con una imagen maestra, usa el parámetro `MasterImageNote` en el comando `NewProvScheme`. Por ejemplo:

```
C:\PS>New-ProvScheme -ProvisioningSchemeName <name> -HostingUnitName <name> -IdentityPoolName <name> -MasterImageVM
XDHyp:\HostingUnits\<hosting unit name>\<vm name>.vm\Base.snapshot -MasterImageNote "Note"
<!--NeedCopy--> ```

-  Para actualizar la imagen maestra asociada a un catálogo de máquinas, usa el parámetro `MasterImageNote` en el comando `Publish-ProvMasterVMImage`. Por ejemplo:

```
C:\PS>Publish-ProvMasterVMImage -ProvisioningSchemeName <name> -MasterImageVM XDHyp:\HostingUnits\<hosting unit name>\<vm name>.vm\base.snapshot -MasterImageNote "Note"
<!--NeedCopy--> ```

  • Para mostrar la información de cada imagen, usa el comando Get-ProvSchemeMasterVMImageHistory. Por ejemplo:

     C:\PS>Get-ProvSchemeMasterVMImageHistory -ProvisioningSchemeName MyScheme -Showall
 <!--NeedCopy-->

  • Para seguir el progreso de la reversión, busca el catálogo en Catálogos de máquinas para ver la barra de progreso en línea y el gráfico de progreso paso a paso.

  • No puedes revertir en ciertos escenarios, incluidos los siguientes. (La opción Revertir imagen maestra no está visible).

  • No tienes permiso para revertir.
  • El catálogo no se creó con MCS.
  • El catálogo se creó con una imagen del disco del sistema operativo.
    • La instantánea utilizada para crear el catálogo se ha dañado.
      • Los cambios de usuario en las máquinas del catálogo no persisten.
      • Las máquinas del catálogo están en ejecución.

Restablecer disco del sistema operativo

Usa el comando de PowerShell Reset-ProvVMDisk para restablecer el disco del sistema operativo de una VM persistente en un catálogo de máquinas creado con MCS. Actualmente, esta función es aplicable a los entornos de virtualización de AWS, Azure, XenServer, Google Cloud, SCVMM y VMware.

Para ejecutar correctamente el comando de PowerShell, asegúrate de que:

-  Las VM de destino están en un catálogo MCS persistente.
    -  El catálogo de máquinas MCS funciona correctamente.
    -  Esto implica que el esquema de aprovisionamiento y el host existen, y que el esquema de aprovisionamiento tiene entradas correctas.
  • El hipervisor no está en modo de mantenimiento.
  • Las VM de destino están apagadas y en modo de mantenimiento.

Realiza los siguientes pasos para restablecer el disco del sistema operativo:

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

  3. Ejecuta el comando de PowerShell Reset-ProvVMDisk de cualquiera de las siguientes maneras:

    • Especifica la lista de VM como una lista separada por comas y realiza el restablecimiento en cada VM:

       Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName ("abc","def") -OS
 <!--NeedCopy-->

    • Especifica la lista de VM como una salida del comando Get-ProvVM y realiza el restablecimiento en cada VM:

       (Get-ProvVM -ProvisioningSchemeName "xxx") | Reset-ProvVMDisk "abc" -OS
 <!--NeedCopy-->

    • Especifica una sola VM por nombre:

      ```

    • Reset-ProvVMDisk -ProvisioningSchemeName “xxx” -VMName “abc” -OS

      ```

    • Crea tareas de restablecimiento separadas para cada una de las VM devueltas por el comando Get-ProvVM. Esto es menos eficiente porque cada tarea realizará las mismas comprobaciones redundantes, como la comprobación de capacidad del hipervisor y la comprobación de conexión para cada VM.

       Get-ProvVM -ProvisioningSchemeName "xxx" | Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -OS
 <!--NeedCopy-->
  4. Aparece un mensaje de confirmación que enumera las VM que se van a restablecer junto con un mensaje de advertencia de que es una operación irrecuperable. Si no proporcionas una respuesta y pulsas Intro, no se realizará ninguna acción adicional.

  • Nota:

    No saques las VM del modo de mantenimiento ni las enciendas hasta que finalice el proceso de restablecimiento.

    Puedes ejecutar el comando de PowerShell -WhatIf para imprimir la acción que realizaría y salir sin realizar la acción.

    También puedes omitir el mensaje de confirmación usando uno de los siguientes métodos:

    • Proporciona el parámetro -Force:

       Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Force
 <!--NeedCopy-->

    • Proporciona el parámetro -Confirm:$false:

       Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Confirm:$false
 <!--NeedCopy-->

    • Antes de ejecutar Reset-ProvVMDisk, cambia $ConfirmPreference a None:

       PS C:\Windows\system32> $ConfirmPreference='None'
 PS C:\Windows\system32> $ConfirmPreference
 None
 PS C:\Windows\system32> Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS
 <!--NeedCopy-->
  1. Ejecuta Get-ProvTask para obtener el estado de las tareas devueltas por el comando Reset-ProvVMDisk.

Cambiar la configuración de red para un esquema de aprovisionamiento existente

Puedes cambiar la configuración de red para un esquema de aprovisionamiento existente para que las nuevas máquinas virtuales se creen en la nueva subred. Usa el parámetro -NetworkMapping en el comando Set-ProvScheme para cambiar la configuración de red.

Nota:

Esta característica es compatible con Citrix Virtual Apps and Desktops 2203 LTSR CU3 y versiones posteriores.

Para cambiar la configuración de red para un esquema de aprovisionamiento existente, haz lo siguiente:

  1. En la ventana de PowerShell, ejecuta el comando asnp citrix* para cargar los módulos de PowerShell.
  2. Ejecuta (Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps para acceder a la ruta de red que quieres cambiar.

  3. Asigna una variable a la nueva configuración de red. Por ejemplo:

    $NewNetworkMap = @{"0"= "XDHYP:\HostingUnits\MyNetworks\Network 0.network"}
<!--NeedCopy-->
  4. Ejecuta Set-ProvScheme -ProvisioningSchemeName "name" -NetworkMapping $NewNetworkMap.
  5. Ejecuta (Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps para verificar la nueva configuración de red para el esquema de aprovisionamiento existente.

  • Administrar versiones de un catálogo de máquinas

Cuando se actualiza un catálogo de máquinas MCS con el comando Set-ProvScheme, la configuración actual se guarda como una versión. Luego puedes administrar las distintas versiones del catálogo de máquinas usando comandos de PowerShell. Puedes:

  • Ver la lista de versiones de un catálogo de máquinas
  • Usar cualquier versión anterior para actualizar el catálogo de máquinas
  • Eliminar manualmente una versión si no la usa una máquina virtual de ese catálogo de máquinas

  • Cambiar el número máximo de versiones que debe conservar el catálogo de máquinas (el valor predeterminado es 99)

     -  Una versión incluye la siguiente información de un catálogo de máquinas:
  • VMCpuCount
  • VMMemoryMB
  • CustomProperties
  • ServiceOffering
  • MachineProfile
  • NetworkMapping
  • SecurityGroup

Ejecuta los siguientes comandos (proporcionados como ejemplos) para administrar las distintas versiones de un catálogo de máquinas.

  • Para ver los detalles de configuración de las distintas versiones de un catálogo de máquinas:

     Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog
 <!--NeedCopy-->

  • Para ver los detalles de configuración de una versión específica de un catálogo de máquinas:

     Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 2
 <!--NeedCopy-->

  • Para ver el número total de versiones asociadas a un catálogo de máquinas:

    ```

  • (Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog).Count

    ```

  • Para usar cualquier versión anterior para actualizar el catálogo de máquinas:

     Set-ProvScheme -ProvisioningSchemeName AzureCatalog -Version 2
 <!--NeedCopy-->

  • Para eliminar manualmente una versión si no la usa una máquina virtual de ese catálogo de máquinas:

     Remove-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 3
 <!--NeedCopy-->

  • Para establecer el número máximo de versiones que debe conservar el catálogo de máquinas (el valor predeterminado es 99). Esta configuración se aplica a todos los catálogos. Por ejemplo, en este caso, se conservará un máximo de 15 versiones para todos los catálogos aprovisionados por MCS.

     Set-ProvServiceConfigurationData -Name "MaxProvSchemeVersions" -Value 15
 <!--NeedCopy-->

Si el número de versiones alcanza el número máximo de versiones, no se podrá crear una nueva versión si las versiones anteriores están en uso por alguna de las máquinas virtuales del catálogo de máquinas. En ese caso, haz una de las siguientes acciones:

  • Aumenta el límite del número máximo de versiones que debe conservar el catálogo de máquinas.
  • Actualiza algunas máquinas virtuales que están en versiones anteriores para que esas versiones anteriores dejen de ser referenciadas por máquinas virtuales, y puedan eliminarse.

Convertir un catálogo de máquinas no basado en perfiles de máquina a un catálogo de máquinas basado en perfiles de máquina

Puedes usar una máquina virtual, una especificación de plantilla (en el caso de Azure), una plantilla de lanzamiento (en el caso de AWS) o una plantilla de VMware (en el caso de VMware) como entrada de perfil de máquina para convertir un catálogo de máquinas sin perfil de máquina en un catálogo de máquinas basado en perfil de máquina. Las nuevas máquinas virtuales agregadas al catálogo toman los valores de propiedad del perfil de máquina, a menos que se sobrescriban con una propiedad personalizada explícita.

Nota:

Un catálogo de máquinas basado en perfil de máquina existente no se puede cambiar a un catálogo de máquinas sin perfil de máquina.

Para hacer esto:

  1. Crea un catálogo de máquinas persistente o no persistente con máquinas virtuales y sin perfil de máquina.
  2. Abre la ventana de PowerShell.

  3. Ejecuta el comando Set-ProvScheme para aplicar los valores de propiedad del perfil de máquina a las nuevas máquinas virtuales agregadas al catálogo de máquinas. Por ejemplo:

    • En el caso de Azure:

       Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile XDHyp:\HostingUnits\<HostingUnitName>\machineprofile.folder\<ResourceGroupName>\<TemplateSpecName>\<VersionName>
 <!--NeedCopy-->

    • En el caso de AWS:

       Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\<launch-template>.launchtemplate\<launch-template-version>.launchtemplateversion"
 <!--NeedCopy-->

    • En el caso de VMware:

        Set-ProvScheme -ProvisioningSchemeName "my-prov-scheme" -MachineProfile "XDHyp:\HostingUnits\my-hosting-unit\my-template.template"
 <!--NeedCopy-->

      Nota:

      Establece el FolderID como propiedad personalizada para evitar derivar el FolderID de la plantilla de VMware.

Reparar la información de identidad de las cuentas de equipo activas

Puedes restablecer la información de identidad de las cuentas de equipo activas que tengan problemas relacionados con la identidad. Puedes elegir restablecer solo la contraseña de la máquina y las claves de confianza, o restablecer toda la configuración del disco de identidad. Esta implementación es aplicable tanto a los catálogos de máquinas MCS persistentes como a los no persistentes.

Nota:

Actualmente, la función es compatible con los entornos de virtualización de AWS, GCP, Azure, SCVMM, XenServer y VMware.

Condiciones

Asegúrate de lo siguiente para restablecer correctamente el disco de identidad:

  • Apaga la máquina virtual y ponla en modo de mantenimiento
  • No incluyas el parámetro -OS en el comando de PowerShell

Restablecer el disco de identidad

Para restablecer el disco de identidad:

  1. Abre la ventana de PowerShell.
  2. Ejecuta asnp citrix* para cargar los módulos de PowerShell específicos de Citrix.

  3. Restablece la información de identidad.

    • Para restablecer solo la contraseña de la máquina y las claves de confianza, ejecuta el siguiente comando:

       Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo
 <!--NeedCopy-->

      La descripción de los parámetros utilizados en el comando es la siguiente:

      • IdentityAccountName: El nombre de la cuenta de identidad que debe repararse.
      • PrivilegedUserName: Cuenta de usuario que tiene permiso de escritura en el proveedor de identidades (AD o AzureAD).
      • PrivilegedUserPassword: Contraseña para PrivilegedUserName.
      • Target: Destino de la acción de reparación. Puede ser IdentityInfo para reparar la contraseña de la cuenta/clave de confianza, y UserCertificate para reparar los atributos del certificado de usuario de las identidades de máquina unidas a Microsoft Entra híbrido.

    • Para restablecer toda la configuración del disco de identidad, ejecuta los siguientes comandos en el siguiente orden:

       Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo
 <!--NeedCopy-->

       Reset-ProvVMDisk ProvisioningSchemeName <name> -VMName <name>  -Identity
 <!--NeedCopy-->

    • Para recrear completamente el disco de identidad:

       Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMname <name> -Identity -Recreate
 <!--NeedCopy-->

      Nota:

      Si la máquina es una máquina Windows que usa la versión 2511 de VDA o posterior, seguirá usando el mismo MachineGuid que antes, independientemente de la configuración de -Recreate.

  4. Escriba y para confirmar la acción. También puede omitir el mensaje de confirmación utilizando el parámetro -Force. Por ejemplo:

    Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMName <name> -Identity -Force
<!--NeedCopy-->
  5. Ejecute Get-ProvVM -ProvisioningSchemeName <name -VMName <name> para comprobar la configuración actualizada del disco de identidad. Los atributos del disco de identidad (por ejemplo, IdentityDiskId) deben actualizarse. StorageId e IdentityDiskIndex no deben cambiar.

Cambiar la configuración de la caché en un catálogo de máquinas existente

Después de crear un catálogo no persistente con MCSIO habilitado, puede usar el comando Set-ProvScheme para modificar los siguientes parámetros:

  • WriteBackCacheMemorySize
  • WriteBackCacheDiskSize

Esta función es aplicable actualmente a:

  • entornos de GCP y Microsoft Azure, y
  • un catálogo no persistente con MCSIO habilitado

Requisitos

Los requisitos para modificar la configuración de la caché son:

  • Actualizar a la última versión de VDA (2308 o posterior).

  • Habilitar el parámetro UseWriteBackCache para el catálogo de máquinas existente. Use New-ProvScheme para crear un catálogo de máquinas con UseWriteBackCache habilitado. Por ejemplo:

     New-ProvScheme -ProvisioningSchemeName $CatalogName -HostingUnitUid $HostingUnitUid `
 -IdentityPoolUid $acctPool.IdentityPoolUid -CleanOnBoot `
 -MasterImageVM $MasterImage `
 -ServiceOffering $ServiceOffering `
 -NetworkMap $NetworkMap `
 -SecurityGroup $SecurityGroup `
 -UseWriteBackCache -WriteBackCacheDiskSize 8
 <!--NeedCopy-->

Cambiar la configuración de la caché

Ejecute el comando Set-ProvScheme. Por ejemplo:

Set-ProvScheme -ProvisioningSchemeName $provScheme.ProvisioningSchemeName -WriteBackCacheDisk32 -WriteBackCacheMemorySize 128
<!--NeedCopy-->

Nota:

  • El valor de WriteBackCacheDiskSize debe ser superior a cero, ya que se requiere al menos 1 GB de almacenamiento en disco de caché.
  • El valor de WriteBackCacheMemorySize debe ser inferior al tamaño de la memoria del catálogo de máquinas.
  • Estos cambios solo afectan a las nuevas máquinas virtuales añadidas al catálogo después de realizar el cambio. Las máquinas virtuales existentes no se ven afectadas por estos cambios.

Compatibilidad con la actualización de VDA mediante el acceso a recursos compartidos de archivos locales

Especifique la ubicación del instalador de VDA mediante cmdlets de PowerShell, lo que reduce el esfuerzo de proporcionar reglas de red para permitir que cada VDA vaya y obtenga el nuevo instalador de VDA desde la CDN de Azure administrada por Citrix.

Cmdlets de PowerShell

Se han añadido dos nuevos parámetros opcionales a los cmdlets New-VusCatalogSchedule y New-VusMachineUpgrade que le permiten usar instaladores desde un recurso compartido de archivos local

  • VdaWorkstationPackageUri - para especificar la ruta UNC al instalador de VDA del sistema operativo de la estación de trabajo
  • VdaServerPackageUri - para especificar la ruta UNC al instalador de VDA del sistema operativo del servidor

Requisitos previos

  • Instalador del agente VUS que viene con VDA 2311
  • Agente de actualización de VDA a la versión 7.40.0.35 o posterior (usando el instalador de VDA versión 2311 o posterior)
  • SDK de PowerShell remoto de Virtual Apps and Desktops versión 7.40 o posterior (lanzado el 10 de enero de 2024 o posterior)

Cómo configurar los permisos de recurso compartido de archivos

Los recursos compartidos de red que contienen paquetes de instaladores de VDA deben tener acceso de lectura para el servicio Agente de actualización de VDA, que se ejecuta como Sistema local (entidad de seguridad NT AUTHORITY\SYSTEM).

  • Permiso de recurso compartido de archivos unido a un dominio

    Cuando la máquina VDA está unida a un dominio, la cuenta de Sistema local (VUA se ejecuta como Sistema local) utiliza las credenciales del equipo al acceder a los recursos compartidos de red.

    El permiso de menor privilegio se puede establecer concediendo acceso de Lectura a los equipos del dominio.

    1. Elija las personas de su red con las que desea compartir el archivo.
    2. Haga clic en Configuración de uso compartido avanzado y active Uso compartido de archivos e impresoras.

  • Permiso de recurso compartido de archivos no unido a un dominio

    Cuando la máquina VDA no está unida a un dominio, la cuenta de Sistema local (VUA se ejecuta como Sistema local) usa el INICIO DE SESIÓN ANÓNIMO al acceder a recursos compartidos de red.

  1. Selecciona una carpeta compartida.
  2. Deshabilita la protección con contraseña.
    1. Ve a las Propiedades de la carpeta.
    2. Selecciona Centro de redes y recursos compartidos.
    3. Desactiva el Uso compartido protegido con contraseña.
  3. Haz clic en Uso compartido avanzado para conceder un permiso de recurso compartido.
    1. Selecciona Permisos.
    2. Concede un permiso de recurso compartido de Lectura a INICIO DE SESIÓN ANÓNIMO.
  4. Selecciona la ficha Seguridad para conceder permisos de carpeta.
    1. Haz clic en Editar para agregar permisos a la carpeta compartida.
    2. Selecciona la carpeta compartida para conceder permisos de carpeta a INICIO DE SESIÓN ANÓNIMO.
  5. Haz clic en Avanzado para activar el Uso compartido de archivos e impresoras.
  6. Agrega el nombre de la carpeta compartida a la Directiva de seguridad de acceso a la red.

Nota:

Reinicia tu máquina para que el cambio surta efecto de inmediato.

Actualizaciones de VDA desde un recurso compartido de archivos local

  1. Descarga el instalador de VDA y colócalo en el archivo compartido.

    Nota:

    Con el servicio de actualización virtual, puedes seleccionar entre la pista de la versión actual o la pista LTSR.

    Por ejemplo: Si el catálogo de máquinas está configurado para la versión actual, que es la 2311, y la versión de VDA es la 2305, debes actualizar el VDA a la versión 2311.

    1. Ve a la página de Descargas en nuestro sitio web.
    2. Selecciona Citrix Virtual Apps and Desktops como producto.
    3. Selecciona Citrix Virtual Apps and Desktops 7 2311, Todas las ediciones.
    4. Selecciona el instalador de VDA de la sección expandible Componentes que están en la ISO del producto, pero también se empaquetan por separado.

  2. Selecciona el instalador de VDA relevante según el tipo de catálogo.

    • Descarga el instalador de VDA para SO multisesión si el tipo de catálogo es multisesión.
    • Descarga el instalador de VDA para SO de sesión única si el tipo de catálogo es sesión única.
    • Descarga el instalador de VDA para servicios principales de SO de sesión única si el tipo de catálogo es Acceso con PC remoto.

Nota:

La versión del instalador del recurso compartido de archivos debe coincidir exactamente con la versión del instalador más reciente publicada por VUS en la nube.

Migración de almacenamiento de máquinas virtuales

Puedes mover el almacenamiento en disco de las máquinas virtuales existentes de un almacenamiento antiguo a uno nuevo en entornos VMware y XenServer. Durante la migración, MCS conserva las capacidades de las máquinas virtuales, como la administración de energía, el restablecimiento del disco del SO, etc. También puedes agregar nuevas máquinas virtuales al catálogo de máquinas usando el nuevo almacenamiento en disco. Para ello, usa el comando de PowerShell Move-ProvVMDisk.

Puedes migrar máquinas virtuales persistentes de clonación completa y máquinas virtuales no persistentes.

  • Para máquinas virtuales persistentes de clonación completa: disco del SO, disco de identidad y discos aprovisionados sin MCS.
  • Para máquinas virtuales no persistentes: disco del SO, disco de identidad y disco de caché de escritura diferida (WBC).

El nuevo almacenamiento debe cumplir las siguientes condiciones:

  • Debe estar dentro del mismo clúster que el almacenamiento antiguo.
  • El host en el que se ejecuta la máquina virtual debe tener acceso tanto a los almacenes de datos antiguos como a los nuevos.

Migrar el almacenamiento en disco

Para migrar el almacenamiento en disco:

  1. Agrega un almacenamiento de destino a una unidad de alojamiento existente. Puedes ejecutar el comando de PowerShell Add-Hyphostingunitstorage para agregar el almacenamiento de destino:

    Si no quieres agregar nuevas máquinas virtuales al almacenamiento antiguo, cambia el almacenamiento antiguo a Sustituido. Puedes hacerlo usando Studio o comandos de PowerShell. Para Studio, consulta Modificar almacenamiento. Alternativamente, ejecuta Set-Hyphostingunitstorage y establece Superseded como true para deshabilitar la creación de nuevas máquinas virtuales en el almacenamiento antiguo.

    Nota:

    Para máquinas virtuales no persistentes:

    • Si se usa WBC, configura el almacenamiento de destino de WBC en la unidad de alojamiento.
    • Si el almacenamiento de destino del SO está configurado, WBC (si se usa) debe ser compatible con el almacenamiento de destino del SO.
    • Si el almacenamiento de destino del SO no está configurado, WBC (si se usa) debe ser compatible con el almacenamiento del SO actual.
  2. Apaga las máquinas virtuales y activa el Modo de mantenimiento.

  3. Obtén la información sobre el esquema de aprovisionamiento, la unidad de alojamiento, el almacenamiento en disco del SO y el almacenamiento en disco de WBC.

    • Ejecuta ProvResourceInStorage para obtener información de almacenamiento del SO. Por ejemplo:

       $result=Get-ProvSchemeResourceInStorage -ProvisioningSchemeName xxxxx
 $result
 $result.ProvResourceInStorage | Format-List -Property *
 <!--NeedCopy-->

    • Ejecuta TemporaryStorageInfo para obtener información de almacenamiento de WBC. Por ejemplo:

       $result=Get-ProvSchemeResourceInStorage -ProvisioningSchemeName xxxxx
 $result
 $result.TemporaryStorageInfo | Format-List -Property *
 <!--NeedCopy-->

  4. Migra el disco del SO, el disco de identidad y el disco de WBC (aplicable a máquinas virtuales no persistentes) al almacenamiento de destino usando el comando de PowerShell Move-ProvVMDisk.

    Nota:

    • Proporciona siempre los discos del SO y de identidad en los parámetros DiskType y DestinationStorageId.
    • El DestinationStorageId para el disco del SO y el disco de identidad debe ser el mismo.

    Ejemplo:

    Máquinas virtuales persistentes:

    (Get-ProvVM -ProvisioningSchemeName xxxxx) | Move-ProvVMDisk -ProvisioningSchemeName "myFullCloneProvScheme" -VMName "machine01" -DiskType OS,Identity -DestinationStorageId datastore1,datastore1
<!--NeedCopy-->

    Importante:

    Para las VM persistentes, se mueven todos los discos. No puedes seleccionar qué discos mover.

    VM no persistentes:

    (Get-ProvVM -ProvisioningSchemeName xxxxx) | Move-ProvVMDisk -ProvisioningSchemeName "myCleanOnBootProvScheme" -VMName "machine01" -DiskType OS,Identity,WBC -DestinationStorageId None,None,datastore1
<!--NeedCopy-->

    Importante:

    • Si no quieres migrar un disco específico, establece el valor como None para el parámetro DestinationStorageId.
    • Si la VM tiene un disco WBC, agrega el disco WBC en el parámetro DiskType y la información requerida en el parámetro DestinationStorageId.

Migrar catálogos aprovisionados por MCS existentes a un catálogo de máquinas con imagen preparada

Puedes convertir un catálogo de máquinas aprovisionado por MCS existente en un catálogo de máquinas con imagen preparada mediante el comando de PowerShell Set-ProvSchemeImage. Sin embargo, no puedes volver al catálogo heredado después de la migración. Actualmente, esta función es aplicable a entornos de virtualización de Azure y VMware.

Limitaciones

Ten en cuenta las siguientes limitaciones:

  • Si el catálogo de MCS usa un disco de datos persistente, el catálogo no se puede migrar para usar una imagen preparada.
  • Si el catálogo de MCS usa discos no administrados, el catálogo no se puede migrar para usar una imagen preparada.

Migrar a un catálogo de máquinas con imagen preparada

Para migrar, haz lo siguiente:

  1. Crea una definición de imagen y versiones de imagen mediante Studio o comandos de PowerShell. Consulta los pasos para crear definiciones de imagen y versiones de imagen en:

  2. Ejecuta el comando Get-ProvScheme para obtener el UID del esquema de aprovisionamiento. Por ejemplo:

    Get-ProvScheme -ProvisioningSchemeName <name> | select ProvisioningSchemeName, ProvisioningSchemeUid
<!--NeedCopy-->

  3. Ejecuta el comando Get-ProvImageVersionSpec para obtener el nombre de la definición de imagen y el UID de la especificación de la versión de la imagen. Por ejemplo:

    Get-ProvImageVersionSpec -ImageDifinitionName <name> -Filter {IsPrepared -eq $true} | select ImageDefinitionName ImageVersionSpecUId
<!--NeedCopy-->

  4. Ejecuta el comando Set-ProvSchemeImage para migrar un catálogo de máquinas aprovisionado por MCS existente a un catálogo de máquinas con imagen preparada. Por ejemplo:

    Set-ProvSchemeImage -ProvisioningSchemeName [ProvisioningSchemeName] -ImageVersionSpecUid [ImageVersionSpecUid]
<!--NeedCopy-->

  5. Ejecuta el comando Get-ProvScheme para comprobar que el catálogo se ha migrado. Por ejemplo:

    Get-ProvScheme -ProvisioningSchemeName <name> | select ProvisioningSchemeName, ProvisioningSchemeUid, ImageVersionSpecUid
<!--NeedCopy-->

Solución de problemas

Qué hacer a continuación

Para obtener información sobre cómo administrar catálogos de servicios en la nube específicos, consulta:

Administrar catálogos de máquinas
April 7, 2026
Contribución de: 
C C
April 7, 2026
Contribución de: 
C 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.