Documentación de productos
Citrix Virtual Apps and Desktops 7 2311
Ver PDF

Administrar catálogos de máquinas

May 31, 2026
Contribución de: 
C C

Nota:

Puede administrar su implementación de Citrix Virtual Apps and Desktops™ mediante dos consolas de administración: Web Studio (basada en web) y Citrix Studio (basada en Windows). Este artículo solo cubre Web Studio. Para obtener información sobre Citrix Studio, consulte el artículo equivalente en Citrix Virtual Apps and Desktops 7 2212 o versiones anteriores.

Introducción

Puede agregar o quitar máquinas de un catálogo de máquinas, cambiar el nombre, cambiar 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 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, las actualizaciones de las máquinas de los usuarios se administran fuera de Web Studio. Realice 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, consulte Conexiones y recursos.

Nota:

MCS no es compatible con Windows 10 IoT Core y Windows 10 IoT Enterprise. Consulte 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 nuevas máquinas creadas para el catálogo utilizan la imagen actualizada. Las instancias preexistentes continúan 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. Tenga en cuenta lo siguiente:

  • Con los catálogos de discos persistentes, las máquinas preexistentes no se actualizan a la nueva imagen, pero las nuevas máquinas que se agreguen al catálogo utilizarán 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 reinicia la máquina.
  • Con los catálogos de máquinas persistentes, la actualización de la imagen también actualiza las instancias de catálogo que la utilizan.
  • Para los catálogos que no son persistentes, si quiere imágenes diferentes para máquinas diferentes, las imágenes deben residir en catálogos separados.

Administrar catálogos de máquinas

Puede administrar un catálogo de máquinas de dos maneras:

Usar Web Studio

Esta sección detalla cómo puede administrar catálogos mediante Web Studio:

Antes de empezar:

  • Asegúrese de que el host de virtualización tenga suficientes procesadores, memoria y almacenamiento para alojar las máquinas adicionales.
  • Asegúrese de tener suficientes cuentas de equipo de Active Directory sin usar. Si utiliza cuentas existentes, el número de máquinas que puede agregar está limitado por el número de cuentas disponibles.
  • Si utiliza Web Studio para crear cuentas de equipo de Active Directory para las máquinas adicionales, debe tener el permiso de administrador de dominio adecuado.

Para agregar máquinas a un catálogo:

  1. Inicie sesión en Web Studio.
  2. Seleccione Catálogos de máquinas en el panel izquierdo.
  3. Seleccione un catálogo de máquinas y, a continuación, seleccione Agregar máquinas en la barra de acciones.
  4. Seleccione el número de máquinas virtuales que quiere agregar.
  5. Si hay cuentas de Active Directory existentes insuficientes para el número de máquinas virtuales que va a agregar, seleccione el dominio y la ubicación donde se crean las cuentas. Especifique un esquema de nombres de cuenta, utilizando signos de almohadilla para indicar dónde aparecen números o letras secuenciales. No utilice una barra inclinada (/) en un nombre de OU. Un nombre no puede empezar por 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 utiliza cuentas de Active Directory existentes, busque las cuentas o haga clic en Importar y especifique un archivo .csv que contenga los nombres de las cuentas. Asegúrese de que haya suficientes cuentas para todas las máquinas que va a agregar. Web Studio administra estas cuentas. Permita que Web Studio restablezca las contraseñas de todas las cuentas, o especifique 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 al crear muchas máquinas. La creación de máquinas continúa incluso si cierra 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úrese de que:

  • Los datos de usuario estén respaldados o ya no sean necesarios.
  • Todos los usuarios hayan 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. Inicie sesión en Web Studio.
  2. Seleccione Catálogos de máquinas en el panel izquierdo.
  3. Seleccione un catálogo y, a continuación, seleccione Ver máquinas en la barra de acciones.
  4. Seleccione una o varias máquinas y, a continuación, seleccione Eliminar en la barra de acciones.

