Administrar catálogos de máquinas

Nota:

Este artículo describe cómo administrar catálogos mediante comandos de Studio y PowerShell. Si creaste el catálogo con el nodo Implementación rápida y sigues usando ese nodo para administrar el catálogo, consulta Administrar catálogos en Implementación rápida.

Introducción

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

El mantenimiento del catálogo también puede incluir las tareas de asegurarse de que cada máquina tenga las últimas actualizaciones del sistema operativo, actualizaciones de software 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 utilizada en el catálogo y, a continuación, actualizando las máquinas. Este método te permite actualizar un gran número de máquinas de usuario de forma eficiente.
• Para los catálogos que contienen máquinas estáticas asignadas permanentemente, puedes administrar la imagen o la plantilla que esos catálogos utilizan actualmente, pero solo las máquinas que agregues a los catálogos más adelante se crearán con la nueva imagen o plantilla.
• Para los catálogos de Acceso con PC remoto, administras las actualizaciones de las máquinas de los usuarios fuera de Studio. Realiza esta tarea de forma individual o colectiva mediante herramientas de distribución de software de terceros.

Para obtener información sobre cómo crear y administrar conexiones a hipervisores de host y servicios en la nube, consulta Crear y administrar conexiones y recursos.

Nota:

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

Acerca de las instancias persistentes

Al actualizar la imagen maestra de un catálogo de MCS que contiene máquinas persistentes, las máquinas nuevas que se agreguen al catálogo usarán la imagen actualizada. Las máquinas existentes seguirán usando la imagen maestra original. El proceso de actualización de una imagen se realiza de la misma manera que para cualquier otro tipo de catálogo. Ten en cuenta lo siguiente:

• Con los catálogos de discos persistentes, las máquinas preexistentes no se actualizan a la nueva imagen, pero las máquinas nuevas que se agreguen al catálogo usarán la nueva imagen.
• Para los catálogos de discos no persistentes, la imagen de la máquina se actualiza la próxima vez solo si la máquina se reinicia dentro de Studio o PowerShell. Si la máquina se reinicia desde el hipervisor fuera de Studio, el disco no se restablece.
• Para los catálogos que no persisten, si quieres imágenes diferentes para máquinas diferentes, las imágenes deben residir en catálogos separados.

Administrar catálogos de máquinas

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

• Mediante Studio
• Mediante PowerShell

Usar Studio

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

• Ver los detalles del catálogo
• Agregar máquinas a un catálogo
• Eliminar máquinas de un catálogo
• Modificar un catálogo
• Cambiar el nombre de un catálogo
• Eliminar un catálogo
• Administrar las cuentas de equipo de Active Directory en un catálogo
• Cambiar la imagen maestra de un catálogo
• Convertir catálogos aprovisionados por MCS de imágenes maestras a imágenes preparadas.
• Cambiar el nivel funcional o deshacer el cambio
• Clonar un catálogo
• Organizar catálogos mediante carpetas
• Actualizar VDA
• Administrar la configuración de optimización de la experiencia para un catálogo
• Reintentar la creación del catálogo
• (Solo VDA no aprovisionados por Citrix®) Generar y administrar tokens de inscripción

Ver los detalles del catálogo

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

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

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

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

   Ficha	Descripción
   Detalles	Resume la configuración clave del catálogo de máquinas, como el tipo de máquina, el método de aprovisionamiento, la cuenta de servicio, el sistema operativo y la versión de VDA, lo que te permite ver y administrar rápidamente tus recursos.
   Propiedades de la plantilla	Disponible solo para catálogos aprovisionados por MCS. Muestra información detallada de aprovisionamiento para el catálogo seleccionado, incluyendo • Propiedades de la plantilla de máquina • Detalles específicos del hipervisor • Propiedades del perfil de máquina
   Máquinas	Muestra una lista paginada de nombres de máquinas en el catálogo seleccionado.
   Grupos de entrega	Disponible para catálogos de PC remoto. Muestra los grupos de entrega asociados al catálogo seleccionado. Muestra el nombre del grupo de entrega y la asociación del catálogo.
   Etiquetas	No disponible en entornos multiempresa. Muestra el nombre de la etiqueta y la descripción de las etiquetas asignadas al catálogo de máquinas seleccionado.
   Administración del entorno de trabajo	Solo visible cuando el servicio WEM está aprovisionado y accesible. Muestra la configuración de optimización del sistema de administración del entorno de trabajo.
   Información de costes	Aplicable solo a catálogos de Azure MCS, esto muestra • Coste total incurrido en los últimos 30 días. • Una comparación entre el coste total actual de 30 días y el período anterior de 30 días. El acceso requiere el permiso de Citrix Administración de costes > Administrar > Leer coste (predeterminado para administradores de la nube) para ver la ficha, y el permiso de Azure Microsoft.CostManagement/query/read para ver los detalles de los costes.
   Solucionar problemas	Muestra errores o advertencias del catálogo con acciones recomendadas.

Agregar máquinas a un catálogo

Antes de empezar

• Asegúrate de que el host de virtualización (hipervisor o proveedor de servicios en la nube) tenga suficientes procesadores, memoria y almacenamiento para alojar las máquinas adicionales.
• Asegúrate de tener suficientes cuentas de equipo de Active Directory sin usar. Si utilizas cuentas existentes, el número de máquinas que puedes agregar está limitado por el número de cuentas disponibles.
• Si utilizas Studio para crear cuentas de equipo de Active Directory para las máquinas adicionales, debes tener los permisos de administrador de dominio adecuados.

Sugerencia:

Si la cuenta de Citrix DaaS utilizada para agregar máquinas al catálogo de máquinas tiene permisos de AD restringidos, agrega todos los Cloud Connectors que quieras usar en la pantalla Iniciar sesión en….

Para agregar máquinas a un catálogo

