Citrix DaaS™

Gestionar un catálogo de VMware

March 25, 2026

Contribución de:

C C

Gestionar catálogos de máquinas describe los asistentes que gestionan un catálogo de máquinas. La siguiente información cubre detalles específicos de los entornos de virtualización de VMware.

Nota:

Antes de gestionar un catálogo de VMware, debes terminar de crear uno. Consulta Crear un catálogo de VMware.

Actualizar las máquinas virtuales aprovisionadas al estado actual del esquema de aprovisionamiento

El comando Set-ProvScheme cambia el esquema de aprovisionamiento. Sin embargo, no afecta a las máquinas virtuales existentes. Con el comando de PowerShell Set-ProvVMUpdateTimeWindow, puedes aplicar el esquema de aprovisionamiento actual a una máquina virtual persistente o no persistente existente, o a un conjunto de máquinas virtuales. Esta función es aplicable a catálogos de máquinas basados en perfiles de máquina y no basados en perfiles de máquina.

Puedes actualizar lo siguiente:

VMCpuCount: Propiedad del esquema de aprovisionamiento
VMMemoryMB: Propiedad del esquema de aprovisionamiento
ID de carpeta: Propiedad personalizada
Asignación de subred: Propiedad del esquema de aprovisionamiento
Versión de hardware de la máquina virtual: Solo para catálogos de máquinas basados en perfiles de máquina
Perfil de máquina: Solo para catálogos de máquinas basados en perfiles de máquina

Puedes actualizar:

Una sola máquina virtual
Una lista de máquinas virtuales específicas o todas las máquinas virtuales existentes asociadas a un ID de esquema de aprovisionamiento
Una lista de máquinas virtuales específicas o todas las máquinas virtuales existentes asociadas a un nombre de esquema de aprovisionamiento (nombre del catálogo de máquinas)

Antes de actualizar las máquinas virtuales existentes

Comprueba la configuración de las máquinas virtuales existentes. Por ejemplo:

Get-ProvScheme | select ProvisioningSchemeName, ProvisioningSchemeVersion
<!--NeedCopy-->

Actualiza el esquema de aprovisionamiento. Por ejemplo:

$customProperties=<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><Property xsi:type="StringProperty" Name="FolderId" Value="FOLDER_ID"/></CustomProperties>
$memoryMb=<DOUBLE THE "UPDATE" MACHINE PROFILE>
Set-ProvScheme -ProvisioningSchemeName my-catalog -VMCpuCount 4 -VmMemoryMb $memoryMb -CustomProperties $customerProperties -NetworkMapping @{"1" = "<A_NETWORK_PATH_FROM_THE_HOSTING_UNIT>"} -MachineProfile "<PATH_TO_UPDATE_MACHINE_PROFILE>"
<!--NeedCopy-->

Comprueba si la propiedad actual de la máquina virtual coincide con el esquema de aprovisionamiento actual y si hay alguna acción de actualización pendiente en la máquina virtual. Por ejemplo:
```
Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion

```
También puedes encontrar máquinas virtuales con una versión específica. Por ejemplo:
```
Get-ProvVM -Filter "ProvisioningSchemeVersion -eq 1" | select VMName, ProvisioningSchemeVersion

```

Solicitar actualizaciones para que las máquinas virtuales existentes se apliquen en el siguiente reinicio

Ejecuta los siguientes comandos para actualizar las máquinas virtuales existentes y que las actualizaciones se apliquen en el siguiente reinicio.
- Para actualizar todas las máquinas virtuales existentes. Por ejemplo:
```
 Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
 
```
- Para actualizar una lista de máquinas virtuales específicas. Por ejemplo:
```
 Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -VMName <List-Of-Vm-Names> -StartsNow -DurationInMinutes -1
 
```
- Para actualizar máquinas virtuales según la salida de Get-ProvVM. Por ejemplo:
```
Get-ProvVM -ProvisioningSchemeName "my-catalog" | Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
 
```
Nota:
- El parámetro StartsNow indica que la hora de inicio programada es la hora actual.
- El parámetro DurationInMinutes con un número negativo (por ejemplo, –1) indica que no hay un límite superior en la ventana de tiempo de la programación.

Encuentra las máquinas virtuales con una actualización programada. Por ejemplo:

Get-ProvVM -Filter "ProvisioningSchemeUpdateAfter" | select VMName, ProvisioningSchemeUpdateAfter
<!--NeedCopy-->

Reinicia las máquinas virtuales. En el siguiente encendido, los cambios de propiedad se aplican a las máquinas virtuales existentes. Puedes comprobar el estado actualizado con el siguiente comando. Por ejemplo:
```
Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion

```

Cancelar la actualización de la configuración

También puedes cancelar una actualización de configuración de una sola máquina virtual, de varias máquinas virtuales o de un catálogo completo. Para cancelar una actualización de configuración:

Ejecuta Clear-ProvVMUpdateTimeWindow. Por ejemplo:
- Para cancelar la actualización de configuración programada para una sola máquina virtual:
```
 Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName “ my-catalog “ -VMName “vm1”
 
```
- Para cancelar la actualización de configuración programada para varias máquinas virtuales:
```
 Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName "my-catalog" -VMName "vm1","vm2"
 
```
  Nota:
  
  Las máquinas virtuales deben pertenecer al mismo catálogo.

Actualizar el ID de carpeta de un catálogo de máquinas

