Administrar un catálogo de VMware

Last published : Nov 03, 2026
Administrar catálogos de máquinas describe los asistentes que administran 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 administrar un catálogo de VMware, debe terminar de crear un catálogo de VMware. Consulte 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, puede 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.
Puede actualizar lo siguiente:
  • VMCpuCount: Propiedad del esquema de aprovisionamiento
  • VMMemoryMB: Propiedad del esquema de aprovisionamiento
  • Folder ID: 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
Puede 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 de catálogo de máquinas)

Antes de actualizar las máquinas virtuales existentes

  1. Compruebe la configuración de las máquinas virtuales existentes. Por ejemplo:
    Get-ProvScheme | select ProvisioningSchemeName, ProvisioningSchemeVersion
  2. Actualice 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>"
  3. Compruebe 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 puede encontrar máquinas virtuales con una versión específica. Por ejemplo:
    Get-ProvVM -Filter "ProvisioningSchemeVersion -eq 1" | select VMName, ProvisioningSchemeVersion

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

  1. Ejecute 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 StartsNow indica que la hora de inicio programada es la hora actual.
    • El DurationInMinutes con un número negativo (por ejemplo, –1) indica que no hay límite superior en la ventana de tiempo de la programación.
  2. Buscar máquinas virtuales con una actualización programada. Por ejemplo:
    Get-ProvVM -Filter "ProvisioningSchemeUpdateAfter" | select VMName, ProvisioningSchemeUpdateAfter
  3. Reinicie las máquinas virtuales. En el siguiente encendido, los cambios de propiedades se aplican a las máquinas virtuales existentes. Puede comprobar el estado actualizado mediante el siguiente comando. Por ejemplo:
    Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion

Cancelar la actualización de la configuración

También puede 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:
  1. Ejecute 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 ser del mismo catálogo.

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

Puede actualizar el ID de carpeta de un catálogo de máquinas MCS especificando 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 bajo la carpeta donde se encuentra la imagen maestra.
Siga estos pasos para actualizar el ID de carpeta de un catálogo de máquinas.
  1. Abra un explorador web e introduzca la URL del vSphere Web Client.
  2. Introduzca las credenciales y haga clic en Iniciar sesión.
  3. Cree una carpeta de ubicación de máquinas virtuales en vSphere Web Client.
  4. Abra una ventana de PowerShell.
  5. Ejecute asnp citrix®* para cargar los módulos de PowerShell específicos de Citrix.
  6. Especifique el FolderID en el 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>"
  7. Agregue una VM al catálogo de máquinas mediante Studio.
  8. Compruebe la nueva VM en vSphere Web Client. La nueva VM se crea en la nueva carpeta.

Buscar el ID de carpeta mediante comandos de PowerShell

Utilice el comando de PowerShell Get-HypConfigurationDataForItem para buscar el ID de carpeta de una carpeta existente en un hipervisor de VMware.
Cree una conexión de alojamiento y un grupo de recursos para un hipervisor de VMware. A continuación, siga estos pasos para buscar el ID de carpeta de una carpeta en ese hipervisor.
  1. Determine la ruta XDHyp a la raíz del árbol de carpetas de VM. Por ejemplo:
    XDHyp:\Connections\VMwareConn\Datacenter.datacenter
  2. Utilice Get-HypConfigurationDataForItem para recuperar la estructura de árbol. Por ejemplo:
    Get-HypConfigurationDataForItem -LiteralPath XDHyp:\Connections\VMwareConn\Datacenter.datacenter
  3. Ejecute el siguiente comando para identificar el ID de carpeta del XML de salida. En este ejemplo, busque el ID de carpeta de ExampleFolder en la salida XML.
    $result = Get-HypConfigurationDataForItem -LiteralPath XDHyp:\Connections\VMwareConn\Datacenter.datacenter
    $result.VmPlacementFolder
    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>

Buscar el ID de carpeta en vSphere

Acceda al MOB en cualquier sistema de servidor ESXi o vCenter para buscar el ID de carpeta de las VM.
El Explorador de objetos administrados (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 le permite ver información detallada sobre objetos como VM, almacenes de datos y grupos de recursos.
  1. Abra un navegador web e introduzca 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>.
  2. En la página Inicio de MOB, haga clic en el valor de la propiedad content.
  3. Haga clic en el valor de rootFolder.
  4. Haga clic en el valor de childEntity.
  5. Haga clic en el valor de vmFolder.
  6. Puede encontrar el ID de la carpeta en el valor de childEntity.

Identificar los recursos creados por MCS

A continuación, se muestran las etiquetas que MCS añade a los recursos en la plataforma VMware. Las etiquetas de la tabla se representan como "clave":"valor".
Nombre del recurso Etiqueta
VM de preparación "CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
"XdConfig:"XdProvisioned=True"
VM en el catálogo "CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
"XdConfig:"XdProvisioned=True"

Más información