Elija si desea eliminar las máquinas que se van a quitar. Si elige eliminar las máquinas, indique si las cuentas de Active Directory de esas máquinas se conservan, se inhabilitan o se eliminan.

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

  5. Es posible que vea páginas adicionales en función del tipo de catálogo.

    Para los catálogos creados con una imagen de Azure Resource Manager, las siguientes páginas están visibles. Tenga en cuenta que los cambios que realice solo se aplican a las máquinas que agregue al catálogo más adelante. Las máquinas existentes no cambian.

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

      Nota:

      • Solo se muestran los tamaños de máquina que admite el catálogo.
      • Si es necesario, seleccione 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.

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

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

    • En la página Tipos de almacenamiento y licencias, elija si desea cambiar 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 admite el tamaño de máquina actual, aparece un cuadro de diálogo de advertencia que le informa de que al cambiar la configuración se restablecerá la configuración del tamaño de la máquina. Si decide continuar, aparece un punto rojo junto al menú Máquinas virtuales, lo que le pide que seleccione un nuevo tamaño de máquina.

    • En la página Tipo de licencia, elija si desea cambiar la configuración de la licencia de Windows o de la licencia 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, cambie la configuración de administración de energía y seleccione una conexión de administración de energía.
    • En la página Unidades organizativas, agregue o quite UO de Active Directory.
  6. Haga clic en Aplicar para aplicar los cambios realizados y haga clic en Guardar para salir.
  1. Inicie sesión en Web Studio.
  2. Seleccione Catálogos de máquinas en el panel izquierdo.
  3. Seleccione un catálogo y, a continuación, seleccione Cambiar nombre del catálogo de máquinas en la barra de acciones.
  4. Introduzca el nuevo nombre.

Mover un catálogo a una zona diferente

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

Mover un catálogo a una zona diferente, que no sea el hipervisor que contiene las máquinas virtuales de ese catálogo, afecta al rendimiento.

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

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

  • Todos los usuarios han cerrado sesión y no hay sesiones desconectadas en ejecución.
  • El modo de mantenimiento está activado para todas las máquinas del catálogo para 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 contiene máquinas del catálogo.

Para eliminar un catálogo:

  1. Inicie sesión en Web Studio.
  2. Seleccione Catálogos de máquinas en el panel izquierdo.
  3. Seleccione un catálogo y, a continuación, seleccione Eliminar catálogo de máquinas en la barra de acciones.
  4. Indique si las máquinas del catálogo se eliminan. Si decide eliminar las máquinas, indique si las cuentas de equipo de Active Directory para esas máquinas se conservan, se deshabilitan o se eliminan.

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

  • Liberar cuentas de máquina no utilizadas eliminando las cuentas de equipo de Active Directory de los catálogos de SO de sesión única y SO de varias sesiones. Esas cuentas se pueden utilizar para otras máquinas.
  • Añada cuentas para que, cuando se añadan más máquinas al catálogo, las cuentas de equipo ya estén en su lugar. No utilice una barra inclinada (/) en un nombre de OU.

Para administrar cuentas de Active Directory:

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

  4. Elija si desea agregar o eliminar cuentas de equipo. Si agrega cuentas, especifique qué hacer con las contraseñas de las cuentas: restablecerlas todas o introducir una contraseña que se aplique a todas las cuentas.

    Puede restablecer las contraseñas si no conoce las contraseñas actuales de las cuentas; debe 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, elija si la cuenta en Active Directory se mantiene, se inhabilita o se elimina.

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

Recomendamos que guarde 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. Revierta las máquinas de un catálogo para usar la versión anterior de la imagen maestra. Realice esta tarea si los usuarios encuentran problemas con las actualizaciones que implementó en sus escritorios. Esto minimiza el tiempo de inactividad del usuario. No elimine, mueva ni cambie el nombre de las imágenes maestras. No puede 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, actualice una imagen maestra existente o cree una en su hipervisor host.

  1. En su hipervisor, tome una instantánea de la VM actual y asigne a la instantánea un nombre significativo. Esta instantánea se puede utilizar para revertir (restaurar) las máquinas del catálogo, si es necesario.
  2. Si es necesario, encienda la imagen maestra e inicie sesión.
  3. Instale las actualizaciones o realice los cambios necesarios en la imagen maestra.
  4. Apague la VM.
  5. Tome una instantánea de la VM. Asígnele 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 crearla mediante la consola de administración del hipervisor. Luego, seleccione esa instantánea en Web Studio. Este proceso le 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 puede 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. Inicie sesión en Web Studio.
  2. Seleccione Catálogos de máquinas en el panel izquierdo.
  3. Seleccione un catálogo y, a continuación, seleccione Cambiar imagen maestra en la barra de acciones.
  4. En la página Imagen maestra, seleccione el host y la imagen que desea implementar.

    Sugerencia:

    Para un catálogo creado con MCS, puede anotar su imagen agregando una nota para la imagen. Una nota puede contener hasta 500 caracteres. Cada vez que cambia la imagen maestra, se crea una entrada relacionada con la nota, ya sea que agregue una nota o no. Si actualiza un catálogo sin agregar una nota, la entrada aparece como nula (-). Para ver el historial de notas de la imagen, seleccione el catálogo, haga clic en Propiedades de la plantilla en el panel inferior y, a continuación, haga clic en Ver historial de notas.

  5. En la página Estrategia de implementación, elija 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 las VM persistentes porque la implementación solo se aplica a las VM no persistentes.

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

