Administrar catálogos de máquinas
Nota:
Puede administrar la implementación de Citrix Virtual Apps and Desktops mediante dos consolas de administración: Web Studio (basada en la web) y Citrix Studio (basada en Windows). Este artículo se refiere únicamente a 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; también puede cambiarlo de nombre, modificar su descripción o administrar sus cuentas de equipo de Active Directory.
El mantenimiento de catálogos también puede incluir comprobar que cada máquina tenga las últimas actualizaciones del sistema operativo. Aquí se incluyen las actualizaciones de antivirus y del sistema operativo o los cambios de configuración.
- Los catálogos que contienen máquinas agrupadas aleatorias que se han creado con Machine Creation Services (MCS) pueden mantener las máquinas mediante la actualización de la imagen maestra utilizada en el catálogo y, luego, de las máquinas en sí. Este método permite actualizar de forma eficiente una gran cantidad de máquinas de usuario.
- Para catálogos que contengan máquinas estáticas asignadas permanentemente y para catálogos de máquinas de acceso con Remote PC, se administran las actualizaciones de las máquinas de los usuarios fuera de Web Studio. Puede realizar esta tarea de forma individual o colectiva mediante herramientas de distribución de software de terceros.
Para obtener información sobre la creación y la administración de conexiones para alojar hipervisores, consulte Conexiones y recursos.
Nota:
MCS no es compatible con Windows 10 IoT Core ni 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 MCS creado con instancias persistentes o dedicadas, cualquier máquina nueva creada para el catálogo utiliza la imagen actualizada. Las instancias preexistentes continúan mediante la instancia original. El proceso de actualización de una imagen se realiza de la misma manera que cuando se trata de cualquier otro tipo de catálogo. Se deben tener en cuenta las siguientes cuestiones:
- Con catálogos de discos persistentes, las máquinas preexistentes no se actualizan a la nueva imagen. Sin embargo, todas las máquinas nuevas que se agreguen al catálogo utilizan la nueva imagen.
- Para catálogos de discos no persistentes, la imagen de la máquina se actualiza la próxima vez que se restablezca la máquina.
- Con catálogos de máquinas persistentes, actualizar la imagen también implica actualizar las instancias de catálogo que la utilizan.
- En el caso de catálogos no persistentes, si quiere utilizar 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
En esta sección se detalla cómo puede administrar los catálogos con Web Studio:
- Administrar catálogos de máquinas
- Administrar catálogos de máquinas
- Usar Web Studio
- Ver detalles del catálogo
- Modificar un catálogo
- Cambiar el nombre de un catálogo
- Mover un catálogo a otra zona
- Eliminar un catálogo
- Administrar cuentas de equipo de Active Directory en un catálogo
- Actualizar un catálogo
- Cambiar el nivel funcional o deshacer el cambio
- Clonar un catálogo
- Organizar los catálogos por medio de carpetas
- Reintentar la creación de un catálogo
- Inscribir agentes VDA no aprovisionados por MCS mediante tokens (Technical Preview)
- Usar PowerShell
- Recuperar advertencias y errores asociados a un catálogo
- Habilitar una programación de reinicios únicos
- Agregar descripciones a una imagen
- Restablecer disco de SO
- Cambiar el parámetro de red de un esquema de aprovisionamiento existente
- Administrar versiones de un catálogo de máquinas
- 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
- Reparar la información de identidad de las cuentas de equipo activas
- Cambiar la configuración de la caché en un catálogo de máquinas existente
- Compatibilidad con la actualización de VDA mediante acceso a recursos compartidos de archivos locales
- Solucionar problemas
- Qué hacer a continuación
Ver detalles del catálogo
- Use la función de búsqueda para localizar un catálogo de máquinas específico. Para obtener instrucciones, consulte Buscar instancias.
- En los resultados de la búsqueda, seleccione un catálogo según sea necesario.
- Consulte la siguiente tabla para ver las descripciones de las columnas del catálogo.
- Haga clic en una ficha del panel de detalles inferior para obtener más información sobre este 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
|
Tipo de máquina
|
El tipo de sesión admitido de las máquinas del catálogo. Los posibles valores incluyen
|
Recuento de máquinas | El recuento de máquinas en el catálogo y el método de aprovisionamiento. Los métodos de aprovisionamiento posibles incluyen: Machine Creation Services (máquina de MCS), Manual y Citrix Provisioning Services. |
Recuento asignado | La cantidad de máquinas del catálogo asignadas a un grupo de entrega. |
Carpeta | La ubicación del catálogo en el á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 al final) o - si el catálogo está en el nivel raíz. |
Actualización de versión de VDA | Estado de la actualización de versión de VDA. Entre los valores posibles se incluyen: No configurado, Programado, Disponible y Actualizado. |
Estado de la imagen | El estado de actualización de la imagen del catálogo. Solo se aplica a los catálogos de máquinas no persistentes. Los valores posibles incluyen: Totalmente actualizada, Parcialmente actualizada, Actualizaciones pendientes y En preparación |
Agregar máquinas a un catálogo
Antes de comenzar:
- Compruebe que el host de virtualización contenga procesadores, memoria y capacidad de almacenamiento suficientes para dar cabida a las máquinas adicionales.
- Compruebe que tiene suficientes cuentas de equipo de Active Directory sin usar. Si utiliza cuentas existentes, tenga en cuenta que la cantidad de máquinas que puede agregar se limita a la cantidad de cuentas disponibles.
- Si usa Web Studio con el fin de crear cuentas de equipo de Active Directory para las máquinas adicionales, debe tener los permisos de administrador de dominio apropiados.
Para agregar máquinas a un catálogo:
- Inicie sesión en Web Studio.
- Seleccione Catálogos de máquinas en el panel de la izquierda.
- Seleccione un catálogo de máquinas y, a continuación, seleccione Agregar máquinas en la barra de acciones.
- Seleccione la cantidad de máquinas virtuales que se van a agregar.
- Si no hay suficientes cuentas existentes de Active Directory para la cantidad de máquinas virtuales que quiere agregar, seleccione el dominio y la ubicación donde se crearán las cuentas. Especifique un esquema de nombres de cuenta con marcas hash para indicar dónde aparecerán los números o las letras secuenciales. No use barras diagonales (/) en el nombre de una unidad organizativa. Un nombre no puede empezar con un número. Por ejemplo, un esquema de denominación PC-Ventas-## (con números del 0 al 9 seleccionados) da como resultado cuentas de equipo llamadas PC-Ventas-01, PC-Ventas-02, PC-Ventas-03, etc.
- Si usa cuentas existentes de Active Directory, vaya a esas cuentas o haga clic en Importar y especifique un archivo CSV que contenga los nombres de cuenta. Compruebe que hay cuentas suficientes para las máquinas que está agregando. Web Studio administra estas cuentas. Por eso, permita que Web Studio restablezca las contraseñas de todas las cuentas, o bien, especifique la contraseña de la cuenta (que debe ser la misma para todas las cuentas).
Las máquinas se crean en un proceso en segundo plano, que puede tardar mucho tiempo si se crea una gran cantidad de máquinas. La creación de máquinas continúa, aunque se cierre Web Studio.
Eliminar máquinas de un catálogo
Después de eliminar una máquina de un catálogo, los usuarios ya no podrán acceder a ella. Por eso, antes de eliminar una máquina, compruebe que:
- Existe una copia de seguridad de los datos del usuario, si fueran útiles.
- Todos los usuarios han cerrado la sesión. La activación del modo de mantenimiento impide nuevas conexiones a una máquina.
- Las máquinas se apagan.
Para eliminar máquinas de un catálogo:
- Inicie sesión en Web Studio.
- Seleccione Catálogos de máquinas en el panel de la izquierda.
- Seleccione un catálogo y, a continuación, seleccione Ver máquinas en la barra de acciones.
- Seleccione una o varias máquinas y, a continuación, seleccione Eliminar en la barra de acciones.
Elija si se eliminarán las máquinas que se van a quitar. Si opta por eliminar las máquinas, indique si las cuentas de Active Directory de esas máquinas deberán conservarse, inhabilitarse o eliminarse.
Modificar un catálogo
- En la página Descripción, cambie la descripción del catálogo.
- Seleccione Catálogos de máquinas en el panel de la izquierda.
- Seleccione un catálogo y, a continuación, seleccione Modificar catálogo de máquinas en la barra de acciones.
- En la página Ámbitos, cambie los ámbitos.
-
En la página de tarjetas NIC, haga lo siguiente:
- Para cambiar la asignación de subredes de una NIC, seleccione una red en el campo Red asociada.
- Para agregar una asignación de subred, seleccione Agregar NIC, seleccione una red en el campo Red asociada y haga clic en Guardar.
Solo las subredes presentes en el host asociado al catálogo aparecen en el campo Red asociada.
Solo se puede agregar NIC a los catálogos de máquinas de Azure sin perfiles de máquina.
Nota:
- En el caso de los catálogos de máquinas de AWS, no se puede asignar la misma subred a más de una NIC.
- En el caso de los catálogos de máquinas con perfiles de máquina, la cantidad de NIC del catálogo debe ser igual a la cantidad de NIC del perfil de la 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 Nutanix.
-
Es posible que aparezcan otras páginas, según el tipo de catálogo.
Para los catálogos creados con una imagen de Azure Resource Manager, se ven las siguientes páginas. Tenga en cuenta que los cambios que haga se aplican solo a las máquinas que agregue al catálogo más adelante. Las máquinas existentes permanecen sin cambios.
-
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áquinas utilizados en otros catálogos de máquinas para filtrar la lista de tamaños de máquinas.
-
En la página Perfil de máquina, elija si quiere usar o cambiar un perfil de máquina.
-
(Solo visible cuando el catálogo está configurado con un host de grupo dedicado) En la página Grupo de hosts dedicado, elija si quiere cambiar un grupo de hosts.
-
En la página Tipos de almacenamiento y licencias, elija si quiere cambiar el tipo de almacenamiento, el tipo de licencia y los parámetros de Azure Computer Gallery (disponibles solo cuando se usa Colocar la imagen preparada en Azure Gallery).
Nota:
Si el parámetro recién seleccionado no es compatible con el tamaño actual de la máquina, aparece un cuadro de diálogo de advertencia que le informa de que, al cambiar el parámetro, se restablecerá el parámetro de tamaño de la máquina. Si decide continuar, aparecerá un punto rojo junto al menú Máquinas virtuales que le pedirá que seleccione un nuevo tamaño de máquina.
- En la página Tipo de licencia, elija si quiere cambiar la configuración de la licencia de Windows o de Linux.
Para los catálogos de acceso con Remote PC, se muestran las siguientes páginas:
- En la página Administración de energía, cambie los parámetros 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 unidades organizativas de Active Directory.
-
- Haga clic en Aplicar para aplicar los cambios realizados y haga clic en Guardar para salir.
Cambiar el nombre de un catálogo
- Inicie sesión en Web Studio.
- Seleccione Catálogos de máquinas en el panel de la izquierda.
- Seleccione un catálogo y, a continuación, seleccione Cambiar nombre de catálogo de máquinas en la barra de acciones.
- Introduzca el nuevo nombre.
Mover un catálogo a otra zona
Si la implementación tiene más de una zona, puede mover un catálogo de una zona a otra.
Mover un catálogo a otra zona que no sea el hipervisor que contiene las máquinas virtuales de ese catálogo puede afectar al rendimiento.
- Inicie sesión en Web Studio.
- Seleccione Catálogos de máquinas en el panel de la izquierda.
- Seleccione un catálogo y, a continuación, seleccione Mover en la barra de acciones.
- Seleccione la zona a la que quiere mover el catálogo.
Eliminar un 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 se activa para todas las máquinas del catálogo, de modo que no se pueden establecer conexiones nuevas.
- Todas las máquinas del catálogo se apagan.
- El catálogo no está asociado a ningún grupo de entrega. Es decir, que el grupo de entrega no contiene máquinas procedentes del catálogo.
Para eliminar un catálogo:
- Inicie sesión en Web Studio.
- Seleccione Catálogos de máquinas en el panel de la izquierda.
- Seleccione un catálogo y, a continuación, seleccione Eliminar catálogo de máquinas en la barra de acciones.
- Indique si las máquinas del catálogo deberán eliminarse. Si opta por eliminar máquinas, indique si las cuentas de equipo de Active Directory de esas máquinas deberán conservarse, inhabilitarse o eliminarse.
Administrar cuentas de equipo de Active Directory en un catálogo
Para administrar cuentas de Active Directory en un catálogo de máquinas, puede:
- Liberar cuentas de máquina sin utilizar eliminando cuentas de equipo de Active Directory que haya en catálogos de máquinas de SO de sesión única y SO multisesión. Estas cuentas se pueden usar para otras máquinas.
- Agregar cuentas de modo que, cuando se agreguen más máquinas al catálogo, las cuentas de equipo ya estén listas. No use barras diagonales (/) en el nombre de una unidad organizativa.
Para administrar cuentas de Active Directory:
- Inicie sesión en Web Studio.
- Seleccione Catálogos de máquinas en el panel de la izquierda.
- Seleccione un catálogo y, a continuación, seleccione Administrar cuentas de AD en la barra de acciones.
-
Elija si quiere agregar o eliminar las cuentas de equipo. Si agrega cuentas, deberá especificar qué hacer con las contraseñas de cuenta: restablecerlas todas o escribir una contraseña para todas ellas.
Puede restablecer contraseñas si no conoce las contraseñas de cuenta actuales. Debe tener permisos específicos para realizar el restablecimiento de contraseñas. Al introducir una contraseña, cambiará la contraseña en las cuentas a medida que se importan. Al eliminar una cuenta, deberá elegir si la cuenta de Active Directory debe mantenerse, inhabilitarse o eliminarse.
Indique si las cuentas de Active Directory se deberán conservar, inhabilitar o eliminar cuando quite máquinas de un catálogo o elimine un catálogo.
Actualizar un catálogo
Se recomienda guardar copias o instantáneas de las imágenes maestras antes de actualizar las máquinas de un catálogo. La base de datos conserva 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 utilizar la versión anterior de la imagen maestra. Realice esta tarea si los usuarios tienen problemas con las actualizaciones implementadas en sus escritorios. De esta forma, se minimiza el tiempo de inactividad de los usuarios. No elimine, mueva o cambie el nombre de las imágenes maestras. No se puede revertir un catálogo para utilizarlas.
Una vez actualizada la máquina, se reinicia automáticamente.
Actualizar o crear una imagen maestra
Antes de actualizar un catálogo de máquinas, actualice la imagen maestra existente o cree una en el hipervisor de host.
- En el hipervisor, tome una instantánea de la VM actual y dele un nombre significativo. Esta instantánea se puede usar para revertir (deshacer) los cambios en las máquinas del catálogo, si fuera necesario.
- Si es necesario, encienda la máquina virtual de la imagen maestra e inicie sesión.
- Instale las actualizaciones o realice los cambios necesarios en la imagen maestra.
- Apague la máquina virtual.
- Cree una instantánea de la máquina virtual. Asígnele un nombre significativo fácilmente reconocible cuando el catálogo se actualice en Web Studio. Aunque Web Studio puede crear una instantánea, Citrix recomienda crearla desde la consola de administración del hipervisor. A continuación, seleccione esa instantánea en Web Studio. Este proceso le permite asignar un nombre y una descripción significativos para la instantánea, en lugar de recibir un nombre generado automáticamente. Para imágenes maestras de GPU, puede cambiar la imagen maestra solo a través de la consola XenCenter de XenServer.
Cambiar la imagen maestra
Para preparar y aplicar la actualización a todas las máquinas de un catálogo:
- Inicie sesión en Web Studio.
- Seleccione Catálogos de máquinas en el panel de la izquierda.
- Seleccione un catálogo y, a continuación, seleccione Cambiar imagen maestra en la barra de acciones.
- En la página Imagen, seleccione el host y la imagen que quiere implantar.
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 con una nota relacionada, independientemente de si agrega o no una nota. 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 plantilla en el panel inferior y, a continuación, haga clic en Ver historial de notas.
- En la página Estrategia de implantación, elija cuándo se actualizan las máquinas del catálogo con la nueva imagen maestra (en el siguiente apagado o inmediatamente).
Nota:
La página Estrategia de implementación no está disponible para las máquinas virtuales persistentes porque la implementación solo se aplica a las máquinas virtuales no persistentes.
- En la página Resumen, revise la información y haga clic en Finalizar. Cada máquina se reiniciará automáticamente después de actualizarse.
Para hacer un seguimiento del progreso de la actualización, busque el catálogo en Catálogos de máquinas para ver la barra de progreso integrada y el gráfico de progreso detallado.
Al actualizar un catálogo directamente mediante el SDK de PowerShell, en lugar de Web Studio, especifique una plantilla de hipervisor (VMTemplates). Esto sirve de alternativa a una imagen o a una instantánea de una imagen.
Estrategia de implantación:
La actualización de las imágenes la próxima vez que se apague la máquina afectará inmediatamente a las máquinas que no estén en uso en ese momento, 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. Se deben tener en cuenta las siguientes cuestiones:
- Las sesiones nuevas no se pueden iniciar hasta que la actualización se haya completado en las máquinas correspondientes.
- Las máquinas con SO de sesión única se actualizan inmediatamente cuando no se están usando o cuando los usuarios no han iniciado sesión en ellas.
- Para un SO multisesión con máquinas secundarias, los reinicios no se producen automáticamente. Deben apagarse y reiniciarse manualmente.
Sugerencia:
Limite la cantidad 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 en función del hipervisor.
Si quiere habilitar la programación de reinicios únicos mediante PowerShell, consulte Habilitar la programación de reinicios únicos.
Revertir la imagen maestra
Después de aplicar una imagen maestra nueva o actualizada, puede revertirla. Este proceso puede ser necesario si surgen problemas con las máquinas recién actualizadas. Cuando revierte una actualización, las máquinas del catálogo vuelven a la última imagen funcional. Las nuevas funciones que requieran la nueva imagen ya no están disponibles. Al igual que en la implantación, la reversión de una máquina implica un reinicio.
- Inicie sesión en Web Studio.
- Seleccione Catálogos de máquinas en el panel de la izquierda.
- Seleccione el catálogo y, a continuación, seleccione Revertir imagen maestra en la barra de acciones.
- Puede especificar cuándo se aplicará la versión anterior de la imagen maestra a las máquinas, de la manera que se describe en la sección anterior, en la operación de implantación.
La reversión solo se aplica a 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 ven obligadas a cerrar la sesión.
Para hacer un seguimiento del progreso de la reversión, busque el catálogo en Catálogos de máquinas para ver la barra de progreso integrada y el gráfico de progreso detallado.
Cambiar el nivel funcional o deshacer el cambio
Cambie el nivel funcional del catálogo de máquinas después de actualizar la versión de 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 permitir el acceso a todas las funciones nuevas.
Antes de cambiar el nivel funcional de un catálogo de máquinas:
- Inicie las máquinas actualizadas para que se registren con el Controller. Este proceso permite a Web Studio determinar si las máquinas del catálogo necesitan actualización.
Para cambiar el nivel funcional de un catálogo:
- Inicie sesión en Web Studio.
- Seleccione Catálogos de máquinas en el panel de la izquierda.
- Seleccione el catálogo. En la ficha Detalles del panel inferior, se muestra la información de versión.
- Seleccione Cambiar nivel funcional. Si Web Studio detecta que el catálogo necesita actualización, se le informará mediante un mensaje. Siga las indicaciones. Si una o varias máquinas no se pueden actualizar, aparecerá un mensaje en el que se le explicará el motivo. Para garantizar que todas las máquinas funcionen correctamente, Citrix recomienda resolver los problemas de la máquina antes de hacer clic en Cambiar.
Después de completar el cambio del catálogo, puede revertir las máquinas a sus versiones anteriores de VDA. Para ello, seleccione el catálogo y, a continuación, seleccione Deshacer cambio de nivel funcional en la barra de acciones.
Clonar un catálogo
Antes de clonar un catálogo, tenga en cuenta esto:
- No se pueden cambiar los parámetros asociados a la administración de máquinas y al sistema operativo. El catálogo clonado hereda esos parámetros del original.
- La clonación de un catálogo puede tardar en completarse. Si es necesario, selecciona Ocultar progreso para realizar la clonación en segundo plano.
- El catálogo clonado hereda el nombre del original y tiene el sufijo
Copy
. Puede cambiarle el nombre. Consulte Cambiar el nombre de un catálogo. - Una vez finalizada la clonación, asegúrese de asignar el catálogo clonado a un grupo de entrega.
- Inicie sesión en Web Studio y, a continuación, seleccione Catálogos de máquinas en el panel de la izquierda.
- Seleccione un catálogo y, a continuación, seleccione Clonar en la barra de acciones.
- En la ventana Clonar catálogo de máquinas seleccionado, consulte los parámetros del catálogo clonado y configúrelos según corresponda. Seleccione Siguiente para pasar a la página siguiente.
- En la página Resumen, verá un resumen de los parámetros. Seleccione Finalizar para iniciar la clonación.
- Si es necesario, selecciona Ocultar progreso para realizar la clonación en segundo plano.
Organizar los catálogos por medio de carpetas
Puede crear carpetas para organizar los catálogos y acceder a ellos fácilmente. Por ejemplo, puede organizar los catálogos por tipo de imagen o por estructura organizativa.
Crear una carpeta de catálogo
Antes de empezar, planifique cómo organizar sus catálogos. Se deben tener en cuenta las siguientes cuestiones:
- Puede anidar carpetas con 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 de las carpetas o moverlas, le recomendamos que asigne nombres diferentes a las carpetas de primer nivel de los distintos nodos.
Para crear una carpeta de catálogo, siga estos pasos:
- Seleccione Catálogos de máquinas en el panel de la izquierda.
- En la jerarquía de carpetas, seleccione una carpeta y, a continuación, seleccione Crear carpeta en la barra de acciones.
- 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.
Mover un catálogo
Puede mover un catálogo entre carpetas. Estos son los pasos detallados:
- Seleccione Catálogos de máquinas en el panel de la izquierda.
- Ver los catálogos por carpeta. También puede activar Ver todo por encima de la jerarquía de carpetas para ver todos los catálogos a la vez.
- Haga clic con el botón secundario en un catálogo y, a continuación, seleccione Mover catálogo de máquinas.
- 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, cambiar el nombre y mover las 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:
- Seleccione Catálogos de máquinas en el panel de la izquierda.
-
En la jerarquía de carpetas, seleccione una carpeta y, a continuación, seleccione una acción en la barra de acciones:
- Para cambiar el nombre de la carpeta, seleccione Cambiar nombre de carpeta.
- Para eliminar la carpeta, seleccione Eliminar carpeta.
- Para mover la carpeta, seleccione Mover carpeta.
- Siga las instrucciones que aparecen en pantalla para completar los pasos restantes.
Reintentar la creación de un catálogo
Nota:
Esta función solo se aplica a catálogos de MCS.
Los catálogos con errores se marcan con un icono de error. Para ver los detalles, vaya a la ficha Solucionar problemas de cada catálogo. Antes de reintentar la creación de catálogos, tenga en cuenta estas consideraciones:
- Compruebe primero la información sobre la solución de problemas y resuelva los problemas. La información describe los problemas encontrados y proporciona recomendaciones para resolverlos.
- No se pueden cambiar los parámetros asociados a la administración de máquinas y al sistema operativo. El catálogo hereda esos parámetros del original.
- La creación puede tardar un tiempo en completarse. Si es necesario, seleccione Ocultar progreso para realizar la creación en segundo plano.
Para intentar de nuevo la creación de un catálogo, haga lo siguiente:
- En Web Studio, seleccione Catálogos de máquinas en el panel de la izquierda.
- Seleccione el catálogo y, a continuación, vaya a la ficha Solucionar problemas.
- Haga clic en el hipervínculo Reintentar para intentar crear el catálogo de nuevo.
- En el asistente que aparece, cambie los parámetros donde sea necesario. Si no necesita realizar ningún cambio, puede ir directamente a la página Resumen.
- Cuando termine, seleccione Finalizar para iniciar la creación.
Inscribir agentes VDA no aprovisionados por MCS mediante tokens (Technical Preview)
Ahora puede generar y administrar tokens de inscripción para los 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 agentes VDA no unidos a un dominio con Citrix Virtual Apps and Desktops.
Antes de comenzar
- Configure el sitio. Para obtener más información, consulte Crear un sitio.
- Instale los certificados TLS en los Delivery Controllers. Para obtener más información, consulte Instalar certificados de servidor TLS en los Controllers.
- Instale la CA raíz y la CA intermedia en el VDA para confiar en el Delivery Controller.
-
Habilite la conexión WebSocket en el Delivery Controller. Ejecute el siguiente comando en cada Delivery Controller presente en su sitio:
New-ItemProperty "HKLM:\SOFTWARE\Citrix\DesktopServer\WorkerProxy" -Name "WebSocket_Enabled" -PropertyType "DWord" -Value 1 -Force <!--NeedCopy-->
Nota:
Asegúrese de reiniciar los Delivery Controllers después de habilitar el WebSocket.
Generar tokens de inscripción
Cuando decida habilitar la inscripción basada en tokens para máquinas aprovisionadas que no sean de Citrix, primero debe generar tokens por catálogo de máquinas y después compartirlos con los administradores de instalación de VDA.
Un token de inscripción incluye:
- Rango de registro: de 1 a 100 máquinas VDA
- Periodo de validez: hasta 14 días
Para generar un token para un catálogo mediante Web Studio, siga estos pasos:
- En Web Studio > Catálogos de máquinas, busque un catálogo que no esté aprovisionado por MCS y que muestre Método de aprovisionamiento: Manual en la columna Recuento de máquinas.
- Haga clic con el botón secundario en el catálogo y después seleccione Administrar tokens de inscripción.
- En la página Generar token de inscripción que se muestra, introduzca la siguiente información sobre el token:
- Escriba un nombre para el token.
- Introduzca su período de validez. El período no debe ser superior a 14 días. El token solo es válido durante el período especificado.
- (Opcional) Seleccione una conexión de host para administrar la energía de los VDA inscritos con el token. Las opciones incluyen todas las conexiones de host de la zona de este catálogo.
- Introduzca los límites de uso del token (entre 1 y 100).
- Haga clic en Generar.
-
En la ventana Token generado correctamente que se muestra, cópielo y guárdelo en un lugar seguro, o haga clic en Descargar para descargarlo en la carpeta Descargas.
Se muestra un registro de token en la lista de tokens.
-
Comparta el token con los administradores de instalación del VDA.
Para obtener más información sobre cómo instalar un VDA y un token en las máquinas, consulte Instalar agentes VDA.
Administrar tokens
Tiene dos opciones para revocar un token y hacer que no esté 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 le ayuda a convertir una conexión en una conexión de 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.
Siga las instrucciones para ejecutar la herramienta de inscripción:
- Inicie sesión en el VDA.
- Localice la herramienta
EnrollMachine.exe
, enC:\Program Files\Citrix\Virtual Desktop Agent\Web Socket Vda Enrollment Tool
. - Ejecute la herramienta con los parámetros de entrada apropiados. Por ejemplo,
EnrollMachine.exe -websocket_token_string:xxxxxxxxx
En la siguiente tabla se describen los parámetros de entrada de la herramienta de inscripción:
Nombre del parámetro | Si son necesarias | 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 desde el parámetro de la 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 |
Una vez que se haya inscrito correctamente, recibirá un mensaje de confirmación en la herramienta y en los registros. Asegúrese 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, puede encontrar los registros de la herramienta de inscripción en:
C:\ProgramData\Citrix\EnrollMachine\EnrollMachine.txt
Si ha especificado una ruta diferente para los registros, puede usar log:[log-file-path]
para recuperarlos.
En la siguiente tabla se enumeran los códigos devueltos por la herramienta de inscripción:
Código | Cadena | Descripción |
---|---|---|
0 | Success | Un VDA se agregó correctamente al catálogo de máquinas. |
-1 | InvalidArgument | El parámetro de entrada del token de inscripción no es válido. |
-2 | BrokerAgentNotFound | No se encuentra el servicio de agente intermediario. |
-3 | TokenInvalid | El token introducido no es válido. |
-4 | TokenMissingRequiredClaims | Faltan las notificaciones necesarias para el token, por ejemplo, CustomerId o los URI de inscripción. |
-5 | InternalError | Se ha producido un error general. |
-6 | TimedOut | Se ha agotado el tiempo de espera de la tarea. |
-7 | FailedToDetermineMachineADJoinedStatus | El servicio que devuelve el estado de unión al AD de la máquina falló. |
-8 | ADMachineFailedToFindSid | El servicio que devuelve el Sid de la máquina de AD falló. |
-9 | EnrollRequestFailed | La solicitud falló debido a un error de HTTP. |
-10 | EnrollResponseMissingRequiredFields | A la respuesta de la herramienta de inscripción le falta el parámetro VirtualSiteId . |
-11 | InsufficientPermission | No tiene los permisos necesarios para ejecutar la tarea. |
-12 | FailedToDetermineMachineAadJoinedStatus | El servicio que comprueba el estado de unión al AD de la máquina devuelve 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 los Delivery Controller. |
-18 | Se alcanzó el recuento máximo de token fallidos | Se alcanzó el recuento máximo de token fallidos. |
Usar PowerShell
En esta sección se detalla cómo puede administrar catálogos con PowerShell:
- Recuperar advertencias y errores asociados a un catálogo
- Habilitar una programación de reinicios únicos
- Agregar descripciones a una imagen
- Restablecer disco de SO
- Cambiar el parámetro de red de un esquema de aprovisionamiento existente
- Administrar versiones de un catálogo de máquinas
- 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
- Reparar la información de identidad de las cuentas de equipo activas
- Cambiar la configuración de la caché en un catálogo de máquinas existente
- Compatibilidad con la actualización de VDA mediante acceso a recursos compartidos de archivos locales
Recuperar advertencias y errores asociados a un catálogo
Puede obtener advertencias y errores históricos para comprender los problemas de su catálogo de máquinas de MCS y corregirlos.
Con los comandos de PowerShell, puede:
- Obtener una lista de errores o advertencias
- Cambiar el estado de una advertencia de New a Acknowledged
- Eliminar los errores o las advertencias
Para ejecutar los comandos de PowerShell:
- Abra una ventana de PowerShell.
- 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 todas las advertencias.
- Con los parámetros
LinkedObjectType
yLinkedObjectUid
: Obtiene todos los errores y advertencias asociados a un esquema de aprovisionamiento específico. - Con el parámetro
EventId
: Obtiene errores o advertencias específicos que coinciden 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 New a Acknowledged:
Ejecute el comando Confirm-ProvOperationEvent
.
- Con el parámetro
EventId
: Configura el estado de errores o advertencias específicos que coinciden con este ID de evento. Puede obtener elEventId
de un error o advertencia específico como resultado del comandoGet-ProvOperationEvent
- Con los parámetros
LinkedObjectType
yLinkedObjectUid
: Configura el estado de todos los errores y advertencias asociados a un esquema de aprovisionamiento específico. - Con el parámetro
All
: Configura el estado de todos los errores y advertencias como Acknowledged.
Para eliminar los errores o advertencias:
Ejecute el comando Remove-ProvOperationEvent
.
- Con el parámetro
EventId
: Quita errores o advertencias específicos que coinciden con este ID de evento Puede obtener elEventId
de un error o advertencia específico como resultado del comandoGet-ProvOperationEvent
- Con los parámetros
LinkedObjectType
yLinkedObjectUid
: Quita todos los errores y advertencias asociados a un esquema de aprovisionamiento específico. - Con el parámetro
All
: Quita todas las advertencias.
Para obtener más información, consulte SDK de PowerShell de Citrix.
Eliminar máquinas sin acceder al hipervisor
Al eliminar una máquina virtual o un esquema de aprovisionamiento, MCS necesita quitar etiquetas de la máquina virtual y, a veces, también del disco base, para que MCS deje de rastrear o identificar los recursos incluidos en las opciones de eliminación. Sin embargo, algunos de estos recursos solo son accesibles a través del hipervisor. Utilice la opción PurgeDBOnly
de PowerShell Remove-ProvVM
para eliminar de la base de datos objetos de recursos de VM, como la máquina virtual, el disco base o la imagen en ACG incluso cuando no se pueda acceder al hipervisor.
Esta opción está habilitada en:
- Todos los hipervisores compatibles
- Máquinas virtuales persistentes y no persistentes
Limitaciones
No puede 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
, es posible que la operación de eliminación falle en estos casos:
- La conexión de host está en modo de mantenimiento
- Credenciales no válidas
- Fallo de autenticación
- Operación no autorizada
- No se puede contactar con el hipervisor
Nota:
Remove-provVM -ForgetVM se dirige solamente a máquinas virtuales persistentes. Si una de las máquinas virtuales de la lista no es persistente, se produce un error en la operación.
Cuando la operación falla porque no se puede contactar con el hipervisor, aparece este mensaje:
Try to use -PurgeDBOnly option to clean DDC database.
Utilice la opción -PurgeDBOnly
del comando Remove-ProvVM
de PowerShell para eliminar de la base de datos de MCS referencias de máquinas virtuales. Por ejemplo,
Remove-ProvVM -ProvisioningSchemeName SCVMM-MC -VMName SCVMM01 -PurgeDBOnly
Habilitar una programación de reinicios únicos
Si quiere habilitar la programación de reinicio único con PowerShell, use estos comandos BrokerCatalogRebootSchedule
de PowerShell para crear, modificar y eliminar una programación de reinicio:
- Get-BrokerCatalogRebootSchedule
- New-BrokerCatalogRebootSchedule
- Set-BrokerCatalogRebootSchedule
- Remove-BrokerCatalogRebootSchedule
- Rename-BrokerCatalogRebootSchedule
Por ejemplo,
-
Para crear una programación de reinicio de las máquinas virtuales del catálogo denominado Cajeros que comience el 3 de febrero de 2022, entre las 2:00 y las 4:00.
C:\PS> New-BrokerCatalogRebootSchedule -Name BankTellers -CatalogName BankTellers -StartDate "2022-02-03" -StartTime "02:00" -Enabled $true -RebootDuration 120 <!--NeedCopy-->
-
Para crear una programación de reinicio de las máquinas virtuales del catálogo con el UID 17 que comience el 3 de febrero de 2022, entre la 1:00 y las 5:00. 10 minutos antes del reinicio, cada máquina virtual está configurada para mostrar un cuadro de mensaje con el título ADVERTENCIA: Reinicio pendiente y el mensaje Guarde su trabajo en cada sesión de usuario.
C:\PS> New-BrokerCatalogRebootSchedule -Name 'Update reboot' -CatalogUid 17 -StartDate "2022-02-03" -StartTime "01:00" -Enabled $true -RebootDuration 240 -WarningTitle "WARNING: Reboot pending" -WarningMessage "Save your work" -WarningDuration 10 <!--NeedCopy-->
-
Para cambiar el nombre de la programación de reinicio del catálogo denominado Nombre antiguo a Nombre nuevo.
C:\PS> Rename-BrokerCatalogRebootSchedule -Name "Old Name" -NewName "New Name" <!--NeedCopy-->
-
Para mostrar todas las programaciones de reinicio del catálogo con el UID 1 y, a continuación, cambiar el nombre de la programación de reinicio del catálogo con el UID 1 a Nuevo nombre.
C:\PS> Get-BrokerCatalogRebootSchedule -Uid 1 | Rename-BrokerCatalogRebootSchedule -NewName "New Name" -PassThru <!--NeedCopy-->
-
Para configurar la programación de reinicios del catálogo denominado Contabilidad, se mostrará un mensaje con el título ADVERTENCIA: Reinicio pendiente y el mensaje Guarde su trabajo 10 minutos antes del reinicio de cada máquina virtual. El mensaje aparece en todas las sesiones de usuario de esa máquina virtual.
``` C:\PS> Set-BrokerCatalogRebootSchedule -Name Accounting -WarningMessage “Guarde su trabajo” -WarningDuration 10 -WarningTitle “ADVERTENCIA: Reinicio pendiente”
-
Para mostrar todas las programaciones de reinicio que están inhabilitadas y, a continuación, habilitar todas las programaciones de reinicio inhabilitadas.
C:\PS> Get-BrokerCatalogRebootSchedule -Enabled $false | Set-BrokerCatalogRebootSchedule -Enabled $true <!--NeedCopy-->
-
Para configurar la programación de reinicio del catálogo con UID 17, muestre el mensaje Reiniciando en %m% min 15, 10 y 5 minutos antes del reinicio de cada máquina virtual.
C:\PS> Set-BrokerCatalogRebootSchedule 17 -WarningMessage "Rebooting in %m% minutes." -WarningDuration 15 -WarningRepeatInterval 5 <!--NeedCopy-->
-
Para configurar la zona horaria del catálogo denominado MiCatálogo.
C:\PS> Set-BrokerCatalog -Name "MyCatalog" -TimeZone <TimeZone> <!--NeedCopy-->
Agregar descripciones a una imagen
Puede agregar descripciones informativas acerca de los cambios relacionados con las actualizaciones de imágenes de 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 de un catálogo. También puede mostrar información de 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 comandoNewProvScheme
. 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 comandoPublish-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 hacer un seguimiento del progreso de la reversión, busque el catálogo en Catálogos de máquinas para ver la barra de progreso integrada y el gráfico de progreso detallado.
La reversión no es posible en ciertos casos, como estos (la opción Revertir imagen maestra no se ve).
- No tiene permiso para revertir.
- El catálogo no se creó con MCS.
- El catálogo se creó con una imagen del disco del SO.
- La instantánea utilizada para crear el catálogo está dañada.
- Los cambios de los usuarios en las máquinas del catálogo no se conservan.
- Hay máquinas del catálogo que se están ejecutando.
Restablecer disco de SO
Use el comando Reset-ProvVMDisk
de PowerShell para restablecer el disco del sistema operativo de una máquina virtual persistente en un catálogo de máquinas creado con MCS. Actualmente, esta función se aplica a AWS, Azure, XenServer y Google Cloud. Entornos de virtualización de 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 de 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 las 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:
- Abra una ventana de PowerShell.
- Ejecute asnp citrix* para cargar los módulos de PowerShell específicos de Citrix.
-
Ejecute el comando
Reset-ProvVMDisk
de PowerShell de cualquiera de las siguientes maneras:-
Especifique la lista de máquinas virtuales en forma de lista separada por comas y efectúe el restablecimiento en cada máquina virtual:
Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName ("abc","def") -OS <!--NeedCopy-->
-
Especifique la lista de máquinas virtuales como resultado del comando
Get-ProvVM
y efectúe 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 independientes para cada una de las máquinas virtuales que devuelva el comando
Get-ProvVM
. Este método es menos eficiente, ya que cada tarea realizará las mismas comprobaciones redundantes, como la comprobación de la capacidad del hipervisor o la comprobación de la conexión para cada máquina virtual.Get-ProvVM -ProvisioningSchemeName "xxx" | Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -OS <!--NeedCopy-->
-
-
Aparecerá un mensaje de confirmación con una lista de las máquinas virtuales que se restablecerán, junto con un mensaje de advertencia que indica que se trata de una operación irrecuperable. Si no proporciona una respuesta y pulsa Intro, no tendrá lugar ninguna otra acción.
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
-WhatIf
de PowerShell para imprimir la acción que tendría lugar y salir sin realizar dicha acción.También puede omitir el mensaje de confirmación mediante uno de los siguientes métodos:
-
Indique el parámetro
-Force
:Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Force <!--NeedCopy-->
-
Indique 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-->
-
- Ejecute
Get-ProvTask
para obtener el estado de las tareas devueltas por el comandoReset-ProvVMDisk
.
Cambiar el parámetro de red de un esquema de aprovisionamiento existente
Puede cambiar el parámetro 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
del comando Set-ProvScheme
para cambiar el parámetro de la red.
Nota:
Esta función se admite en Citrix Virtual Apps and Desktops 2203 LTSR CU3 y versiones posteriores.
Para cambiar el parámetro de red de un esquema de aprovisionamiento existente, haga lo siguiente:
- En la ventana de PowerShell, ejecute el comando
asnp citrix*
para cargar los módulos de PowerShell. - Ejecute
(Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps
para ir a la ruta de red que quiere cambiar. -
Asigne una variable al nuevo parámetro de red. Por ejemplo:
$NewNetworkMap = @{"0"= "XDHYP:\HostingUnits\MyNetworks\Network 0.network"} <!--NeedCopy-->
- Ejecute
Set-ProvScheme -ProvisioningSchemeName "name" -NetworkMapping $NewNetworkMap
. - Ejecute
(Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps
para verificar el nuevo parámetro 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 de 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 los comandos de PowerShell. Puede hacer lo siguiente:
- Consulte la lista de versiones de un catálogo de máquinas
- Use 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
Ejecute los siguientes comandos (se indican 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 concreta 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 cambiar 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 en 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 puede crear una nueva versión si alguna de las máquinas virtuales del catálogo de máquinas está usando versiones anteriores. En ese caso, realice 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 máquinas virtuales que están en versiones anteriores para que ninguna máquina virtual deje de hacer referencia a esas versiones anteriores y pueda eliminarlas.
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 inicio (en el caso de AWS) como entrada del 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 máquinas virtuales nuevas agregadas al catálogo toman los valores de las propiedades del perfil de la máquina a menos que se sobrescriban con una propiedad personalizada explícita.
Nota:
Un catálogo de máquinas existente basado en perfiles de máquina no se puede cambiar a un catálogo de máquinas no basado en perfiles de máquina.
Para hacerlo:
- Cree un catálogo de máquinas persistente o no persistente con máquinas virtuales y sin un perfil de máquina.
- Abra la ventana de PowerShell.
-
Ejecute el comando
Set-ProvScheme
para aplicar los valores de las propiedades del perfil de la máquina a las nuevas máquinas virtuales agregadas al catálogo de máquinas. Por ejemplo:-
En el caso de Azure:
Set-ProvScheme = Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile XDHyp:\HostingUnits<HostingUnitName>\machineprofile.folder<ResourceGroupName><TemplateSpecName><VersionName> <!--NeedCopy-->
-
En el caso de AWS:
Set-ProvScheme = Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile "XDHyp:\HostingUnits<hosting-unit><launch-template>.launchtemplate<launch-template-version>.launchtemplateversion" <!--NeedCopy-->
-
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 tengan problemas relacionados con la identidad. Puede elegir restablecer solo la contraseña de la máquina y las claves de confianza, o bien restablecer toda la configuración del disco de identidad. Esta implementación se aplica tanto a catálogos de máquinas de MCS persistentes como no persistentes.
Nota:
En la actualidad, la función solo es compatible con los entornos de virtualización de AWS, GCP, Azure, XenServer y VMware.
Condiciones
Para restablecer correctamente el disco de identidad:
- Apague y ponga la VM en modo de mantenimiento
- No incluya el parámetro -OS en el comando de PowerShell
Restablecer disco de identidad
Para restablecer un disco de identidad:
- Abra la ventana de PowerShell.
- Ejecute
asnp citrix*
para cargar los módulos de PowerShell específicos de Citrix. -
Restablezca la información de identidad.
-
Para restablecer únicamente la contraseña de la máquina y las claves de confianza, ejecute los siguientes comandos en este orden:
Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo <!--NeedCopy-->
La descripción de los parámetros usados en el comando es la siguiente:
-
IdentityAccountName
: El nombre de la cuenta de identidad que se debe reparar. -
PrivilegedUserName
: La cuenta de usuario que tiene permiso de escritura en el proveedor de identidades (AD o AzureAD). -
PrivilegedUserPassword
: Contraseña para PrivilegedUserName. -
Target
: Objetivo de la acción de reparación. Puede ser IdentityInfo para reparar la contraseña o la clave de confianza de la cuenta y UserCertificate para reparar los atributos del certificado de usuario de las identidades de máquinas híbridas unidas a AzureAD.
Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMname <name> -Identity -ResetIdentityInfo <!--NeedCopy-->
El parámetro
ResetIdentityInfo
restablece lo siguiente:- Contraseña y claves de confianza: Si la VM está unida a un dominio de AD (solo para documentos de DaaS)
- Solo claves de confianza: Si la máquina virtual no está unida a un dominio de AD (solo para documentos de DaaS)
- Solo contraseña: si la máquina virtual está unida a un dominio de AD (solo para documentos locales de CVAD)
-
-
Para restablecer toda la configuración del disco de identidad, ejecute los siguientes comandos en este orden:
Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo <!--NeedCopy-->
Reset-ProvVMDisk ProvisioningSchemeName <name> -VMName <name> -Identity <!--NeedCopy-->
-
-
Escriba y para confirmar la acción. También puede omitir el mensaje de confirmación mediante el parámetro
-Force
. Por ejemplo:Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMName <name> -Identity -Force <!--NeedCopy-->
- 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
yIdentityDiskIndex
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 E/S de MCS habilitada, puede usar el comando Set-ProvScheme para modificar los siguientes parámetros:
- WriteBackCacheMemorySize
- WriteBackCacheDiskSize
Esta función se aplica actualmente a:
- Entornos de GCP y Microsoft Azure, y
- un catálogo no persistente con E/S de MCS habilitada
Requisitos
Los requisitos para modificar la configuración de caché son:
- Actualizar a la versión más reciente de VDA (2308 o posterior).
-
Habilitar el parámetro
UseWriteBackCache
para el catálogo de máquinas existente. UseNew-ProvScheme
para crear un catálogo de máquinas con la opciónUseWriteBackCache
habilitada. 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 memoria caché
Ejecute el comando Set-ProvScheme. Por ejemplo:
Set-ProvScheme -ProvisioningSchemeName $provScheme.ProvisioningSchemeName -WriteBackCacheDisk32 -WriteBackCacheMemorySize 128
<!--NeedCopy-->
Nota:
- El valor de
WriteBackCacheDiskSize
debe ser mayor que cero porque se requiere al menos 1 GB de almacenamiento en disco de caché.- El valor de
WriteBackCacheMemorySize
debe ser menor que el tamaño de la memoria del catálogo de máquinas.- Estos cambios solo afectan a las nuevas VM que se agreguen al catálogo después de realizar el cambio. Estos cambios no afectan a las VM existentes.
Compatibilidad con la actualización de VDA mediante acceso a recursos compartidos de archivos locales
Especifique la ubicación del instalador del VDA mediante los cmdlets de PowerShell, lo que reduce la necesidad de proporcionar reglas de red para permitir que cada VDA obtenga el nuevo instalador de VDA en la CDN de Azure administrada por Citrix.
Cmdlets de PowerShell
Se han agregado dos nuevos parámetros opcionales a los cmdlets New-VusCatalogSchedule y New-VusMachineUpgrade que 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 de VUS Agent incluido con VDA 2311
- Agente de actualización de VDA a la versión 7.40.0.35 o posterior (con la versión 2311 o posterior del instalador de VDA)
- Virtual Apps and Desktops Remote PowerShell SDK versión 7.40 o posterior (publicada el 10 de enero de 2024 o posterior)
Cómo configurar los permisos de los recursos compartidos de archivos
Los recursos compartidos de red que contienen los paquetes de instalación de VDA deben tener acceso de lectura para el servicio Agente de actualización de VDA, que se ejecuta como sistema local (entidad principal NT AUTHORITY\SYSTEM).
-
Permiso para recursos compartidos de archivos con unión a un dominio
Cuando la máquina VDA está unida a un dominio, la cuenta del sistema local (VUA se ejecuta como sistema local) usa las credenciales del equipo al acceder a los recursos compartidos de red.
El permiso de privilegio mínimo se puede establecer concediendo acceso de lectura a los equipos del dominio.
- Elija a las personas de su red con las que quiere compartir el archivo.
- Haga clic en Advanced Sharing Settings y active File and Printer Sharing.
-
Permiso para recursos compartidos de archivos sin unión a un dominio
Cuando la máquina VDA no está unida a un dominio, la cuenta Local System (VUA se ejecuta como Local System) usa ANONYMOUS LOGON al acceder a los recursos compartidos de red.
- Seleccione una carpeta compartida.
- Inhabilite la protección con contraseña.
- Vaya a la ficha Properties de la carpeta.
- Seleccione Network and Sharing Center.
- Desactive Password Protected Sharing.
- Haga clic en Advanced Sharing para conceder un permiso para compartir.
- Seleccione Permissions.
- Conceda un permiso de lectura (Read) para el recurso compartido a ANONYMOUS LOGON.
- Seleccione la ficha Security para conceder permisos a la carpeta
- Haga clic en Edit para agregar permisos a la carpeta compartida
- Seleccione la carpeta compartida para conceder permisos de carpeta a ANONYMOUS LOGON.
- Haga clic en Advanced para activar File and Printer Sharing.
- Agregue el nombre de la carpeta compartida a Network Access Security Policy.
Nota:
Reinicie el equipo para que el cambio surta efecto inmediatamente.
Actualizaciones de VDA desde un recurso compartido de archivos local
-
Descargue el instalador del VDA y colóquelo en el recurso compartido de archivos.
Nota:
Con el servicio Virtual Upgrade Service, puede seleccionar entre la pista Current Release o la pista LTSR.
Por ejemplo: Si el catálogo de máquinas está establecido en la versión Current Release, es decir, 2311, y la versión del VDA es 2305, debe actualizar el VDA a la versión 2311.
- Vaya a la página Descargas de nuestro sitio web.
- Seleccione Citrix Virtual Apps and Desktops como producto.
- Seleccione Citrix Virtual Apps and Desktops 7 2311, All Editions.
- Seleccione el instalador del VDA en el nodo Components that are on the product ISO but also packaged separately.
-
Seleccione el instalador de VDA correspondiente según el tipo de catálogo.
- Descargue el instalador de VDA para SO multisesión si el tipo de catálogo es multisesión
- Descargue el instalador de VDA para SO de sesión única si el tipo de catálogo es de sesión única
- Descargue el instalador de VDA de servicios básicos para SO de sesión única si el tipo de catálogo es Acceso con Remote PC
Nota:
La versión del instalador de recursos compartidos de archivos debe coincidir exactamente con la versión del instalador más reciente publicada por VUS en la nube.
Solucionar problemas
- Para máquinas que presentan un “Estado de energía desconocido”, consulte CTX131267 para obtener instrucciones.
- Para reparar máquinas virtuales que muestran continuamente un estado de energía desconocido, consulte How to fix VMs that continuously show an unknown power state.
Qué hacer a continuación
Para obtener información sobre la administración de catálogos de servicios en la nube específicos, consulte:
En este artículo
- Introducción
- Administrar catálogos de máquinas
- Usar Web Studio
- Ver detalles del catálogo
- Agregar máquinas a un catálogo
- Eliminar máquinas de un catálogo
- Modificar un catálogo
- Cambiar el nombre de un catálogo
- Mover un catálogo a otra zona
- Eliminar un catálogo
- Administrar cuentas de equipo de Active Directory en un catálogo
- Actualizar un catálogo
- Cambiar el nivel funcional o deshacer el cambio
- Clonar un catálogo
- Organizar los catálogos por medio de carpetas
- Reintentar la creación de un catálogo
- Inscribir agentes VDA no aprovisionados por MCS mediante tokens (Technical Preview)
- Usar PowerShell
- Recuperar advertencias y errores asociados a un catálogo
- Eliminar máquinas sin acceder al hipervisor
- Habilitar una programación de reinicios únicos
- Agregar descripciones a una imagen
- Restablecer disco de SO
- Cambiar el parámetro de red de un esquema de aprovisionamiento existente
- Administrar versiones de un catálogo de máquinas
- 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
- Reparar la información de identidad de las cuentas de equipo activas
- Cambiar la configuración de la caché en un catálogo de máquinas existente
- Compatibilidad con la actualización de VDA mediante acceso a recursos compartidos de archivos locales
- Solucionar problemas
- Qué hacer a continuación