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

Administrar catálogos de máquinas

September 27, 2024
Contribución de: 
C C

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:

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:

  1. Inicie sesión en Web Studio.
  2. Seleccione Catálogos de máquinas en el panel de la izquierda.
  3. Seleccione un catálogo de máquinas y, a continuación, seleccione Agregar máquinas en la barra de acciones.
  4. Seleccione la cantidad de máquinas virtuales que se van a agregar.
  5. 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.
  6. 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.

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:

  1. Inicie sesión en Web Studio.
  2. Seleccione Catálogos de máquinas en el panel de la izquierda.
  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 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.

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

  5. Es posible que 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.
  6. Haga clic en Aplicar para aplicar los cambios realizados y haga clic en Guardar para salir.
  1. Inicie sesión en Web Studio.
  2. Seleccione Catálogos de máquinas en el panel de la izquierda.
  3. Seleccione un catálogo y, a continuación, seleccione Cambiar nombre de catálogo de máquinas en la barra de acciones.
  4. 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.

  1. Inicie sesión en Web Studio.
  2. Seleccione Catálogos de máquinas en el panel de la izquierda.
  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.

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:

  1. Inicie sesión en Web Studio.
  2. Seleccione Catálogos de máquinas en el panel de la izquierda.
  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 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.

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:

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

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

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.

  1. 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.
  2. Si es necesario, encienda la máquina virtual de la imagen maestra e inicie sesión.
  3. Instale las actualizaciones o realice los cambios necesarios en la imagen maestra.
  4. Apague la máquina virtual.
  5. 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:

  1. Inicie sesión en Web Studio.
  2. Seleccione Catálogos de máquinas en el panel de la izquierda.
  3. Seleccione un catálogo y, a continuación, seleccione Cambiar imagen maestra en la barra de acciones.
  4. En la página Imagen maestra, seleccione el host y la imagen que 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.

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

  6. 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 la imagen 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.

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

  1. Inicie sesión en Web Studio.
  2. Seleccione Catálogos de máquinas en el panel de la izquierda.
  3. Seleccione el catálogo. En la ficha Detalles del panel inferior, se muestra la información de versión.
  4. 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.

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.
  1. Inicie sesión en Web Studio y, a continuación, seleccione Catálogos de máquinas en el panel de la izquierda.
  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, consulte los parámetros del catálogo clonado y configúrelos según corresponda. Seleccione Siguiente para pasar a la página siguiente.
  4. En la página Resumen, verá un resumen de los parámetros. Seleccione Finalizar para iniciar la clonación.
  5. 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.

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:

  1. Seleccione Catálogos de máquinas en el panel de la izquierda.
  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.

Sugerencia:

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

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

  1. Seleccione Catálogos de máquinas en el panel de la izquierda.
  2. 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.
  3. Haga clic con el botón secundario en un catálogo y, a continuación, seleccione Mover catálogo de máquinas.
  4. Seleccione la carpeta a la que quiere mover el catálogo y, a continuación, haga clic en Listo.

Sugerencia:

Puede arrastrar un catálogo a una carpeta.

Administrar carpetas de catálogos

Puede eliminar, 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:

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

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

Usar PowerShell

En esta sección se detalla cómo puede administrar catálogos con PowerShell:

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:

  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 todas las 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 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 el EventId de un error o advertencia específico como resultado del comando Get-ProvOperationEvent
  • Con los parámetros LinkedObjectType y LinkedObjectUid: 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 el EventId de un error o advertencia específico como resultado del comando Get-ProvOperationEvent
  • Con los parámetros LinkedObjectType y LinkedObjectUid: 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.

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

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

  4. 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-->
  5. Ejecute Get-ProvTask para obtener el estado de las tareas devueltas por el comando Reset-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:

  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 ir a la ruta de red que quiere cambiar.

  3. Asigne una variable al nuevo parámetro 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 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:

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

  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 ú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-->

  4. 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-->
  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 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. Use New-ProvScheme para crear un catálogo de máquinas con la opción UseWriteBackCache 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.

Solucionar problemas

Qué hacer a continuación

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

Administrar catálogos de máquinas
September 27, 2024
Contribución de: 
C C
September 27, 2024
Contribución de: 
C C

En este artículo

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