Para realizar un seguimiento del progreso de la actualización, localice 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 PowerShell SDK, en lugar de Web Studio, especifique una plantilla de hipervisor (VMTemplates). Utilícela como alternativa a una imagen o una instantánea de una imagen.

Estrategia de implementación:

La actualización de la imagen en el siguiente apagado afectará inmediatamente a cualquier máquina que no esté en uso actualmente, es decir, a las máquinas que no tengan una sesión de usuario activa. Un sistema que está en uso recibe la actualización cuando finaliza la sesión activa actual. Tenga 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 las máquinas con SO de sesión única, las máquinas se actualizan inmediatamente cuando no están en uso o cuando los usuarios no han iniciado sesión.
  • Para un SO multisesión con máquinas secundarias, los reinicios no se producen automáticamente. Para aplicar la imagen maestra actualizada, reinicie las máquinas mediante Studio, PowerShell o Workspace. Reiniciar desde las máquinas o el hipervisor no aplica la actualización.

Sugerencia:

Limite el número de máquinas que se reinician mediante la configuración avanzada de una conexión de host. Utilice 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, puede 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 que funcionaba. Las nuevas funciones que requieren la imagen más reciente ya no están disponibles. Al igual que con la implementación, la reversión de una máquina incluye un reinicio.

  1. Inicie sesión en Web Studio.
  2. Seleccione Catálogos de máquinas en el panel izquierdo.
  3. Seleccione el catálogo y, a continuación, seleccione Revertir imagen maestra en la barra de acciones.
  4. Especifique 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 necesitan 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 obliga a cerrar sesión.

Para realizar un seguimiento del progreso de la reversión, busque 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

Cambie 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 recientes.

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

  • Inicie las máquinas actualizadas para que se registren en 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. Inicie sesión en Web Studio.
  2. Seleccione Catálogos de máquinas en el panel izquierdo.
  3. Seleccione el catálogo. La ficha Detalles del panel inferior muestra la información de la versión.
  4. Seleccione Cambiar nivel funcional. Si Web Studio detecta que el catálogo necesita una actualización, muestra un mensaje. Siga las indicaciones. Si una o varias máquinas no se pueden actualizar, un mensaje explica el motivo. Para asegurarse de que todas las máquinas funcionan correctamente, Citrix recomienda resolver los problemas de las máquinas antes de hacer clic en Cambiar para continuar.

Una vez completado el cambio de catálogo, puede 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, tenga en cuenta las siguientes consideraciones:

  • No se pueden cambiar los parámetros asociados a sistema operativo y administración de máquinas. El catálogo clonado hereda esos parámetros del original.
  • La clonación de un catálogo puede tardar un tiempo en completarse. Si es necesario, seleccione Ocultar progreso para ejecutar la clonación en segundo plano.
  • El catálogo clonado hereda el nombre del original y tiene un sufijo Copy. Puede cambiar el nombre. Consulte Cambiar el nombre de un catálogo.
  • Una vez completada la clonación, asegúrese de asignar el catálogo clonado a un grupo de entrega.
  1. Inicie sesión en Web Studio y, a continuación, seleccione Catálogos de máquinas en el panel izquierdo.
  2. Seleccione un catálogo y, a continuación, seleccione Clonar en la barra de acciones.
  3. En la ventana Clonar catálogo de máquinas seleccionado, vea la configuración del catálogo clonado y configure los ajustes según corresponda. Seleccione Siguiente para pasar a la página siguiente.
  4. En la página Resumen, vea un resumen de la configuración y seleccione Finalizar para iniciar la clonación.
  5. Si es necesario, seleccione Ocultar progreso para ejecutar la clonación en segundo plano.