1. Desde Studio, selecciona Catálogos de máquinas en el panel izquierdo.
2. Selecciona un catálogo de máquinas y, a continuación, selecciona Agregar máquinas en la barra de acciones.
3. En la página Máquinas virtuales, selecciona el número de máquinas virtuales que quieres agregar.

4. En la página Identidades de máquina, configura los ajustes de la siguiente manera:

   • Selecciona una identidad de la lista.

   • Si corresponde, indica si quieres crear cuentas o usar las existentes, y la ubicación (dominio) de esas cuentas.

     Si no hay suficientes cuentas de Active Directory existentes para el número de máquinas virtuales que vas a agregar, selecciona el dominio y la ubicación donde se crearán las cuentas.

     Si utilizas cuentas de Active Directory existentes, explora las cuentas o selecciona Importar y especifica un archivo .csv que contenga los nombres de las cuentas. Asegúrate de que haya suficientes cuentas para todas las máquinas que vas a agregar. Studio gestiona estas cuentas. Permite que esa interfaz restablezca las contraseñas de todas las cuentas, o especifica la contraseña de la cuenta, que debe ser la misma para todas las cuentas.

   • Si este grupo de identidades es utilizado por otros catálogos, no puedes cambiarlo a un grupo diferente usando Studio. En su lugar, utiliza el cmdlet de PowerShell Set-ProvScheme. Para obtener más información, consulta la Documentación del SDK de Citrix Virtual Apps and Desktops.

   • Especifica un esquema de nombres de cuenta, utilizando signos de almohadilla para indicar dónde aparecen números o letras secuenciales. 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, y así sucesivamente.

• Opcionalmente, puedes especificar con qué empiezan los nombres de las cuentas.

  Al especificar con qué empiezan los nombres de las cuentas, ten en cuenta el siguiente escenario: Si los números o letras iniciales ya están en uso, la primera cuenta creada se nombra utilizando los números o letras no utilizados más cercanos a continuación.

  Consulta Administrar el número de secuencia del nombre de la máquina para personalizar el número de secuencia de las máquinas implementadas con MCS mediante comandos de PowerShell.

1. En la página Credenciales de dominio, selecciona Introducir credenciales e introduce las credenciales de usuario con permisos suficientes para crear cuentas de máquina.

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

Usar archivos CSV para agregar máquinas en bloque a un catálogo

Puedes agregar máquinas en bloque usando archivos CSV. Esta función está disponible para todos los catálogos, excepto los catálogos aprovisionados a través de MCS.

Para agregar máquinas en bloque a un catálogo, completa los siguientes pasos:

1. Desde Studio, selecciona Catálogos de máquinas en el panel izquierdo.
2. Selecciona un catálogo de máquinas y, a continuación, selecciona Agregar máquinas en la barra de acciones. Aparece la ventana Agregar máquinas.
3. Selecciona Agregar archivo CSV. Aparece la ventana Agregar máquinas en bloque.
4. Selecciona Descargar plantilla CSV.
5. Rellena el archivo de plantilla.
6. Arrastra o explora hasta el archivo para cargarlo.
7. Selecciona Validar para realizar comprobaciones de validación en tu importación.
8. Selecciona Importar para completar el proceso.

Consideraciones al usar archivos CSV para agregar máquinas

Nota:

• Para usuarios que no son de Active Directory, debes escribir sus nombres en este formato: <proveedor de identidades>:<nombre de usuario>. Ejemplo: AzureAD:username.
• Los nombres de las VM distinguen entre mayúsculas y minúsculas. Al introducir las rutas de las VM, asegúrate de introducir los nombres de las VM correctamente.

Al modificar el archivo de plantilla CSV, ten en cuenta lo siguiente:

• Esta función te ofrece más flexibilidad para agregar máquinas en bloque a través de un archivo CSV. En el archivo, puedes agregar solo máquinas (para usar con asignaciones automáticas de usuarios) o agregar máquinas junto con asignaciones de usuarios. Escribe tus datos en el siguiente formato:

  • Para pares de cuenta de máquina y nombre de usuario (samName):

  • Domain\ComputerName1, Domain\Username1
  • Domain\ComputerName2, Domain\Username1;Domain\Username2

  • Domain\ComputerName3, AzureAD:username

  • Solo para cuentas de máquina:

  • Domain\ComputerName1

  • Domain\ComputerName2

  • Para pares de VM y nombre de usuario:

  • XDHyp:\Connections\ConnectionName\RegionName\vm.folder\VMName1.vm,Domain\ComputerName1,Domain\Username1

  • XDHyp:\Connections\ConnectionName\RegionName\vm.folder\VMName2.vm,Domain\ComputerName2,Domain\Username2

  • Solo para VM:

  • XDHyp:\Connections\ConnectionName\RegionName\vm.folder\VMName1.vm,Domain\ComputerName1

  • XDHyp:\Connections\ConnectionName\RegionName\vm.folder\VMName2.vm,Domain\ComputerName2

    Por ejemplo: XDHyp:\Connections\xpace-scale\East US.region\vm.folder\wsvdaV3-2.vm

    donde,

  • xpace-scale es el ConnectionName: El nombre de la conexión que introdujiste en Alojamiento > Agregar conexiones y recursos. Para obtener más información, consulta Crear una conexión y recursos.
  • East US.region es el RegionName: El nombre de la región con .region como extensión.
  • wsvdaV3-2.vm es el VMName: El nombre de la máquina virtual con .vm como extensión.

• El número máximo de máquinas que puede contener un archivo es 1000. Para importar más de 1000 máquinas, distribúyelas en diferentes archivos y luego impórtalos uno por uno. Te recomendamos que no importes más de 1000 máquinas. De lo contrario, la creación del catálogo puede tardar mucho tiempo en completarse.

También puedes exportar máquinas de un catálogo en la misma página Agregar máquinas. El archivo CSV exportado de máquinas se puede usar como plantilla al agregar máquinas en bloque. Para exportar máquinas:

1. Desde Studio, selecciona Catálogos de máquinas en el panel izquierdo.
2. Selecciona un catálogo de máquinas y, a continuación, selecciona Agregar máquinas en la barra de acciones. Aparece la ventana Agregar máquinas.
3. Selecciona Exportar a archivo CSV. Se descarga un archivo CSV que contiene una lista de las máquinas.
4. Abre el archivo CSV para agregar o modificar máquinas según sea necesario. Para agregar máquinas en bloque usando el archivo CSV guardado, consulta la sección anterior, Usar archivos CSV para agregar máquinas en bloque a un catálogo.

Nota:

• Esta función no está disponible para catálogos de Acceso con PC remoto ni para catálogos aprovisionados con MCS.

• La exportación e importación de máquinas en archivos CSV solo se admite entre catálogos del mismo tipo.

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

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

Nota:

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

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

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

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

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

Solución de problemas

Por defecto, puedes encontrar los registros de la herramienta de inscripción en:

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

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

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

Quitar máquinas de un catálogo

Después de quitar una máquina de un catálogo de máquinas, los usuarios ya no podrán acceder a ella, por lo que, antes de quitar una máquina, asegúrate 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 quitar máquinas de un catálogo:

1. En Studio, selecciona Catálogos de máquinas en el panel izquierdo.
2. Selecciona un catálogo y, a continuación, selecciona Ver máquinas en la barra de acciones.
3. Selecciona una o varias máquinas y, a continuación, selecciona Quitar en la barra de acciones.
4. Si vas a quitar máquinas persistentes del catálogo, elige si también quieres quitarlas del hipervisor o del servicio en la nube. Si eliges quitarlas, indica si quieres conservar, inhabilitar o quitar sus cuentas de Active Directory.

Cuando quitas máquinas persistentes de un catálogo de Azure Resource Manager, las máquinas y los grupos de recursos asociados se quitan de Azure, incluso si eliges conservarlos.

Cuando quitas máquinas no persistentes de un catálogo, se quitan automáticamente del hipervisor o del servicio en la nube.

Modificar un catálogo

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

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

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

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

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

   Nota:

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

5. En la página Actualización de VDA, cambia o selecciona la versión de VDA a la que quieres actualizar. Para obtener más información, consulta Actualización de VDA.

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

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

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

     Nota:

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

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

     Nota:

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

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

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

     Nota:

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

   Para obtener más información sobre la configuración disponible en las páginas, consulta Crear un catálogo de máquinas con una imagen de Azure Resource Manager.

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

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

1. En la página Descripción, cambia la descripción del catálogo.
2. Haz clic en Aplicar para aplicar los cambios que hiciste y haz clic en Guardar para salir.

Cambiar el nombre de un catálogo

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

Eliminar un catálogo

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

• Todos los usuarios hayan cerrado sesión y no haya 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 un grupo de entrega. Es decir, el grupo de entrega no contenga máquinas del catálogo.

Para eliminar un catálogo:

1. En Studio, selecciona Catálogos de máquinas en el panel izquierdo.
2. Selecciona un catálogo y, a continuación, selecciona Eliminar catálogo de máquinas en la barra de acciones.
3. Si el catálogo contiene máquinas persistentes, indica si también quieres eliminar esas máquinas del hipervisor o del servicio en la nube. Si decides hacerlo, elige si quieres conservar, deshabilitar o eliminar sus cuentas de equipo de Active Directory.
4. Si es necesario, selecciona Ocultar progreso para ejecutar la eliminación en segundo plano.

Nota:

• Cuando eliminas un catálogo de Azure Resource Manager, las máquinas y los grupos de recursos asociados se eliminan de Azure, incluso si eliges conservarlos.
• Cuando eliminas un catálogo que contiene máquinas no persistentes, esas máquinas se eliminan del hipervisor o del servicio en la nube.
• Si el hipervisor o el servicio en la nube no están disponibles durante la eliminación del catálogo, la eliminación del catálogo y de la VM fallará. Si es necesario, puedes optar por eliminar los registros de VM solo de la base de datos de tu sitio de Citrix. Para ello, selecciona el catálogo de máquinas en el nodo Catálogos de máquinas y, a continuación, realiza la eliminación que se muestra en la ficha Solucionar problemas. Ten en cuenta que esta acción deja las VM intactas en el host.

Administrar cuentas de equipo de Active Directory en un catálogo

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

• Liberar cuentas de máquina no utilizadas quitando las cuentas de equipo de Active Directory de los catálogos de sesión única y de varias sesiones. Esas cuentas se pueden usar luego para otras máquinas.
• Agregar cuentas para que, cuando se agreguen más máquinas al catálogo, las cuentas de equipo ya estén configuradas. No uses una barra diagonal (/) en un nombre de OU.

Para administrar cuentas de Active Directory:

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

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

   Es posible que tengas que restablecer las contraseñas si no conoces las contraseñas actuales de las cuentas; debes tener permiso para realizar un restablecimiento de contraseña. Si introduces una contraseña, esta se cambiará en las cuentas a medida que se importan. Si eliminas una cuenta, elige si la cuenta de Active Directory se debe conservar, deshabilitar o eliminar.

También puedes indicar si las cuentas de Active Directory se deben conservar, deshabilitar o eliminar cuando quites máquinas de un catálogo o elimines un catálogo.

Cambiar la imagen maestra de un catálogo

Te recomendamos que guardes copias o instantáneas de las imágenes antes de cambiar la imagen maestra de un catálogo. La base de datos mantiene un registro histórico de las imágenes utilizadas con cada catálogo de máquinas. Si los usuarios tienen problemas con la nueva imagen que implementaste en sus escritorios, puedes revertirla a la versión anterior, minimizando el tiempo de inactividad del usuario. No elimines, muevas ni cambies el nombre de las imágenes. De lo contrario, no podrás revertir la imagen maestra.

Importante:

Al cambiar la imagen maestra de un catálogo persistente, ten en cuenta lo siguiente: solo las máquinas que agregues al catálogo más tarde se crearán utilizando la nueva imagen. No implementamos la nueva imagen en las máquinas existentes del catálogo.

