Citrix DaaS™

Administrar catálogos de máquinas

May 4, 2026

Contribución de:

C C

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

En el caso de 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.
En el caso de 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 detalles del catálogo
Agregar máquinas a un catálogo
Quitar máquinas de un catálogo
Modificar un catálogo
Cambiar el nombre de un catálogo
Eliminar un catálogo
Administrar cuentas de equipo de Active Directory en un catálogo
Cambiar la imagen maestra de un catálogo
Convertir catálogos aprovisionados por MCS para que usen imágenes preparadas en lugar de imágenes maestras.
Cambiar el nivel funcional o deshacer el cambio
Clonar un catálogo

Ver detalles del catálogo

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

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: Máquina de Machine Creation Services (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 de 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.
Column 1	Column 2
Column 1	Column 2
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. Solo se aplica a los catálogos de máquinas no persistentes. Los valores posibles incluyen: Totalmente actualizado, Parcialmente actualizado, Actualizaciones pendientes, Preparando

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

Solo disponible 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 Acceso con 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.

Workspace Environment Management Solo visible cuando el servicio WEM está aprovisionado y accesible.

^^	^^ Muestra la configuración de optimización del sistema de Workspace Environment Management.
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.

Solución de 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 usas cuentas existentes, el número de máquinas que puedes agregar está limitado por el número de cuentas disponibles.
-  Si usas Studio para crear cuentas de equipo de Active Directory para las máquinas adicionales, debes tener los permisos de administrador de dominio adecuados.

Consejo:

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 Log on to...

Para agregar máquinas a un catálogo:

Desde Studio, selecciona Machine Catalogs en el panel izquierdo.
Selecciona un catálogo de máquinas y, a continuación, selecciona Add machines en la barra de acciones.
En la página Virtual Machines, selecciona el número de máquinas virtuales que quieres agregar.
En la página Machine Identities, 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 usas cuentas de Active Directory existentes, explora las cuentas o selecciona Import 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 administra 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 usado por otros catálogos, no puedes cambiarlo a un grupo diferente usando Studio. En su lugar, usa el cmdlet de PowerShell Set-ProvScheme. Para obtener más información, consulta la Citrix Virtual Apps and Desktops SDK Documentation.
- Especifica un esquema de nombres de cuenta, usando almohadillas para indicar dónde aparecen los 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 cuenta.
  
  Al especificar con qué empiezan los nombres de cuenta, 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, que se implementan mediante MCS, a través de 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 al crear 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. La 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:

Desde Studio, selecciona Catálogos de máquinas en el panel izquierdo.
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.
Selecciona Agregar archivo CSV. Aparece la ventana Agregar máquinas en bloque.
Selecciona Descargar plantilla CSV.
Rellena el archivo de plantilla.
Arrastra o busca el archivo para subirlo.
Selecciona Validar para realizar comprobaciones de validación en tu importación.
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 máquinas virtuales distinguen entre mayúsculas y minúsculas. Al introducir las rutas de las máquinas virtuales, asegúrate de introducir los nombres de las máquinas virtuales correctamente.

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

La 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 autoasignaciones de usuario) o agregar máquinas junto con asignaciones de usuario. 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 máquina virtual 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 máquinas virtuales:
- 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 1.000. Para importar más de 1.000 máquinas, distribúyelas en diferentes archivos y luego impórtalos uno por uno. Te recomendamos que no importes más de 1.000 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:

Desde Studio, selecciona Catálogos de máquinas en el panel izquierdo.
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.
Selecciona Exportar a archivo CSV. Se descarga un archivo CSV que contiene una lista de las máquinas.
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 y aprovisionados por MCS.

La exportación e importación de máquinas en archivos CSV solo es compatible 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:

Inicia sesión en el VDA.
Localiza la herramienta EnrollMachine.exe, en C:\Program Files\Citrix\Virtual Desktop Agent\Web Socket Vda Enrollment Tool.
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:

| Nombre del parámetro | Obligatorio | Descripción | Ejemplo | |–|–|–|–|

-  | `-websocket\_token\_stdin` | Yes | **Lee el token de inscripción.** | `.\EnrollMachine.exe -websocket\_token\_stdin` |

