Administrar catálogos de máquinas

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 anterior.

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 luego actualizando las máquinas. Este método le permite actualizar de manera 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, usted administra las actualizaciones de las máquinas de los usuarios fuera de Web Studio. Realice esta tarea de forma individual o colectiva utilizando 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 restablece 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:

• Mediante Web Studio
• Mediante PowerShell

Usar Web Studio

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

• Administrar catálogos de máquinas
  • Introducción
  • Acerca de las instancias persistentes
• 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(#delete-machines-from-a-catalog)
• Editar un catálogo(#edit-a-catalog)
• Cambiar el nombre de un catálogo(#rename-a-catalog)
• Mover un catálogo a una zona diferente(#move-a-catalog-to-a-different-zone)
• Eliminar un catálogo(#delete-a-catalog)
• Convert legacy MCS catalogs in Azure to machine profile-based catalogs
• Administrar cuentas de equipo de Active Directory en un catálogo(#manage-active-directory-computer-accounts-in-a-catalog)
• Actualizar un catálogo(#update-a-catalog)
  • Actualizar o crear una imagen maestra(#update-or-create-a-master-image)
  • Cambiar la imagen maestra(#change-the-master-image)
  • Revertir la imagen maestra(#roll-back-the-master-image)
• Cambiar el nivel funcional o deshacer el cambio(#change-the-functional-level-or-undo-the-change)
• Clonar un catálogo(#clone-a-catalog)
• Organizar catálogos mediante carpetas(#organize-catalogs-using-folders)
  • Crear una carpeta de catálogo(#create-a-catalog-folder)
  • Mover un catálogo
  • Administrar carpetas de catálogos
• Actualizar VDA
• Reintentar la creación del catálogo
• Inscribir VDA aprovisionados sin MCS mediante tokens
• Usar PowerShell
• Recuperar advertencias y errores asociados a un catálogo
• Agregar descripciones a una imagen
• Restablecer disco del SO
• Cambiar la configuración 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
  • Condiciones
  • Restablecer disco de identidad
• Cambiar la configuración de la caché en un catálogo de máquinas existente
  • Requisitos
  • Cambiar la configuración de la caché
• Compatibilidad con la actualización de VDA mediante el acceso a recursos compartidos de archivos locales
  • Cmdlets de PowerShell
  • Requisitos previos
  • Cómo establecer permisos de recursos compartidos de archivos
  • Actualizaciones de VDA desde un recurso compartido de archivos local
• Solucionar problemas
• Pasos siguientes

Ver detalles del catálogo

1. Utilice la función de búsqueda para localizar un catálogo de máquinas específico. Consulte Buscar instancias para obtener instrucciones.
2. En los resultados de la búsqueda, seleccione un catálogo según sea necesario.
3. Consulte la siguiente tabla para ver las descripciones de las columnas del catálogo.
4. Haga clic en una ficha del panel de detalles inferior para obtener más información sobre este catálogo.

Añadir máquinas a un catálogo

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 los permisos de administrador de dominio adecuados.

Para añadir 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 desea agregar.
5. Si no hay suficientes cuentas de Active Directory existentes 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 diagonal (/) 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 pueden tardar mucho tiempo cuando se crean muchas máquinas. La creación de máquinas continúa incluso si cierra Web Studio.

Eliminar máquinas de un catálogo

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 son necesarios.
• Todos los usuarios han cerrado sesión. Activar el modo de mantenimiento impide que se establezcan nuevas conexiones a una máquina.
• Las máquinas están apagadas.

Para eliminar máquinas de un catálogo:

1. 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 decide eliminar las máquinas, indique si las cuentas de Active Directory de esas máquinas se mantienen, se inhabilitan o se eliminan.

Editar un catálogo

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. En la página NIC, realice las siguientes acciones:

   • Para cambiar la asignación de subred de una NIC, seleccione una red en el campo Red asociada.
   • Para añadir 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 puede agregar NIC a catálogos de máquinas de Azure sin perfiles de máquina.

   Nota:

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

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

   Para los catálogos creados con una imagen de Azure Resource Manager, las siguientes páginas son 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 permanecen sin cambios.

   • En la página Máquinas virtuales, cambie el tamaño de la máquina y las zonas de disponibilidad donde desea 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 host de grupo 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 es compatible con 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 restablece 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 Remote PC, 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.
7. Haga clic en Aplicar para aplicar los cambios realizados y haga clic en Guardar para salir.

Cambiar el nombre 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 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 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 está activado para todas las máquinas del catálogo, de modo que no se puedan establecer nuevas conexiones.
• Todas las máquinas del catálogo están apagadas.
• El catálogo no está asociado a ningún 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 inhabilitan o se eliminan.

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

Para convertir un catálogo de máquinas no basado en perfiles de máquina en un catálogo de máquinas basado en perfiles de máquina, siga estos pasos:

1. En la página Catálogos de máquinas, haga clic con el botón secundario en el nombre del Catálogo de máquinas que quiere convertir y, a continuación, seleccione Modificar catálogo de máquinas.
2. En la página Modificar catálogo de máquinas > Perfil de máquina, marque la casilla Usar un perfil de máquina (obligatorio para Azure Active Directory).
3. Haga clic en Seleccionar un perfil de máquina.
4. En la página Seleccionar un perfil de máquina, seleccione una máquina virtual o una plantilla de inicio para usarla como perfil de máquina.
5. Si algunas configuraciones actuales difieren de las nuevas configuraciones del perfil de máquina, seleccione la opción necesaria para las configuraciones que quiere usar y haga clic en Continuar.
6. Haga clic en Aplicar.

Nota:

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

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:

• Libere 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 multisesión. Esas cuentas se pueden utilizar luego para otras máquinas.
• Agregue cuentas para que, cuando se agreguen más máquinas al catálogo, las cuentas de equipo ya estén configuradas. No utilice una barra diagonal (/) en un nombre de OU.

Para administrar las 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 de Active Directory se mantiene, se inhabilita o se elimina.

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

Actualizar un catálogo

Recomendamos guardar 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 un nombre significativo a la instantánea. Esta instantánea se puede utilizar para revertir (restaurar) máquinas en el 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 se actualice el catálogo en Web Studio. Aunque Web Studio puede crear una instantánea, Citrix recomienda que la cree 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, seleccione el host y la imagen que quiere 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, independientemente de si agrega 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 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 de 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, 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.

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

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

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

Estrategia de implementación:

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

• No se pueden iniciar nuevas sesiones hasta que la actualización se haya completado en las máquinas aplicables.
• Para máquinas con SO de sesión única, las máquinas se actualizan inmediatamente cuando la máquina no está en uso o cuando los usuarios no han iniciado sesión.
• 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 nueva o actualizada, 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 funcional. Las nuevas funciones que requieran la imagen más reciente ya no estará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, tal como se describe en la sección anterior para la operación de implementación.

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

Para seguir el 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 última versión 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 actualizarse.

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 funcionen 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.

Clonar un catálogo

Antes de clonar un catálogo, tenga en cuenta lo siguiente:

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

Nota:

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

• La clonación de un catálogo puede tardar algún 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.

Consejo:

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

Crear una carpeta de catálogo

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

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

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

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

  Ejemplo:

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

Para crear una carpeta de catálogo, 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 de Acciones.
3. Introduzca un nombre para la nueva carpeta y, a continuación, haga clic en Listo.

Consejo:

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. 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 desea mover el catálogo y, a continuación, haga clic en Listo.

Consejo:

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 los pasos que se indican a continuación:

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 Acción según sea necesario:

   • 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.
3. Siga las instrucciones en pantalla para completar los pasos restantes.

Actualizar VDA

Puede usar la interfaz de Studio para actualizar los VDA con facilidad. Para obtener más información y una guía paso a paso, consulte la documentación de Citrix VDA Upgrade Service.

Reintentar la creación del catálogo

Nota:

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

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

• Consulte primero la información de solución de problemas y resuelva los problemas. La información describe los problemas encontrados y ofrece recomendaciones para resolverlos.
• No puede cambiar la configuración asociada con Sistema operativo y administración de máquinas. El catálogo hereda esa configuración del original.
• La creación puede tardar un tiempo en completarse. Si es necesario, seleccione Ocultar progreso para ejecutar la creación en segundo plano.

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

1. Desde Web Studio, seleccione Catálogos de máquinas en el panel izquierdo.
2. Seleccione el catálogo y, a continuación, vaya a su ficha Solucionar problemas.
3. Haga clic en el hipervínculo de reintento para volver a intentar crear el catálogo.
4. En el asistente que aparece, cambie la configuración donde sea necesario. Si no es necesario realizar cambios, puede ir directamente a la página de Resumen.
5. Cuando termine, seleccione Finalizar para iniciar la creación.

Inscribir VDA no aprovisionados por MCS mediante tokens

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

Antes de empezar

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

4. 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

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

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

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

Para generar un token para un catálogo mediante Web Studio, siga estos pasos:

1. En Web Studio > Catálogos de máquinas, busque un catálogo no aprovisionado por MCS, que tenga Método de aprovisionamiento: Manual mostrado en la columna Recuento de máquinas.
2. Haga clic con el botón derecho en el catálogo y, a continuación, seleccione Administrar tokens de inscripción.
3. En la página Generar token de inscripción que aparece, proporcione la siguiente información del 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 la administración de energía de los VDA inscritos con el token. Las opciones incluyen todas las conexiones de host dentro de la zona de este catálogo.
   • Introduzca los límites de uso del token (entre 1 y 5000).
4. Haga clic en Generar.

5. En la ventana Token generado correctamente que aparece, copie el token y guárdelo en un lugar seguro, o haga clic en Descargar para descargarlo en la carpeta Descargas.

   Aparece un registro de token en la lista de tokens.

   

6. Comparta el token con los administradores de instalación de VDA.

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

Administrar tokens

Tiene dos opciones para revocar un token y dejarlo no disponible para la inscripción de VDA:

• Revocar: Revoca el token, pero lo mantiene 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 las máquinas VDA. Esta herramienta le ayuda a convertir una conexión en una conexión WebSocket agregando el VDA al catálogo de máquinas mediante el token de inscripción.

Nota:

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

Siga las instrucciones para ejecutar la herramienta de inscripción:

1. Inicie sesión en el VDA.
2. Localice la herramienta EnrollMachine.exe, en C:\Program Files\Citrix\Virtual Desktop Agent\Web Socket Vda Enrollment Tool.
3. Ejecute la herramienta con los parámetros de entrada adecuados. Por ejemplo, EnrollMachine.exe -websocket_token_string:xxxxxxxxx

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

Tras una inscripción correcta, recibirá un mensaje de éxito 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.

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

Usar PowerShell

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

• Recuperar advertencias y errores asociados a un catálogo(/es-es/citrix-virtual-apps-desktops/2507-ltsr/install-configure/machine-catalogs-manage.html#retrieve-warnings-and-errors-associated-with-a-catalog)
• Añadir descripciones a una imagen(/es-es/citrix-virtual-apps-desktops/2507-ltsr/install-configure/machine-catalogs-manage.html#add-descriptions-to-an-image)
• Restablecer disco del sistema operativo(/es-es/citrix-virtual-apps-desktops/2507-ltsr/install-configure/machine-catalogs-manage.html#reset-os-disk)
• Cambiar la configuración de red de un esquema de aprovisionamiento existente(/es-es/citrix-virtual-apps-desktops/2507-ltsr/install-configure/machine-catalogs-manage.html#change-the-network-setting-for-an-existing-provisioning-scheme)
• Administrar versiones de un catálogo de máquinas(/es-es/citrix-virtual-apps-desktops/2507-ltsr/install-configure/machine-catalogs-manage.html#manage-versions-of-a-machine-catalog)
• Convertir un catálogo de máquinas basado en perfiles no de máquina a un catálogo de máquinas basado en perfiles de máquina(/es-es/citrix-virtual-apps-desktops/2507-ltsr/install-configure/machine-catalogs-manage.html#convert-a-non-machine-profile-based-machine-catalog-to-machine-profile-based-machine-catalog)
• Reparar la información de identidad de las cuentas de equipo activas(/es-es/citrix-virtual-apps-desktops/2507-ltsr/install-configure/machine-catalogs-manage.html#repair-the-identity-information-of-active-computer-accounts)
• Cambiar la configuración de la caché en un catálogo de máquinas existente(/es-es/citrix-virtual-apps-desktops/2507-ltsr/install-configure/machine-catalogs-manage.html#change-cache-configuration-on-an-existing-machine-catalog)
• Compatibilidad con la actualización de VDA mediante el acceso a recursos compartidos de archivos locales(/es-es/citrix-virtual-apps-desktops/2507-ltsr/install-configure/machine-catalogs-manage.html#vda-update-support-via-local-file-share-access)

Recuperar advertencias y errores asociados a un catálogo

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

Mediante 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 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 coincide con este ID de evento. Puede obtener el EventId de un error o advertencia específico como salida del comando Get-ProvOperationEvent.
• Con los parámetros LinkedObjectType y LinkedObjectUid: Establece el estado de todos los errores y advertencias asociados a un esquema de aprovisionamiento específico.
• Con el parámetro All: Establece el estado de todos los errores y advertencias como Reconocidos.

Para eliminar los errores o advertencias:

Ejecute el comando Remove-ProvOperationEvent.

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

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

Eliminar máquinas sin acceso al hipervisor

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

Esta opción está habilitada en:

• todos los hipervisores compatibles
• VM persistentes y no persistentes

Limitaciones

No 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, la operación de eliminación podría fallar en los siguientes escenarios:

• La conexión del host está en modo de mantenimiento
• Credenciales no válidas
• Error de autenticación
• Operación no autorizada
• El hipervisor no está disponible

Nota:

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

Cuando la operación falla porque el hipervisor no está disponible, aparece el siguiente mensaje:

Try to use -PurgeDBOnly option to clean DDC database.

Use la opción -PurgeDBOnly en el comando de PowerShell Remove-ProvVM para eliminar referencias de una máquina virtual de la base de datos de MCS. Por ejemplo,

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

Añadir descripciones a una imagen

Puede añadir descripciones informativas sobre los cambios relacionados con las actualizaciones de imágenes para los catálogos de máquinas. Utilice esta función para añadir 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 añadir o ver descripciones de imágenes:

• Para añadir 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 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ó utilizando una imagen del disco del sistema operativo.
• La instantánea utilizada para crear el catálogo se ha dañado.
• Los cambios de usuario en las máquinas del catálogo no persisten.
• Las máquinas del catálogo están en ejecución.

Restablecer disco del 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 se encuentran 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 su nombre:

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

   • Cree tareas de restablecimiento independientes 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 la capacidad del hipervisor y la comprobación de la 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 se trata de 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 realizar la acción.

   También puede omitir el mensaje de confirmación mediante 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 del 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 comandos de PowerShell. Puede:

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

• 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 utiliza una VM de ese catálogo de máquinas:

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

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

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

Si el número de versiones alcanza el número máximo de versiones, no se 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, 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 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 sin perfil de máquina en un catálogo de máquinas basado en perfil de máquina

Puede usar una VM, una especificación de plantilla (en el caso de Azure), una plantilla de lanzamiento (en el caso de AWS) o una plantilla de VMware (en el caso de VMware) como entrada de perfil de máquina para convertir un catálogo de máquinas sin perfil de máquina en un catálogo de máquinas basado en perfil de máquina. Las nuevas VM añadidas 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 existente basado en un perfil de máquina 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>
      <!--NeedCopy-->
     

   • En el caso de AWS:

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

   • En el caso de VMware:

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

     Nota:

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

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 es compatible con los entornos de virtualización de AWS, GCP, Azure, SCVMM, XenServer y VMware.

Condiciones

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

• Apague la VM y configúrela 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
      <!--NeedCopy-->
     

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

     • IdentityAccountName: El nombre de la cuenta de identidad que debe repararse.
     • PrivilegedUserName: Cuenta de usuario que tiene permiso de escritura en el proveedor de identidades (AD o AzureAD).
     • PrivilegedUserPassword: Contraseña de PrivilegedUserName.
     • Target: Destino de la acción de reparación. Puede ser IdentityInfo para reparar la contraseña de la cuenta/clave de confianza, y UserCertificate para reparar los atributos del certificado de usuario de las identidades de máquina unidas a 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
      <!--NeedCopy-->
     

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

   • Para recrear completamente el disco de identidad:

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

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

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

5. Ejecute Get-ProvVM -ProvisioningSchemeName <name -VMName <name> para comprobar la configuración actualizada del disco de identidad. Los atributos del disco de identidad (por ejemplo, IdentityDiskId) deben actualizarse. StorageId 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 última versión 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
   <!--NeedCopy-->
  

Cambiar la configuración de la caché

Ejecute el comando Set-ProvScheme. Por ejemplo:

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

Nota:

• El valor de WriteBackCacheDiskSize debe ser superior a cero, ya que se requiere al menos 1 GB de almacenamiento en disco de caché.
• El valor de WriteBackCacheMemorySize debe ser inferior al tamaño de la memoria del catálogo de máquinas.
• Estos cambios solo afectan a las nuevas máquinas virtuales 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.

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

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

Cmdlets de PowerShell

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

• VdaWorkstationPackageUri: para especificar la ruta UNC al instalador de VDA del SO de estación de trabajo
• VdaServerPackageUri: para especificar la ruta UNC al instalador de VDA del SO de servidor

Requisitos previos

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

Cómo configurar los permisos de uso compartido de archivos

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

• Permiso de uso compartido de archivos unido a un dominio

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

  El permiso de privilegio mínimo se puede establecer concediendo acceso de Lectura a los equipos de dominio.

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

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

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

  1. Seleccione una carpeta compartida.
  2. Deshabilite la protección con contraseña.
     1. Vaya a Propiedades de la carpeta.
     2. Seleccione Centro de redes y recursos compartidos.
     3. Desactive el Uso compartido protegido con contraseña.
  3. Haga clic en Uso compartido avanzado para conceder un permiso de uso compartido.
     1. Seleccione Permisos.
     2. Conceda un permiso de recurso compartido de Lectura a ANONYMOUS LOGON.
  4. Seleccione la ficha Seguridad para conceder permisos de carpeta
     1. Haga clic en Editar para agregar permisos a la carpeta compartida
     2. Seleccione la carpeta compartida para conceder permisos de carpeta a ANONYMOUS LOGON.
  5. Haga clic en Avanzado para activar el Uso compartido de archivos e impresoras.
  6. Agregue el nombre de la carpeta compartida a la Directiva de seguridad de acceso a la red.

  Nota:

  Reinicie la máquina para que el cambio surta efecto de inmediato.

Actualizaciones de VDA desde un recurso compartido de archivos local

1. Descargue el instalador de VDA y colóquelo en el archivo compartido.

   Nota:

   Con Virtual Upgrade Service, puede seleccionar entre la pista de Current Release o la pista de LTSR.

   Por ejemplo: Si el catálogo de máquinas está configurado en Current Release (que es 2311) y la versión de VDA es 2305, debe actualizar el VDA a la versión 2311.

   1. Vaya a la página de Descargas en nuestro sitio web.
   2. Seleccione Citrix Virtual Apps and Desktops como el producto.
   3. Seleccione Citrix Virtual Apps and Desktops 7 2311, All Editions.
   4. Seleccione el instalador de VDA de la sección desplegable Components that are on product ISO but also packaged separately.

2. Seleccione el instalador de VDA pertinente según el tipo de catálogo.

   • Descargue el Multi-session OS VDA installer si el tipo de catálogo es multi session
   • Descargue el Single-session OS VDA installer si el tipo de catálogo es single session
   • Descargue el Single-session OS Core Services VDA installer si el tipo de catálogo es Remote PC Access

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.

Migración de almacenamiento de máquinas virtuales

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

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

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

El nuevo almacenamiento debe cumplir las siguientes condiciones:

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

Migrar el almacenamiento en disco

Para migrar el almacenamiento en disco:

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

   Si no desea agregar nuevas VM al almacenamiento antiguo, cambie el almacenamiento antiguo a Sustituido. Puede hacerlo mediante Studio o comandos de PowerShell. Para Studio, consulte Editar almacenamiento. Alternativamente, ejecute Set-Hyphostingunitstorage y establezca Superseded como true para deshabilitar la creación de nuevas VM en el almacenamiento antiguo.

   Nota:

   Para las VM no persistentes:

   • Si se utiliza WBC, configure el almacenamiento de destino de WBC en la unidad de alojamiento.
   • Si el almacenamiento de destino del SO está configurado, entonces WBC (si se utiliza) debe ser compatible con el almacenamiento de destino del SO.
   • Si el almacenamiento de destino del SO no está configurado, entonces WBC (si se utiliza) debe ser compatible con el almacenamiento del SO actual.

2. Apague las VM y active el Modo de mantenimiento.

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

   • Ejecute ProvResourceInStorage para obtener información sobre el almacenamiento del SO. Por ejemplo:

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

   • Ejecute TemporaryStorageInfo para obtener información sobre el almacenamiento de WBC. Por ejemplo:

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

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

   Nota:

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

   Ejemplo:

   Máquinas virtuales persistentes:

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

   Importante:

   Para las máquinas virtuales persistentes, se mueven todos los discos. No puede seleccionar qué discos mover.

   Máquinas virtuales no persistentes:

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

   Importante:

   • Si no quiere migrar un disco específico, establezca el valor como None para el parámetro DestinationStorageId.
   • Si la máquina virtual tiene un disco WBC, añada el disco WBC en el parámetro DiskType y añada la información necesaria en el parámetro DestinationStorageId.

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

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

Limitaciones

Tenga en cuenta las siguientes limitaciones:

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

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

Para migrar, haga lo siguiente:

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

   • Azure:

     • Web Studio
     • PowerShell

   • VMware:

     • Web Studio
     • PowerShell

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

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

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

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

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

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

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

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

Solución de problemas

• Para máquinas con el estado “Estado de energía desconocido”, consulte CTX131267 para obtener orientación.
• Para solucionar problemas de máquinas virtuales que muestran continuamente un estado de energía desconocido, consulte Cómo solucionar problemas de máquinas virtuales que muestran continuamente un estado de energía desconocido.

Qué hacer a continuación

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

• Administrar un catálogo de AWS
• Administrar un catálogo de XenServer
• Administrar un catálogo de Google Cloud Platform
• Administrar un catálogo de Microsoft Azure
• Administrar un catálogo de Microsoft System Center Virtual Machine Manager
• Administrar un catálogo de VMware