Después de que una máquina se actualiza, se reinicia automáticamente.

Convertir catálogos aprovisionados por MCS de imágenes maestras a imágenes preparadas

Para convertir un catálogo aprovisionado por MCS de una imagen maestra a una imagen preparada, sigue estos pasos:

1. Haz clic en Catálogos de máquinas en el panel izquierdo y selecciona un catálogo de máquinas que quieras convertir. Haz clic con el botón derecho y selecciona Convertir a imagen preparada.
2. En la página Imagen, selecciona una imagen preparada.
3. En la página Estrategia de implementación, selecciona cuándo quieres actualizar este catálogo con la imagen preparada seleccionada.
4. En la página Resumen, verifica los detalles y haz clic en Finalizar.
5. Verifica los detalles del catálogo de máquinas convertido en Propiedades de la plantilla.

Actualmente, esta función solo está disponible para entornos de virtualización de Azure y VMware.

Actualizar o crear una imagen

Antes de cambiar la imagen maestra de un catálogo, prepara una nueva imagen en tu hipervisor host actualizando una imagen existente o creando una.

1. En tu hipervisor o proveedor de servicios en la nube, toma una instantánea de la VM actual y asígnale un nombre significativo. Esta instantánea se puede usar para revertir la imagen maestra.
2. Si es necesario, enciende la imagen e inicia sesión.
3. Instala las actualizaciones o realiza los cambios necesarios en la imagen.
4. Si la imagen utiliza un vDisk personal, actualiza el inventario.
5. Apaga la VM.
6. Toma una instantánea de la VM y asígnale un nombre significativo que se reconozca al cambiar la imagen maestra.

Nota:

Aunque puedes crear una instantánea utilizando la interfaz de administración, te recomendamos que crees una instantánea utilizando la consola de administración del hipervisor y, a continuación, selecciones esa instantánea en Studio. Esto te permite proporcionar un nombre y una descripción significativos en lugar de un nombre generado automáticamente. Para las imágenes de GPU, solo puedes cambiar la imagen a través de la consola XenCenter® de XenServer.

Cambiar la imagen maestra

Para implementar una nueva imagen maestra en todas las máquinas de un catálogo:

1. En Studio, selecciona Catálogos de máquinas en el panel izquierdo.
2. Selecciona un catálogo y, a continuación, selecciona Cambiar imagen maestra en la barra de acciones.

3. En la página Imagen, selecciona el host y la imagen que quieres implementar.

   Sugerencia:

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

4. En la página Estrategia de implementación, elige cuándo se cambiarán las máquinas del catálogo de máquinas con la nueva imagen: 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.

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

Para seguir el progreso de la actualización, localiza 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. Para un catálogo no persistente, puedes seguir el estado de actualización de su imagen a través de la columna Actualización de imagen, que incluye Totalmente actualizado, Parcialmente actualizado, Actualización pendiente y Preparando imagen.

Sugerencia:

Para mostrar la columna Actualización de imagen, selecciona el icono Columnas a mostrar en la barra de acciones, selecciona Catálogo de máquinas > Estado de la imagen y, a continuación, haz clic en Guardar.

Si estás actualizando un catálogo mediante el SDK de PowerShell, puedes especificar una plantilla de hipervisor (VMTemplates) como alternativa a una imagen o a una instantánea de una imagen.

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

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

Estrategia de implementación

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

Nota:

La estrategia de implementación solo es aplicable a las máquinas virtuales no persistentes.

Considera lo siguiente:

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

Sugerencia:

Limita el número de máquinas que se reinician utilizando la configuración avanzada para una conexión de host. Utiliza 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 actualizada o nueva, puedes revertirla. Esto podría ser necesario si surgen problemas con las máquinas recién actualizadas. Cuando reviertes, las máquinas del catálogo se revierten a la última imagen que funcionaba. Cualquier nueva función que requiera la imagen más reciente ya no estará disponible. Al igual que con la implementación, revertir una máquina incluye un reinicio.

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

La reversión se aplica solo a las máquinas que necesitan ser revertidas. Para las máquinas que no se han cambiado a la imagen nueva o actualizada (por ejemplo, máquinas con usuarios que no han cerrado sesión), los usuarios no reciben mensajes de notificación y no se les obliga a cerrar sesión.

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

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

• No tienes permiso para revertir.
• El catálogo no se creó usando MCS.
• El catálogo se creó usando 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.

Cambiar el nivel funcional o deshacer el cambio

Cambia el nivel funcional del catálogo de máquinas después de actualizar los VDA de las máquinas a una versión más reciente. Recomendamos 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:

• Inicia las máquinas actualizadas para que se registren con Citrix DaaS. Esto permite que la interfaz de administración determine que las máquinas del catálogo necesitan una actualización.

Para cambiar el nivel funcional de un catálogo:

1. Desde Studio, selecciona Catálogos de máquinas en el panel izquierdo.
2. Selecciona el catálogo. La ficha Detalles en el panel inferior muestra la información de la versión.
3. Selecciona Cambiar nivel funcional. Si la interfaz de administración detecta que el catálogo debe cambiar el nivel funcional, muestra un mensaje. Sigue las indicaciones. Si una o más máquinas no se pueden cambiar, un mensaje explica el motivo. Para asegurarte de que todas las máquinas funcionen correctamente, te recomendamos que resuelvas esos problemas antes de hacer clic en Cambiar.

Una vez completada la actualización del catálogo, puedes revertir las máquinas a sus versiones anteriores de VDA 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, ten en cuenta las siguientes consideraciones:

• No puedes 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 seleccionas un catálogo de Azure para clonar y seleccionas una imagen maestra, el panel enumera todas las imágenes que pertenecen a la misma región que las de Recursos.