Organizar catálogos mediante carpetas

Puede crear carpetas para organizar los catálogos y facilitar el acceso. Por ejemplo, puede organizar los catálogos por tipo de imagen o por estructura organizativa.

Antes de empezar, planifique cómo organizar sus catálogos. Tenga en cuenta lo siguiente:

  • Puede 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 los nodos Catálogos de máquinas y Aplicaciones) comparten un árbol de carpetas en el back-end. Para evitar conflictos de nombres con otros nodos al cambiar el nombre o mover carpetas, le recomendamos que asigne nombres diferentes a las carpetas de primer nivel en los distintos nodos.

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

  1. Seleccione Catálogos de máquinas en el panel izquierdo.
  2. En la jerarquía de carpetas, seleccione una carpeta y, a continuación, seleccione Crear carpeta en la barra Acción.
  3. Introduzca un nombre para la nueva carpeta y, a continuación, haga clic en Listo.

Sugerencia:

Si crea una carpeta en una ubicación no deseada, puede arrastrarla a la ubicación correcta.

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

  1. Seleccione Catálogos de máquinas en el panel izquierdo.
  2. Vea los catálogos por carpeta. También puede activar Ver todo encima de la jerarquía de carpetas para ver todos los catálogos a la vez.
  3. Haga clic con el botón derecho en un catálogo y, a continuación, seleccione Mover catálogo de máquinas.
  4. Seleccione la carpeta a la que quiere mover el catálogo y, a continuación, haga clic en Listo.

Sugerencia:

Puede arrastrar un catálogo a una carpeta.

Administrar carpetas de catálogos

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

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

Para administrar una carpeta, siga estos pasos:

  1. Seleccione Catálogos de máquinas en el panel izquierdo.

  2. En la jerarquía de carpetas, seleccione una carpeta y, a continuación, seleccione una acción en la barra de Acciones según sea necesario:

    • Para renombrar la carpeta, seleccione Renombrar carpeta.
    • Para eliminar la carpeta, seleccione Eliminar carpeta.
    • Para mover la carpeta, seleccione Mover carpeta.
  3. Siga las instrucciones en pantalla para completar los pasos restantes.

Usar PowerShell

Esta sección detalla cómo puede administrar catálogos mediante PowerShell:

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

Con los comandos de PowerShell, puede:

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

Para ejecutar los comandos de PowerShell:

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

Para obtener una lista de errores y advertencias:

Ejecute 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:

Ejecute 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. Puede obtener el EventId de un error o advertencia específico como resultado 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:

Ejecute el comando Remove-ProvOperationEvent.

  • Con el parámetro EventId: Elimina un error o advertencia específico que coincida con este ID de evento. Puede obtener el EventId de un error o advertencia específico como resultado 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 y advertencias

Para obtener más información, consulte Citrix PowerShell SDK.

Agregar descripciones a una imagen

Puede agregar descripciones informativas sobre los cambios relacionados con las actualizaciones de imágenes para los catálogos de máquinas. Utilice 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 puede mostrar información para cada imagen maestra del catálogo. Utilice 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, utilice 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, utilice 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, utilice el comando Get-ProvSchemeMasterVMImageHistory. Por ejemplo:

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

Para realizar un seguimiento del progreso de la reversión, localice 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 se puede revertir en ciertos escenarios, incluidos los siguientes. (La opción Revertir imagen maestra no está visible).

  • No tiene 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.

Restaurar disco del SO

Utilice 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úrese de que:

  • Las máquinas virtuales 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 máquinas virtuales de destino están apagadas y en modo de mantenimiento.