`-websocket\_token\_string`	^^	Lee el token de inscripción directamente del parámetro de la línea de comandos.	`.\EnrollMachine.exe -websocket\_token\_string:<token>`
`-websocket\_token\_file:\[token-file-path]`	^^	Lee el token de inscripción de la ruta proporcionada.	`.\EnrollMachine.exe -websocket\_token\_file:C:\token\test2.txt`
`log:\[log-file-path]`	No	Muestra los registros de la herramienta de inscripción.	`.\EnrollMachine.exe log:\[C:\ProgramData\Citrix\EnrollMachine\EnrollMachine.txt]`

-  | `-help` | No | **Muestra un breve texto de ayuda.** | `.\EnrollMachine.exe -help` |

Tras 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 el estado de la máquina está registrado.

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:

Código	Cadena	Descripción
0	Success	El VDA se ha agregado correctamente al catálogo de máquinas.

-1 InvalidArgument El parámetro de entrada en el token de inscripción no es válido.
-2 BrokerAgentNotFound No se encuentra el servicio del agente de broker.
-3 TokenInvalid El token introducido no es válido.
-4 TokenMissingRequiredClaims Faltan las reclamaciones obligatorias para el token, por ejemplo, CustomerId o URI de inscripción.

-5	InternalError	Se ha producido un error general.
-6	TimedOut	La tarea ha agotado el tiempo.
-7	FailedToDetermineMachineADJoinedStatus	El servicio que devuelve el estado de unión de la máquina a AD falló.
-8	ADMachineFailedToFindSid	El servicio que devuelve el SID de la máquina AD falló.
-9	EnrollRequestFailed	La solicitud falló debido a un error HTTP.
-10	EnrollResponseMissingRequiredFields	A la respuesta de la herramienta de inscripción le falta el parámetro `VirtualSiteId`.
-11	InsufficientPermission	No tienes el permiso necesario para ejecutar la tarea.
-12	FailedToDetermineMachineAadJoinedStatus	El servicio que comprueba el estado de unión de la máquina a AD arroja un error.
-13	AadMachineFailedToFindDeviceId	El parámetro adicional `AAD device id` agregado por el sistema está vacío.
-14	AadDeviceIdNotValid	El parámetro adicional `AAD device id` agregado por el sistema no es un GUID válido.
-15	NoValidMacAddress	Dirección MAC no válida.
-16	FailedToGetComputerHostNameForVdaInstanceName	No se pudo obtener el nombre de host del equipo para establecer el parámetro adicional `VdaInstanceName`.

-17

VirtualDesktopAgentRegistryKeyFailedToOpen

No se pudo abrir la clave de registro del VDA para escribir la lista de Delivery Controllers.

-18 Failed Token reached the max count El token fallido alcanzó el recuento máximo.

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 del usuario estén respaldados o ya no sean necesarios.
Todos los usuarios hayan cerrado sesión. Activar el modo de mantenimiento impide que se realicen nuevas conexiones a una máquina.
Las máquinas estén apagadas.

Para quitar máquinas de un catálogo:

En Studio, selecciona Catálogos de máquinas en el panel izquierdo.
Selecciona un catálogo y, a continuación, selecciona Ver máquinas en la barra de acciones.
Selecciona una o varias máquinas y, a continuación, selecciona Quitar en la barra de acciones.
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 eliminar 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

En Studio, selecciona Catálogos de máquinas en el panel izquierdo.
Selecciona un catálogo y, a continuación, selecciona Modificar catálogo de máquinas en la barra de acciones.
En la página Ámbitos, cambia los ámbitos.
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.
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.
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 máquinas virtuales.
- 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 grupo de host dedicado) En la página Grupo de host dedicado, elige si quieres cambiar un grupo de host.
- 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 máquina. Si eliges continuar, aparecerá un punto rojo junto al menú Máquinas virtuales, lo que te pedirá 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 de 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 de Unidades organizativas, agrega o quita UO de Active Directory.
1. En la página de Descripción, cambia la descripción del catálogo.
1. Haz clic en Aplicar para aplicar los cambios que hiciste y haz clic en Guardar para salir.