• Clonar un catálogo puede llevar algún tiempo. Si es necesario, selecciona Ocultar progreso para ejecutar la clonación en segundo plano.
• El catálogo clonado hereda el nombre del original y tiene el sufijo Copy. Puedes cambiar el nombre. Consulta Cambiar el nombre de un catálogo.
• Una vez completada la clonación, asegúrate de asignar el catálogo clonado a un grupo de entrega.
• Puedes crear un catálogo vacío mediante la clonación. Durante la clonación del catálogo, puedes establecer el número de máquinas en cero para los catálogos aprovisionados por MCS y no agregar máquinas para los catálogos no aprovisionados por MCS.

1. Desde Studio, selecciona Catálogos de máquinas en el panel izquierdo.
2. Selecciona un catálogo y, a continuación, selecciona Clonar en la barra de acciones.
3. En la ventana Clonar catálogo de máquinas seleccionado, visualiza la configuración del catálogo clonado y configura los ajustes según corresponda. Selecciona Siguiente para pasar a la página siguiente.
4. En la página Resumen, visualiza un resumen de la configuración y selecciona Finalizar para iniciar la clonación.
5. Si es necesario, selecciona Ocultar progreso para ejecutar la clonación en segundo plano.

Organizar catálogos usando carpetas

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

Sugerencia:

Puedes establecer tu vista predeterminada preferida (vista de carpeta o vista 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.

Roles necesarios

Por defecto, necesitas tener uno de los siguientes roles integrados para crear y administrar carpetas de catálogo: Administrador de la nube, Administrador completo o Administrador de catálogos de máquinas. Si es necesario, puedes personalizar los roles para crear y administrar carpetas de catálogo. Para obtener más información, consulta Permisos necesarios.

Crear una carpeta de catálogo

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

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

• Todos los nodos de 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 renombrar o mover carpetas, usa nombres únicos para las carpetas de primer nivel en los diferentes nodos.

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

  Ejemplo:

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

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

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

Consejo:

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

Mover un catálogo

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

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

Consejo:

Puedes arrastrar un catálogo a una carpeta.

Administrar carpetas de catálogo

Puedes quitar, renombrar y mover carpetas de catálogo.

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

Para administrar una carpeta, sigue estos pasos:

1. En Studio, selecciona Catálogos de máquinas en el panel izquierdo.

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

   • Para renombrar la carpeta, selecciona Renombrar carpeta.
   • Para quitar la carpeta, selecciona Quitar carpeta.
   • Para mover la carpeta, selecciona Mover carpeta.
3. Sigue las instrucciones en pantalla para completar los pasos restantes.

Permisos necesarios

La siguiente tabla enumera los permisos necesarios para realizar acciones en las carpetas de catálogo.

Actualizar VDA

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

Administrar la configuración de optimización de la experiencia para un catálogo

Antes de empezar, asegúrate de que tu implementación del servicio Workspace Environment Management (WEM) esté configurada. Para obtener más información, consulta Introducción al servicio Workspace Environment Management.

Permisos necesarios

Por defecto, la creación y administración de conjuntos de configuración para catálogos de máquinas requiere el rol de Administrador completo de WEM, junto con uno de los siguientes roles:

• Administrador de acceso completo
• Administrador de la nube
• Administrador de catálogos de máquinas

Para permitir que otros roles administren conjuntos de configuración, asígnales tanto el permiso Administrar conjuntos de configuración como el rol de Administrador completo de WEM.

Modificar la configuración de optimización de la experiencia

Selecciona una opción de Optimización de la experiencia para aplicar al catálogo:

• Aplicar configuración predeterminada: Selecciona esta opción para aplicar la configuración de optimización predeterminada, que incluye la protección automática contra picos de CPU y la optimización inteligente de la CPU.

• Aplicar configuración personalizada: Introduce un nombre para crear un conjunto de configuración y, a continuación, personaliza la configuración de optimización según tus requisitos. También puedes seleccionar un conjunto de configuración existente.

Reintentar la creación de catálogos

Nota:

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

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

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

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

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

(Solo para VDA aprovisionados sin Citrix) Generar y administrar tokens de inscripción

Nota:

Para realizar esta tarea, debes tener el rol de Administrador de la nube.

Después de decidir adoptar la inscripción basada en tokens para máquinas no aprovisionadas por Citrix, genera tokens por catálogo de máquinas y, a continuación, compártelos con los administradores de instalación de VDA.

Un token de inscripción incluye:

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

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

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

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

   Aparece un registro de token en la lista de tokens.

   

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

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

Administrar tokens

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

• Revocar: Revoca el token, pero lo conserva en la lista para fines de registro.
• Quitar: Revoca el token y lo quita de la lista.

Nota:

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

Usar PowerShell

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

• Usar PowerShell para comprobar el estado de actualización y la versión de VDA
• Administrar el número de secuencia del nombre de la máquina
• Agregar descripciones a una imagen
• Restablecer disco del SO
• Reparar la información de identidad de las cuentas de equipo activas
• Cambiar la configuración de red de un catálogo de máquinas existente
• Administrar versiones de un catálogo de máquinas
• Cambiar la configuración de la caché de un catálogo de máquinas existente
• Convertir un catálogo de máquinas basado en perfiles no de máquina en un catálogo de máquinas basado en perfiles de máquina
• Recuperar advertencias y errores asociados a un catálogo
• Quitar máquinas sin acceso a hipervisor
• Actualizar propiedades de VM individuales

Administrar el número de secuencia del nombre de la máquina

Para personalizar el número de secuencia de las máquinas, que se implementan mediante MCS, a través de comandos de PowerShell, haz lo siguiente:

1. Abre PowerShell como administrador en el Delivery Controller.
2. Ejecuta el comando asnp citrix* para cargar los módulos de Citrix.

3. Ejecuta el siguiente comando para comprobar el recuento inicial del grupo de identidades del catálogo:

   Get-AcctIdentityPool -IdentityPoolName xxx

   IdentityPoolName es el nombre del catálogo.

4. Si quieres establecer este recuento en un valor diferente, ejecuta el siguiente comando y especifica StartCount como X:

   Set-AcctIdentityPool -IdentityPoolName xxx -StartCount X

5. Agrega las máquinas al catálogo para que se creen con el recuento requerido.
6. Después de crear las máquinas, ejecuta el siguiente comando para restablecerlo al valor original Y:

Set-AcctIdentityPool -IdentityPoolName xxx -StartCount Y

Agregar descripciones a una imagen

Puedes agregar descripciones informativas sobre los cambios relacionados con las actualizaciones de imágenes para los catálogos de máquinas. Usa esta función para agregar una descripción al crear un catálogo o al actualizar una imagen maestra existente para un catálogo. También puedes mostrar información para cada imagen maestra en el catálogo. Esta funcionalidad es útil para los administradores que desean agregar etiquetas descriptivas al actualizar una imagen maestra utilizada por un catálogo, por ejemplo, Office 365 instalado. Usa los siguientes comandos para agregar o ver descripciones de imágenes:

• NewProvScheme. Un nuevo parámetro, masterImageNote, te permite agregar una nota a una imagen. Por ejemplo:

C:\PS>New-ProvScheme -ProvisioningSchemeName XenPS -HostingUnitName XenHu -IdentityPoolName idPool1 -MasterImageVM XDHyp:\HostingUnits\XenHU\Base.vm\Base.snapshot -MasterImageNote "Office365 installed"
<!--NeedCopy-->

• Publish-ProvMasterVMImage. Usa este parámetro para publicar la nota. Por ejemplo:

C:\PS>Publish-ProvMasterVMImage -ProvisioningSchemeName MyScheme -MasterImageVM XDHyp:\HostingUnits\HostUnit1\RhoneCC_baseXP.vm\base.snapshot -MasterImageNote "Visual Studio 2019 installed"

• Get-ProvSchemeMasterVMImageHistory. Muestra información para cada imagen. Por ejemplo:

`C:\PS>Get-ProvSchemeMasterVMImageHistory -ProvisioningSchemeName MyScheme -Showall

VMImageHistoryUid : 3cba3a75-89cd-4868-989b-27feb378fec5

ProvisioningSchemeUid : 7585f0de-192e-4847-a6d8-22713c3a2f42

ProvisioningSchemeName : MyScheme

MasterImageVM : /Base.vm/base.snapshot

Date : 17/05/2021 09:27:50

MasterImageNote : Office365 installed`

Restablecer disco del SO

Usa el comando de PowerShell Reset-ProvVMDisk para restablecer el disco del SO 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, Google Cloud, SCVMM, VMware y XenServer®.

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

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

Realiza los siguientes pasos para restablecer el disco del SO:

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

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

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

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

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

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

   • Especifica una sola VM por nombre:

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

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

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

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

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

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

   • Proporciona el parámetro -Force:

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

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

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

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

       PS C:\Windows\system32> $ConfirmPreference='None'
       PS C:\Windows\system32> $ConfirmPreference
       None
       PS C:\Windows\system32> Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS
       <!--NeedCopy-->
  

Nota:

No saques las máquinas virtuales del modo de mantenimiento ni las enciendas hasta que se complete el proceso de restablecimiento.

1. Ejecuta Get-ProvTask para obtener el estado de las tareas devueltas por el comando Reset-ProvVMDisk.

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

Puedes restablecer la información de identidad de las cuentas de equipo activas que tengan problemas relacionados con la identidad. Puedes 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 tanto a los catálogos de máquinas MCS persistentes como a los no persistentes.

Nota:

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

Condiciones

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

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

Restablecer la información de identidad

Para restablecer la información de identidad:

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

3. Restablece la información de identidad.

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

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

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

     • IdentityAccountName: El nombre de la cuenta de identidad que se debe reparar.
     • PrivilegedUserName: Cuenta de usuario que tiene permiso de escritura en el proveedor de identidades (AD o Microsoft Entra ID).
     • 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 o la clave de confianza, y UserCertificate para reparar los atributos del certificado de usuario de las identidades de máquina unidas a Microsoft Entra híbrido.

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

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

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

   • Para volver a crear completamente el disco de identidad:

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

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

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

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

Cambiar la configuración de red de un catálogo de máquinas existente

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

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

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

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

   $NewNetworkMap = @{"0"= "XDHYP:\HostingUnits\MyNetworks\Network 0.network"}
   <!--NeedCopy-->
   

4. Ejecuta Set-ProvScheme -ProvisioningSchemeName "name" -NetworkMapping $NewNetworkMap.
5. Ejecuta (Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps para verificar la nueva configuración de red del esquema de aprovisionamiento existente.

Administrar versiones de un catálogo de máquinas

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

• Ver la lista de versiones de un catálogo de máquinas.
• Usa cualquier versión anterior para actualizar el catálogo de máquinas.
• Elimina manualmente una versión si no la usa una VM de ese catálogo de máquinas.
• Cambia el número máximo de versiones que debe conservar el catálogo de máquinas (el valor predeterminado es 99).

Una versión incluye la siguiente información de un catálogo de máquinas:

• VMCpuCount
• VMMemoryMB
• CustomProperties
• ServiceOffering
• MachineProfile
• NetworkMapping
• SecurityGroup

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

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

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

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

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

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

   (Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog).Count
   <!--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 usa 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, haz una de las siguientes acciones:

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

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

Después de crear un catálogo no persistente con MCSIO habilitado, puedes 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 MCSIO habilitado

Requisitos

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

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

• Habilita el parámetro UseWriteBackCache para el catálogo de máquinas existente. Usa 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é

Ejecuta 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 porque se requiere al menos 1 GB de almacenamiento en disco de caché.
• El valor de WriteBackCacheMemorySize debe ser inferior al tamaño de la memoria del catálogo de máquinas.
• Estos cambios solo afectan a las nuevas VM agregadas al catálogo después de realizar el cambio. Las VM existentes no se ven afectadas por estos cambios.

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

Puedes 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 basado en un perfil no de máquina en un catálogo de máquinas basado en un perfil de máquina. Las nuevas VM agregadas al catálogo toman los valores de propiedad del perfil de máquina.

Nota:

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

Para ello:

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

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

   • En el caso de Azure:

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

   • En el caso de AWS:

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

   • En el caso de VMware:

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

     Nota:

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

Recuperar advertencias y errores asociados a un catálogo

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

Mediante comandos de PowerShell, puedes:

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

Para ejecutar los comandos de PowerShell:

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

Para obtener una lista de errores y advertencias:

Ejecuta el comando Get-ProvOperationEvent.

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

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

Ejecuta el comando Confirm-ProvOperationEvent.

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

Para quitar los errores o advertencias:

Ejecuta el comando Remove-ProvOperationEvent.

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

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

Quitar máquinas sin acceso al hipervisor

Al quitar una máquina virtual o un esquema de aprovisionamiento, MCS necesita quitar las etiquetas de la máquina virtual 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. Usa la opción PurgeDBOnly en Remove-ProvVM de PowerShell para quitar objetos de recursos de máquinas virtuales como máquinas virtuales, discos base, imágenes en ACG, etc., de la base de datos, incluso cuando no hay acceso al hipervisor.

Esta opción está habilitada en:

• todos los hipervisores compatibles
• máquinas virtuales persistentes y no persistentes

Limitaciones

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

Usar el comando PurgeDBOnly

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

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

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.

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

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

Actualizar propiedades de máquinas virtuales individuales

Puedes actualizar las propiedades de máquinas virtuales individuales en un catálogo de máquinas MCS persistente mediante el comando de PowerShell Set-ProvVM. Sin embargo, las actualizaciones no se aplican de inmediato. Debes establecer la ventana de tiempo mediante el comando de PowerShell Set-ProvVMUpdateTimeWindow para que se apliquen las actualizaciones.

Esta implementación te ayuda a administrar máquinas virtuales individuales de manera eficiente sin actualizar todo el catálogo de máquinas. Actualmente, esta función se aplica a entornos de Azure y VMware.

Actualmente, las propiedades que puedes actualizar son:

• CustomProperties
• ServiceOffering (No aplicable a VMware)
• MachineProfile
• CpuCount
• Memory

Con esta función, puedes:

• Actualizar las propiedades de una máquina virtual
• Conservar las propiedades actualizadas en una máquina virtual después de actualizar el catálogo de máquinas
• Revertir las actualizaciones de configuración aplicadas a una máquina virtual

Antes de actualizar las propiedades de una máquina virtual:

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

3. Comprueba la configuración del catálogo de máquinas existente. Por ejemplo:

   Get-ProvScheme -ProvisioningSchemeName <catalog name>
   <!--NeedCopy-->
   

4. Comprueba la configuración de la máquina virtual en la que quieres aplicar las actualizaciones. Por ejemplo:

   Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1
   <!--NeedCopy-->
   

Actualizar propiedades de una máquina virtual

Haz lo siguiente para actualizar las propiedades de una máquina virtual:

1. Apaga la máquina virtual en la que quieres aplicar las actualizaciones.

2. Actualiza las propiedades de la máquina virtual. Por ejemplo, si quieres actualizar la propiedad personalizada del tipo de almacenamiento (StorageType) de la máquina virtual, ejecuta lo siguiente:

   Set-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1 -CustomProperties "...<Property Name='StorageType' Value='Premium_LRS' />..."
   <!--NeedCopy-->
   

   Puedes actualizar las propiedades de dos máquinas virtuales en un catálogo de máquinas simultáneamente. Por ejemplo:

   Set-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1 -CustomProperties "...<Property Name='StorageType' Value='Premium_LRS' />..."
   <!--NeedCopy-->
   

   Set-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine2 -CustomProperties "...<Property Name='StorageType' Value='StandardSSD_LRS' />..."
   <!--NeedCopy-->
   

   Nota:

   Las actualizaciones no se aplican de inmediato.

3. Obtén la lista de propiedades que se especifican para actualizar y la versión de configuración. Por ejemplo:

   Get-ProvVMConfiguration -ProvisioningSchemeName <catalog name> -VMName machine1
   <!--NeedCopy-->
   

   Comprueba el valor de la propiedad Version y las propiedades que se van a actualizar (en este caso, StorageType).

4. Comprueba la versión de configuración. Por ejemplo:

   Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1
   <!--NeedCopy-->
   

   Comprueba el valor de la propiedad ProvVMConfigurationVersion. La actualización aún no se ha aplicado. La máquina virtual sigue en la configuración antigua.

5. Solicita una actualización programada. Por ejemplo:

    Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName <catalog name> -StartsNow -DurationInMinutes -1
    <!--NeedCopy-->
   

   Para obtener más información sobre las actualizaciones programadas, consulta Actualizar máquinas aprovisionadas al estado actual del esquema de aprovisionamiento.

   Nota:

   También se aplica cualquier actualización pendiente del esquema de aprovisionamiento.

6. Reinicia la máquina virtual. Por ejemplo:

    New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
    <!--NeedCopy-->

1. Comprueba la versión de la configuración. Por ejemplo:

   Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
   <!--NeedCopy-->
   

   Comprueba el valor de la propiedad ProvVMConfigurationVersion. La actualización ya está aplicada. La VM ahora tiene la nueva configuración.

2. Para aplicar más actualizaciones de configuración en la VM, apaga la VM y repite los pasos.

Conservar las propiedades actualizadas en una VM después de actualizar el catálogo de máquinas

Haz lo siguiente para conservar las propiedades actualizadas en una VM:

1. Apaga la VM en la que quieres aplicar las actualizaciones.

2. Actualiza el catálogo de máquinas. Por ejemplo, si quieres cambiar el tamaño de la VM (ServiceOffering) y el tipo de almacenamiento (StorageType), ejecuta lo siguiente:

   Set-ProvScheme -ProvisioningSchemeName <catalog name> -ServiceOffering Standard_E4_v3 -CustomProperties "...<Property Name='StorageType' Value='StandardSSD_LRS' />..."
   <!--NeedCopy-->
   

3. Obtén los detalles de configuración del catálogo de máquinas. Por ejemplo:

   Get-ProvScheme -ProvisioningSchemeName <catalog name>
   <!--NeedCopy-->
   

   Ahora, ProvisioningSchemeVersion se incrementa en uno. El tamaño de la VM y el tipo de almacenamiento también se actualizan.

4. Actualiza las propiedades de la VM. Por ejemplo, proporciona un perfil de máquina a la VM.

   Set-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1 -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\machineprofile.folder\<resource-group>.resourcegroup\<template-spec>.templatespec\<template-spec-version>.templatespecversion"
   <!--NeedCopy-->
   

   Nota:

   La entrada del perfil de máquina tiene una etiqueta y un tamaño de VM (ServiceOffering) diferente especificados.

5. Obtén la lista de propiedades que tendrá la VM después de combinar las actualizaciones de configuración de la VM con las actualizaciones del catálogo de máquinas. Por ejemplo:

   Get-ProvVMConfigurationResultantSet -ProvisioningSchemeName <catalog name> -VMName machine1
   <!--NeedCopy-->
   

   Nota:

   Cualquier actualización en la VM anulará las actualizaciones realizadas en el catálogo de máquinas.

6. Solicita una actualización programada para la VM. Por ejemplo:

   Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName <catalog name> -VMName machine1 -StartsNow -DurationInMinutes -1
   <!--NeedCopy-->
   

7. Reinicia la VM. Por ejemplo:

   New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
   <!--NeedCopy-->
   

   La VM mantiene su tamaño actualizado, derivado del perfil de máquina. Los valores de etiqueta especificados en el perfil de máquina también se aplican a la VM. Sin embargo, el tipo de almacenamiento se deriva del esquema de aprovisionamiento más reciente.

8. Obtén la versión de configuración de la VM. Por ejemplo:

   Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1
   <!--NeedCopy-->
   

   Ahora, ProvisioningSchemeVersion y ProvVMConfigurationVersion muestran la versión más reciente.

Revertir las actualizaciones de configuración aplicadas a una VM

1. Después de aplicar las actualizaciones a una VM, apaga la VM.

2. Ejecuta el siguiente comando para quitar las actualizaciones aplicadas en la VM. Por ejemplo:

   Set-ProvVM -RevertToProvSchemeConfiguration -ProvisioningSchemeName <catalog name> -VMName machine1
   <!--NeedCopy-->
   

3. Solicita una actualización programada para la VM. Por ejemplo:

   Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName <catalog name> -VMName machine1 -StartsNow -DurationInMinutes -1
   <!--NeedCopy-->
   

4. Reinicia la VM. Por ejemplo:

   New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
   <!--NeedCopy-->
   

5. Comprueba la versión de configuración de la VM. Por ejemplo:

    Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1
    <!--NeedCopy-->

El valor de ProvVMConfigurationVersion es ahora la versión de configuración del catálogo de máquinas.

Migración del almacenamiento de máquinas virtuales

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

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

• Para máquinas virtuales persistentes de clonación completa: disco del 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 (WBC).

El nuevo almacenamiento debe cumplir las siguientes condiciones:

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

Migrar el almacenamiento en disco

Para migrar el almacenamiento en disco:

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

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

   Nota:

   Para máquinas virtuales no persistentes:

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

2. Apaga las máquinas virtuales y activa el Modo de mantenimiento.

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

   • Ejecuta ProvResourceInStorage para obtener información del almacenamiento del sistema operativo. Por ejemplo:

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

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

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

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

   Nota:

   • Siempre proporciona los discos del sistema operativo y de identidad en los parámetros DiskType y DestinationStorageId.
   • El DestinationStorageId para el disco del sistema operativo 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 una máquina virtual persistente, todos los discos se mueven. No puedes 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 quieres migrar un disco específico, establece el valor como None para el parámetro DestinationStorageId.
   • Si la máquina virtual tiene un disco WBC, agrega el disco WBC en el parámetro DiskType y agrega la información requerida en el parámetro DestinationStorageId.

Solución de problemas

Si uno de los discos no se migra, ninguno de los discos se migrará al almacenamiento de destino. Puedes obtener el informe de errores usando el siguiente comando:

(Get-ProvTask -TaskID xxxxxxxxx).DiskMoveFailedVirtualMachines

<!--NeedCopy-->

Consideraciones importantes para la migración de máquinas virtuales no persistentes en VMware

• Si intentas mover el disco del sistema operativo y el disco de identidad a un nuevo almacenamiento, los archivos específicos de la máquina virtual también se moverán al nuevo almacenamiento.
• VMware no admite mover el disco si tiene la instantánea.

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

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

Limitaciones

Ten en cuenta las siguientes limitaciones:

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

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

Para migrar, haz lo siguiente:

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

   • Azure:

     • Studio
     • PowerShell

   • VMware:

     • Studio
     • PowerShell

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

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

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

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

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

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

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

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

Solucionar problemas

• Para máquinas con el estado Power State Unknown, consulta CTX131267 para obtener orientación.
• Para solucionar problemas de máquinas virtuales que muestran continuamente un estado de energía desconocido, consulta Cómo solucionar problemas de máquinas virtuales que muestran continuamente un estado de energía desconocido.
• Si un Cloud Connector no funciona correctamente, las operaciones de aprovisionamiento de MCS (como las actualizaciones de catálogo) tardan más de lo habitual y el rendimiento de la consola de administración disminuye significativamente.

Pasos siguientes

Para obtener información sobre cómo administrar catálogos de hipervisores específicos, consulta:

• Administrar un catálogo de AWS
• 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
• Administrar un catálogo de XenServer