Siga estos pasos para restablecer el disco del sistema operativo:

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

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

    • Especifique la lista de máquinas virtuales como una lista separada por comas y realice el restablecimiento en cada máquina virtual:

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

    • Especifique la lista de máquinas virtuales como una salida del comando Get-ProvVM y realice el restablecimiento en cada máquina virtual:

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

    • Especifique una sola máquina virtual por nombre:

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

    • Cree tareas de restablecimiento separadas para cada una de las máquinas virtuales 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 máquina virtual.

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

  4. Aparece un mensaje de confirmación que enumera las máquinas virtuales que se van a restablecer junto con un mensaje de advertencia de que es una operación irrecuperable. Si no proporciona una respuesta y pulsa Intro, no se realizará ninguna acción adicional.

    Nota:

    No saque las máquinas virtuales del modo de mantenimiento ni las encienda hasta que finalice el proceso de restablecimiento.

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

    También puede omitir el mensaje de confirmación utilizando uno de los siguientes métodos:

    • Proporcione el parámetro -Force:

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

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

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

    • Antes de ejecutar Reset-ProvVMDisk, cambie $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-->
  5. Ejecute Get-ProvTask para obtener el estado de las tareas devueltas por el comando Reset-ProvVMDisk.

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

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

Nota:

Esta función es compatible con Citrix Virtual Apps and Desktops 2203 LTSR CU3 y versiones posteriores.

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

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

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

    $NewNetworkMap = @{"0"= "XDHYP:\HostingUnits\MyNetworks\Network 0.network"}
<!--NeedCopy-->
  4. Ejecute Set-ProvScheme -ProvisioningSchemeName "name" -NetworkMapping $NewNetworkMap.
  5. Ejecute (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. A continuación, puede administrar las distintas versiones del catálogo de máquinas mediante comandos de PowerShell. Puede:

  • Ver la lista de versiones de un catálogo de máquinas
  • Utilizar cualquier versión anterior para actualizar el catálogo de máquinas
  • Eliminar manualmente una versión si no la utiliza una VM 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

Ejecute 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

  • Para eliminar manualmente una versión si no la utiliza una VM de ese catálogo de máquinas:

     Remove-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 3

  • 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

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

  • Aumente el límite del número máximo de versiones que debe conservar el catálogo de máquinas.
  • Actualice algunas VM que están en versiones anteriores para que esas versiones anteriores ya no sean referenciadas por ninguna VM y puedan eliminarse.

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

Puede usar una VM, una especificación de plantilla (en el caso de Azure) o una plantilla de lanzamiento (en el caso de AWS) como entrada de perfil 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. Las nuevas VM 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 un perfil de máquina existente no se puede cambiar a un catálogo de máquinas no basado en un perfil de máquina.

Para ello:

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

  3. Ejecute 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>

    • En el caso de AWS:

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

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

Puede restablecer la información de identidad de las cuentas de equipo activas que tienen problemas relacionados con la identidad. Puede optar por 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 a los catálogos de máquinas MCS persistentes y no persistentes.

Nota:

Actualmente, la función solo es compatible con los entornos de virtualización de Azure y VMware.

Condiciones

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

  • Apague y ponga la máquina virtual en modo de mantenimiento
  • No incluya el parámetro -OS en el comando de PowerShell

Restablecer disco de identidad

Para restablecer el disco de identidad:

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

  3. Restablezca la información de identidad.

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

       Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo

      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/clave de confianza de la cuenta, y UserCertificate para reparar los atributos del certificado de usuario de las identidades de máquina unidas a Hybrid AzureAD.

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

       Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo


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

    • Para recrear completamente el disco de identidad:

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

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

    Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMName <name> -Identity -Force
  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 y 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 actualmente aplicable 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:

  • Actualice a la versión más reciente de VDA (2308 o posterior).

  • Habilite 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

Cambiar la configuración de la caché

Ejecute el comando Set-ProvScheme. Por ejemplo:

Set-ProvScheme -ProvisioningSchemeName $provScheme.ProvisioningSchemeName -WriteBackCacheDisk32 -WriteBackCacheMemorySize 128

Nota:

  • El valor de WriteBackCacheDiskSize debe ser superior a cero porque 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 que se añaden al catálogo después de realizar el cambio. Las máquinas virtuales existentes no se ven afectadas por estos cambios.

Solucionar problemas

Qué hacer a continuación

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

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