Puedes actualizar el ID de carpeta de un catálogo de máquinas MCS especificando el FolderId en las propiedades personalizadas del comando Set-ProvScheme. Las máquinas virtuales creadas después de actualizar el ID de carpeta se crean bajo este nuevo ID de carpeta. Si esta propiedad no se especifica en CustomProperties, las máquinas virtuales se crean en la carpeta donde se encuentra la imagen maestra.

Sigue estos pasos para actualizar el ID de carpeta de un catálogo de máquinas.

Abre un explorador web e introduce la URL del vSphere Web Client.
Introduce las credenciales y haz clic en Iniciar sesión.
Crea una carpeta de ubicación de máquinas virtuales en vSphere Web Client.
Abre una ventana de PowerShell.
Ejecuta asnp citrix®* para cargar los módulos de PowerShell específicos de Citrix.

Especifica el FolderID en las CustomProperties de Set-ProvScheme. En este ejemplo, el valor del ID de carpeta es group-v2406.

Set-ProvScheme -ProvisioningSchemeUid "50bb319c-2e83-4a37-9ea1-94f630687372" -CustomProperties "<CustomProperties xmlns=""http://schemas.citrix.com/2014/xd/machinecreation"" xmlns:xsi=""http://www.w3.org/2001/XMLSchema-instance""><Property xsi:type=""StringProperty"" Name=""FolderId"" Value=""group-v2406"" /></CustomProperties>"
<!--NeedCopy-->

Agrega una máquina virtual al catálogo de máquinas mediante Studio.
Comprueba la nueva máquina virtual en vSphere Web Client. La nueva máquina virtual se crea en la nueva carpeta.

Encontrar el ID de carpeta mediante comandos de PowerShell

Usa el comando de PowerShell Get-HypConfigurationDataForItem para encontrar el ID de carpeta de una carpeta existente en un hipervisor de VMware.

Crea una conexión de alojamiento y un grupo de recursos para un hipervisor de VMware. Luego, sigue estos pasos para encontrar el ID de carpeta de una carpeta en ese hipervisor.

Determina la ruta XDHyp a la raíz del árbol de carpetas de máquinas virtuales. Por ejemplo:
```
XDHyp:\Connections\VMwareConn\Datacenter.datacenter

```

Usa Get-HypConfigurationDataForItem para recuperar la estructura del árbol. Por ejemplo:

Get-HypConfigurationDataForItem -LiteralPath XDHyp:\Connections\VMwareConn\Datacenter.datacenter
<!--NeedCopy-->

Ejecuta el siguiente comando para identificar el ID de carpeta a partir del XML de salida. En este ejemplo, busca el ID de carpeta de ExampleFolder en la salida XML.

$result = Get-HypConfigurationDataForItem -LiteralPath XDHyp:\Connections\VMwareConn\Datacenter.datacenter
$result.VmPlacementFolder
<!--NeedCopy-->

Salida XML:

<?xml version="1.0" encoding="utf-16"?>
<CtxVmPlacementFolder xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Name>vm</Name>
<Id>group-v4</Id>
<SubFolder>
<CtxVmPlacementFolder>
  <Name>vCLS</Name>
  <Id>group-v75</Id>
  <SubFolder />
</CtxVmPlacementFolder>
<CtxVmPlacementFolder>
  <Name>MyOtherFolder</Name>
  <Id>group-v1110</Id>
  <SubFolder />
</CtxVmPlacementFolder>
<CtxVmPlacementFolder>
  <Name>ExampleFolder</Name>
  <Id>group-v4658</Id>
  <SubFolder />
</CtxVmPlacementFolder>
</SubFolder>
</CtxVmPlacementFolder>
<!--NeedCopy-->

Encontrar el ID de carpeta en vSphere

Accede al MOB en cualquier sistema de servidor ESXi o vCenter para encontrar el ID de carpeta de las máquinas virtuales.

El Managed Object Browser (MOB) es una aplicación de servidor basada en web disponible de forma integrada en todos los sistemas de servidor ESX/ESXi y vCenter. Esta utilidad de vSphere te permite ver información detallada sobre objetos como máquinas virtuales, almacenes de datos y grupos de recursos.

Abre un explorador web e introduce http://x.x.x.x/mob, donde x.x.x.x es la dirección IP del servidor vCenter o del host ESX/ESXi. Por ejemplo, https://10.60.4.70/mob.
En la página Inicio del MOB, haz clic en el valor de la propiedad content.
Haz clic en el valor de rootFolder.
Haz clic en el valor de childEntity.
Haz clic en el valor de vmFolder.
Puedes encontrar el ID de carpeta en el valor de childEntity.

Identificar recursos creados por MCS

A continuación, se muestran las etiquetas que MCS agrega a los recursos en la plataforma VMware. Las etiquetas de la tabla se representan como “clave”:”valor”.

Nombre del recurso	Etiqueta
Máquina virtual de preparación	“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	“XdConfig:”XdProvisioned=True”
Máquina virtual en el catálogo	“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	“XdConfig:”XdProvisioned=True”

Más información

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?

Gestionar un catálogo de VMware

March 25, 2026

Contribución de:

C C

March 25, 2026

Contribución de:

C C

En este artículo

Actualizar las máquinas virtuales aprovisionadas al estado actual del esquema de aprovisionamiento
Actualizar el ID de carpeta de un catálogo de máquinas
Identificar recursos creados por MCS
Más información

¿Le ha resultado útil?