Cambiar el nombre de un catálogo

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

1. 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 ningún grupo de entrega. En otras palabras, el grupo de entrega no contiene máquinas del catálogo.

Para eliminar un catálogo:

-  1.  Desde Studio, selecciona **Catálogos de máquinas** en el panel izquierdo.
-  1.  Selecciona un catálogo y, a continuación, selecciona **Eliminar catálogo de máquinas** en la barra de acciones.
-  1.  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, inhabilitar o eliminar sus cuentas de equipo de Active Directory.

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 multisesión. Esas cuentas se pueden usar 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:

Desde Studio, selecciona Catálogos de máquinas en el panel izquierdo.
Selecciona un catálogo y, a continuación, selecciona Administrar cuentas de AD en la barra de acciones.
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.

Puedes 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 importen. Si eliminas una cuenta, elige si la cuenta de Active Directory se debe conservar, inhabilitar o eliminar.

También puedes indicar si las cuentas de Active Directory se deben conservar, inhabilitar 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 encuentran problemas con la nueva imagen que implementaste en sus escritorios, puedes revertirla a la versión anterior, lo que minimiza 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 con la nueva imagen. No implementamos la nueva imagen en las máquinas existentes del catálogo.

Después de actualizar una máquina, esta 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:

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.
En la página Imagen, selecciona una imagen preparada.
En la página Estrategia de implementación, selecciona cuándo quieres actualizar este catálogo con la imagen preparada seleccionada.
En la página Resumen, verifica los detalles y haz clic en Finalizar.
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 nueva.

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.
Si es necesario, enciende la imagen e inicia sesión.
Instala actualizaciones o realiza los cambios necesarios en la imagen.
Si la imagen usa un vDisk personal, actualiza el inventario.
Apaga la VM.
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 mediante la interfaz de administración, te recomendamos que crees una instantánea mediante 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 XenServer XenCenter®.

Cambiar la imagen maestra

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

Desde Studio, selecciona Catálogos de máquinas en el panel izquierdo.
Selecciona un catálogo y, a continuación, selecciona Cambiar imagen maestra en la barra de acciones.
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.

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.

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, busca 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.

Consejo:

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

Selecciona un catálogo de Azure y luego selecciona Cambiar imagen maestra en la barra de acciones.
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, 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 se aplica a las máquinas virtuales no persistentes.

Ten en cuenta lo siguiente:

No se pueden iniciar nuevas sesiones hasta que la actualización se haya completado en las máquinas aplicables.
Para máquinas de sesión única, las máquinas se actualizan inmediatamente cuando la máquina no está en uso o cuando los usuarios no han iniciado sesión.
Para un 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.

Consejo: > > Limita el número de máquinas que se reinician utilizando la configuración avanzada para una conexión de host. Usa 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 restauran a la última imagen que funcionaba. Cualquier característica nueva 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.
1. Selecciona el catálogo y luego selecciona Revertir imagen maestra en la barra de acciones.
  - 1. 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 restauradas. 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, busca 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. Te recomendamos actualizar todos los VDA a la última versión para habilitar el acceso a todas las características 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:

Desde Studio, selecciona Catálogos de máquinas en el panel izquierdo. - 1. Selecciona el catálogo. La ficha Detalles del panel inferior muestra la información de la versión.
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 VDA anteriores seleccionando el catálogo y luego 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 al [sistema operativo](/es-es/citrix-daas/install-configure/machine-catalogs-create.html#operating-system) y a la [administración de máquinas](/es-es/citrix-daas/install-configure/machine-catalogs-create.html#machine-management). 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 tardar un tiempo en completarse. 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](/es-es/citrix-daas/install-configure/machine-catalogs-manage.html#rename-a-catalog).

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.

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

Organizar catálogos mediante 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 de la organización.

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

De forma predeterminada, necesitas tener el siguiente rol integrado para crear y administrar carpetas de catálogos: 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álogos. 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 distintos nodos.

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

-  Ejemplo:

```powershell
Set-BrokerAdminFolderMetadata -AdminFolderId {adminFolderUid} -Name ContainsMachineCatalogs -Value true

<!--NeedCopy--> ```

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

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

Sugerencia:

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:

En Studio, selecciona Catálogos de máquinas en el panel izquierdo.
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.
Haz clic con el botón derecho en un catálogo y, a continuación, selecciona Mover catálogo de máquinas.
Selecciona la carpeta a la que quieres mover el catálogo y, a continuación, haz clic en Listo.

Sugerencia:

Puedes arrastrar un catálogo a una carpeta.

Administrar carpetas de catálogos

    -  Puedes eliminar, renombrar y mover carpetas de catálogos.

    -  Puedes eliminar una carpeta solo si esta y sus subcarpetas no contienen catálogos.

Para administrar una carpeta, sigue estos pasos:

En Studio, selecciona Catálogos de máquinas en el panel izquierdo.
En la jerarquía de carpetas, selecciona una carpeta y, a continuación, selecciona una acción en la barra de Acciones según sea necesario:
- Para renombrar la carpeta, selecciona Renombrar carpeta.
- Para eliminar la carpeta, selecciona Eliminar carpeta.
- Para mover la carpeta, selecciona Mover carpeta.
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álogos.

Acción	Permisos necesarios
Crear carpetas de catálogos	Crear carpeta de catálogo de máquinas
Eliminar carpetas de catálogos	Quitar carpeta de catálogo de máquinas
Mover carpetas de catálogos	Mover carpeta de catálogo de máquinas
Renombrar carpetas de catálogos	Modificar carpeta de catálogo de máquinas
Mover catálogos a carpetas	Modificar carpeta de catálogo de máquinas y Modificar propiedades de catálogo de máquinas

Actualizar VDA

Puedes usar la interfaz de Studio para actualizar los VDA fácilmente. 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 la 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

De forma predeterminada, 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 total
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 la 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 del catálogo

Nota:

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

Los catálogos con errores 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 al sistema operativo y a la administración de máquinas. El catálogo hereda esa configuración del original.
- La creación puede tardar algún 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:

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

(Solo 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 la 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:

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.
Haz clic con el botón derecho en el catálogo y, a continuación, selecciona Administrar tokens de inscripción.
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 superar los 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).
Haz clic en Generar.
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.

A token record appears in the token list.
Comparte el token con los administradores de la 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 mantiene en la lista para fines de registro.
Eliminar: Revoca el token y lo elimina de la lista.

Nota:

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

Usar PowerShell

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

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:

Abre PowerShell como administrador en el Delivery Controller.
Ejecuta el comando asnp citrix\* para cargar los módulos de Citrix.
Ejecuta el siguiente comando para comprobar el recuento inicial del grupo de identidades del catálogo:

Get-AcctIdentityPool -IdentityPoolName xxx
El IdentityPoolName es el nombre del catálogo.

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

Set-AcctIdentityPool -IdentityPoolName xxx -StartCount X

Agrega las máquinas al catálogo para que se creen con el recuento requerido.
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 del 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 máquina virtual 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 el comando de PowerShell correctamente, asegúrate de que:
Las máquinas virtuales 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 existen, y que el esquema de aprovisionamiento tiene entradas correctas.
El hipervisor no esté en modo de mantenimiento.
Las máquinas virtuales de destino estén apagadas y en modo de mantenimiento.

Realiza los siguientes pasos para restablecer el disco del SO:

Abre una ventana de PowerShell.
Ejecuta asnp citrix* para cargar los módulos de PowerShell específicos de Citrix.
Ejecuta el comando de PowerShell Reset-ProvVMDisk de cualquiera de las siguientes maneras:
- Especifica la lista de máquinas virtuales como una lista separada por comas y realiza el restablecimiento en cada máquina virtual:
```
 Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName ("abc","def") -OS

 
```
- Especifica la lista de máquinas virtuales como una salida del comando Get-ProvVM y realiza el restablecimiento en cada máquina virtual:
```
 (Get-ProvVM -ProvisioningSchemeName "xxx") | Reset-ProvVMDisk "abc" -OS

 
```
  - Especifica una sola máquina virtual por nombre:
```
 Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS

 
```
  - Crea tareas de restablecimiento separadas para cada una de las máquinas virtuales devueltas por el comando Get-ProvVM. Esto es menos eficiente porque cada tarea realizará las mismas comprobaciones redundantes, como la comprobación de capacidad del hipervisor y la comprobación de conexión para cada máquina virtual.
```
 Get-ProvVM -ProvisioningSchemeName "xxx" | Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -OS

 
```
Aparece un mensaje de confirmación que enumera las máquinas virtuales que se van a restablecer junto con un mensaje de advertencia de que es una operación irrecuperable. Si no proporcionas una respuesta y pulsas 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 ejecutar la acción.

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

 
```
  - Proporciona el parámetro -Confirm:$false:
```
 Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Confirm:$false

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

 
```
Nota:

No saques las máquinas virtuales del modo de mantenimiento ni las enciendas hasta que se complete el proceso de restablecimiento.
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 elegir restablecer solo la contraseña de la máquina y las claves de confianza, o restablecer toda la configuración del disco de identidad. Esta implementación es aplicable a los catálogos de máquinas MCS persistentes y no persistentes.

Nota:

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

Condiciones

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

Apaga y configura 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:

Abre la ventana de PowerShell.
Ejecuta asnp citrix* para cargar los módulos de PowerShell específicos de Citrix.
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

 
```
  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/clave de confianza de la cuenta, 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 siguiente orden:
```
 Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo

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

 
```
- Para recrear completamente el disco de identidad:
```
 Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMname <name> -Identity -Recreate

 
```
  Nota:
  
  Si la máquina está en una versión de VDA 2511 (Actualización 1) o posterior y tiene la clave de registro configurada para habilitar un MachineGuid único (HKLM:\Software\Citrix\MachineIdentityServiceAgent\EnableUniqueMachineGuid), seguirá utilizando el mismo MachineGuid que antes, independientemente de la configuración de -Recreate.
Escribe y para confirmar la acción. También puedes omitir el mensaje de confirmación utilizando el parámetro -Force. Por ejemplo:
```
Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMName <name> -Identity -Force


```
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. Utiliza 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:

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

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

$NewNetworkMap = @{"0"= "XDHYP:\HostingUnits\MyNetworks\Network 0.network"}

<!--NeedCopy-->

Ejecuta Set-ProvScheme -ProvisioningSchemeName "name" -NetworkMapping $NewNetworkMap.
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. Entonces puedes gestionar 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.
Usar cualquier versión anterior para actualizar el catálogo de máquinas.
Quitar manualmente una versión si no la usa ninguna 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

Ejecuta los siguientes comandos (proporcionados como ejemplos) para gestionar 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

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

 
```

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 quitar manualmente una versión si no la usa ninguna máquina virtual de ese catálogo de máquinas:
```
 Remove-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 3

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

 
```

Si el número de versiones alcanza el número máximo de versiones, no se puede crear una nueva versión si las versiones anteriores están en uso por alguna de las máquinas virtuales 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 máquinas virtuales que están en versiones anteriores para que esas versiones anteriores ya no sean referenciadas por ninguna máquina virtual y puedan quitarse.

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 característica es actualmente aplicable a:
Entornos de GCP y Microsoft Azure, y
un catálogo no persistente con MCSIO habilitado

Requisitos

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

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 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 máquinas virtuales agregadas al catálogo después de realizar el cambio. Las máquinas virtuales existentes no se ven afectadas por estos cambios.

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

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

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

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

Ejecuta el comando Set-ProvScheme para aplicar los valores de las propiedades 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 el FolderID como propiedad personalizada para evitar derivar el 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 de tu catálogo de máquinas MCS y solucionarlos.

Con los comandos de PowerShell, puedes:

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

Para ejecutar los comandos de PowerShell:

Abre una ventana de PowerShell.
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 las advertencias
Con los parámetros LinkedObjectType y LinkedObjectUid: Obtiene todos los errores y las advertencias asociados a un esquema de aprovisionamiento específico
Con el parámetro EventId: Obtiene un error o una advertencia específicos que coincidan 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 las advertencias de Nuevo a Reconocido:

Ejecuta el comando Confirm-ProvOperationEvent.

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

Para eliminar los errores o las advertencias:

Ejecuta el comando Remove-ProvOperationEvent.

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

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

Eliminar máquinas sin acceso al hipervisor

Al eliminar 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 eliminar objetos de recursos de máquinas virtuales, como la máquina virtual, el disco base, la imagen en ACG, etc., de la base de datos incluso cuando no haya acceso al hipervisor.

Esta opción está habilitada en:

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

Limitaciones

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

Usa el comando PurgeDBOnly

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

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

Nota:

Remove-provVM -ForgetVM solo afecta a las máquinas virtuales persistentes. Si una de las máquinas virtuales de la lista no es no 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 el período 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 tener que actualizar todo el catálogo de máquinas. Actualmente, esta función es aplicable 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:

Abre una ventana de PowerShell.
Ejecuta asnp citrix* para cargar los módulos de PowerShell específicos de Citrix.
Comprueba la configuración del catálogo de máquinas existente. Por ejemplo:
```
Get-ProvScheme -ProvisioningSchemeName <catalog name>


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


```

Actualizar las propiedades de una máquina virtual

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

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

Actualiza las propiedades de la máquina virtual. Por ejemplo, si quieres actualizar la propiedad personalizada de 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.

Obtén la lista de propiedades que se van a actualizar y la versión de configuración. Por ejemplo:
```
Get-ProvVMConfiguration -ProvisioningSchemeName <catalog name> -VMName machine1


```
Comprueba el valor de la propiedad Version y las propiedades que se van a actualizar (en este caso, StorageType).
Comprueba la versión de configuración. Por ejemplo:
```
Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1


```
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.
Solicita una actualización programada. Por ejemplo:
```
 Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName <catalog name> -StartsNow -DurationInMinutes -1

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

Reinicia la VM. Por ejemplo:

New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn

<!--NeedCopy-->

Comprueba la versión de la configuración. Por ejemplo:
```
Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1


```
Comprueba el valor de la propiedad ProvVMConfigurationVersion. La actualización ya está aplicada. La VM ahora tiene la nueva configuración.
Para aplicar más actualizaciones de configuración en la VM, apaga la VM y repite los pasos.

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

Apaga la VM en la que quieres aplicar las actualizaciones.

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

Obtén los detalles de la configuración del catálogo de máquinas. Por ejemplo:
```
Get-ProvScheme -ProvisioningSchemeName <catalog name>


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

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

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


```
Nota:

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

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

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

<!--NeedCopy-->

Reinicia la VM. Por ejemplo:
```
New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn


```
La VM mantiene su tamaño de VM actualizado, tal como se deriva 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.
Obtén la versión de configuración de la VM. Por ejemplo:
```
Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1


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

Revertir las actualizaciones de configuración aplicadas a una VM

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

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

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

<!--NeedCopy-->

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

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

<!--NeedCopy-->

Reinicia la VM. Por ejemplo:

New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn

<!--NeedCopy-->

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

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

Puedes migrar VM persistentes de clonación completa y VM no persistentes.

Para VM persistentes de clonación completa: disco del SO, disco de identidad y discos no aprovisionados por MCS.
Para VM no persistentes: disco del SO, 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 VM debe tener acceso tanto a los almacenes de datos antiguos como a los nuevos.

Migrar el almacenamiento en disco

Para migrar el almacenamiento en disco:

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 VM al almacenamiento antiguo, cambia el almacenamiento antiguo a Sustituido. Puedes hacerlo mediante 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 VM en el almacenamiento antiguo.

Nota:

Para VM no persistentes:

Si se usa WBC, configura el almacenamiento de destino de WBC en la unidad de alojamiento.

Si el almacenamiento de destino del SO está configurado, WBC (si se usa) debe ser compatible con el almacenamiento de destino del SO.

Si el almacenamiento de destino del SO no está configurado, WBC (si se usa) debe ser compatible con el almacenamiento actual del SO.

Apaga las VM y activa el Modo de mantenimiento.
Obtén la información sobre el esquema de aprovisionamiento, la unidad de alojamiento, el almacenamiento en disco del SO y el almacenamiento en disco de WBC.
- Ejecuta ProvResourceInStorage para obtener información del almacenamiento del SO. Por ejemplo:
```
 $result=Get-ProvSchemeResourceInStorage -ProvisioningSchemeName xxxxx
 $result
 $result.ProvResourceInStorage | Format-List -Property *

 
```
- Ejecuta TemporaryStorageInfo para obtener información del almacenamiento de WBC. Por ejemplo:
```
 $result=Get-ProvSchemeResourceInStorage -ProvisioningSchemeName xxxxx
 $result
 $result.TemporaryStorageInfo | Format-List -Property *

 
```
Migra el disco del SO, el disco de identidad y el disco de WBC (aplicable a VM no persistentes) al almacenamiento de destino usando el comando de PowerShell Move-ProvVMDisk.
Nota:
- Proporciona siempre los discos del SO y de identidad en los parámetros DiskType y DestinationStorageId.
- El DestinationStorageId para el disco del SO y el disco de identidad debe ser el mismo.

Ejemplo:

VM persistentes:

```

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

<!--NeedCopy--> ```

> **Importante:**
>
> Para una VM persistente, se mueven todos los discos. No puedes seleccionar qué discos mover.

VM 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 VM 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 migra 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 VM no persistentes en VMware

Si intentas mover el disco del SO y el disco de identidad a un nuevo almacenamiento, los archivos específicos de la VM también se mueven 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 de imagen preparada

Puedes convertir un catálogo de máquinas aprovisionado por MCS existente en un catálogo de máquinas con imagen preparada mediante 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 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, el catálogo no se puede migrar para usar una imagen preparada.
Si el catálogo de MCS utiliza discos no administrados, el catálogo no se puede migrar para usar una imagen preparada.

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

Para migrar, haz lo siguiente:

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

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

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

<!--NeedCopy-->

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


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


```

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

Solución de 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 se degrada significativamente.

Pasos siguientes

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

La versión oficial de este contenido está en inglés. Para mayor comodidad, parte del contenido de la documentación de Cloud Software Group solo tiene traducción automática. Cloud Software Group no puede controlar el contenido con traducción automática, que puede contener errores, imprecisiones o un lenguaje inadecuado. No se ofrece ninguna garantía, ni implícita ni explícita, en cuanto a la exactitud, la fiabilidad, la idoneidad o la precisión de las traducciones realizadas del original en inglés a cualquier otro idioma, o que su producto o servicio de Cloud Software Group se ajusten a cualquier contenido con traducción automática, y cualquier garantía provista bajo el contrato de licencia del usuario final o las condiciones de servicio, o cualquier otro contrato con Cloud Software Group, de que el producto o el servicio se ajusten a la documentación no se aplicará en cuanto dicha documentación se ha traducido automáticamente. Cloud Software Group no se hace responsable de los daños o los problemas que puedan surgir del uso del contenido traducido automáticamente.

¿Le ha resultado útil?

Administrar catálogos de máquinas

May 4, 2026

Contribución de:

C C

May 4, 2026

Contribución de:

C C

En este artículo

Introducción
Acerca de las instancias persistentes
Administrar catálogos de máquinas
Usar Studio
Ver detalles del catálogo
Agregar máquinas a un catálogo
Quitar máquinas de un catálogo
Modificar un catálogo
Cambiar el nombre de un catálogo
Eliminar un catálogo
Administrar 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 aprovisionados sin Citrix) Generar y administrar tokens de inscripción
Usar PowerShell
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 perfil no de máquina a un catálogo de máquinas basado en perfil de máquina
Recuperar advertencias y errores asociados a un catálogo
Eliminar máquinas sin acceso al hipervisor
Actualizar propiedades de máquinas virtuales individuales
Migración del almacenamiento de las VM
Migrar catálogos aprovisionados por MCS existentes a un catálogo de máquinas de imagen preparada
Solución de problemas
Pasos siguientes

¿Le ha resultado útil?