VMware-Katalog verwalten

Last published : Nov 03, 2026
(/de-de/citrix-daas/install-configure/machine-catalogs-manage.html) beschreibt die Assistenten zur Verwaltung eines Maschinenkatalogs. Die folgenden Informationen behandeln Details, die spezifisch für VMware-Virtualisierungsumgebungen sind.
Hinweis:
Bevor Sie einen VMware-Katalog verwalten, müssen Sie die Erstellung eines VMware-Katalogs abgeschlossen haben. Siehe (/de-de/citrix-daas/install-configure/machine-catalogs-create/create-machine-catalog-vmware.html).

Bereitgestellte VMs auf den aktuellen Zustand des Bereitstellungsschemas aktualisieren

Der Befehl Set-ProvScheme ändert das Bereitstellungsschema. Er wirkt sich jedoch nicht auf vorhandene VMs aus. Mit dem PowerShell-Befehl Set-ProvVMUpdateTimeWindow können Sie das aktuelle Bereitstellungsschema auf eine vorhandene persistente oder nicht-persistente VM oder eine Gruppe von VMs anwenden. Diese Funktion ist für maschinenprofilbasierte und nicht-maschinenprofilbasierte Maschinenkataloge anwendbar.
Sie können Folgendes aktualisieren:
  • VMCpuCount: Eigenschaft des Bereitstellungsschemas
  • VMMemoryMB: Eigenschaft des Bereitstellungsschemas
  • Ordner-ID: Benutzerdefinierte Eigenschaft
  • Subnetz-Zuordnung: Eigenschaft des Bereitstellungsschemas
  • Hardwareversion der VM: Nur für maschinenprofilbasierte Maschinenkataloge
  • Maschinenprofil: Nur für maschinenprofilbasierte Maschinenkataloge
Sie können aktualisieren:
  • Eine einzelne VM
  • Eine Liste spezifischer VMs oder alle vorhandenen VMs, die einer Bereitstellungsschema-ID zugeordnet sind
  • Eine Liste spezifischer VMs oder alle vorhandenen VMs, die einem Bereitstellungsschemanamen (Maschinenkatalogname) zugeordnet sind

Vor dem Aktualisieren der vorhandenen VMs

  1. Überprüfen Sie die Konfiguration der vorhandenen VMs. Zum Beispiel:
    Get-ProvScheme | select ProvisioningSchemeName, ProvisioningSchemeVersion
  2. Aktualisieren Sie das Bereitstellungsschema. Zum Beispiel:
    $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. Überprüfen Sie, ob die aktuelle Eigenschaft der VM mit dem aktuellen Bereitstellungsschema übereinstimmt und ob eine ausstehende Aktualisierungsaktion für die VM vorliegt. Zum Beispiel:
    Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion
    Sie können auch VMs mit einer bestimmten Version finden. Zum Beispiel:
    Get-ProvVM -Filter "ProvisioningSchemeVersion -eq 1" | select VMName, ProvisioningSchemeVersion

Updates für vorhandene VMs anfordern, die beim nächsten Neustart angewendet werden sollen

  1. Führen Sie die folgenden Befehle aus, um vorhandene VMs zu aktualisieren und die Updates beim nächsten Neustart anzuwenden.
    • Um alle vorhandenen VMs zu aktualisieren. Zum Beispiel:
      Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
    • Um eine Liste spezifischer VMs zu aktualisieren. Zum Beispiel:
      Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -VMName <List-Of-Vm-Names> -StartsNow -DurationInMinutes -1
    • Um VMs basierend auf der Ausgabe von Get-ProvVM zu aktualisieren. Zum Beispiel:
      Get-ProvVM -ProvisioningSchemeName "my-catalog" | Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
    Hinweis:
    • Der StartsNow gibt an, dass die geplante Startzeit die aktuelle Zeit ist.
    • Der DurationInMinutes mit einer negativen Zahl (zum Beispiel –1) zeigt keine Obergrenze für das Zeitfenster des Zeitplans an.
  2. VMs mit einem geplanten Update finden. Zum Beispiel:
    Get-ProvVM -Filter "ProvisioningSchemeUpdateAfter" | select VMName, ProvisioningSchemeUpdateAfter
  3. Starten Sie die VMs neu. Beim nächsten Einschalten werden Eigenschaftsänderungen auf die vorhandenen VMs angewendet. Sie können den aktualisierten Status mit dem folgenden Befehl überprüfen. Zum Beispiel:
    Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion

Konfigurationsupdate abbrechen

Sie können auch ein Konfigurationsupdate einer einzelnen VM, mehrerer VMs oder eines gesamten Katalogs abbrechen. So brechen Sie ein Konfigurationsupdate ab:
  1. Führen Sie Clear-ProvVMUpdateTimeWindow aus. Zum Beispiel:
    • So brechen Sie das für eine einzelne VM geplante Konfigurationsupdate ab:
      Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName “ my-catalog “ -VMName “vm1”
    • So brechen Sie das für mehrere VMs geplante Konfigurationsupdate ab:
      Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName "my-catalog" -VMName "vm1","vm2"
      Hinweis:
      Die VMs müssen aus demselben Katalog stammen.

Ordner-ID eines Maschinenkatalogs aktualisieren

Sie können die Ordner-ID eines MCS-Maschinenkatalogs aktualisieren, indem Sie die FolderId in den benutzerdefinierten Eigenschaften des Befehls Set-ProvScheme angeben. Die nach der Aktualisierung der Ordner-ID erstellten VMs werden unter dieser neuen Ordner-ID erstellt. Wenn diese Eigenschaft in CustomProperties nicht angegeben ist, werden die VMs in dem Ordner erstellt, in dem sich das Master-Image befindet.
Führen Sie die folgenden Schritte aus, um die Ordner-ID eines Maschinenkatalogs zu aktualisieren.
  1. Öffnen Sie einen Webbrowser und geben Sie die URL für den vSphere Web Client ein.
  2. Geben Sie die Anmeldeinformationen ein und klicken Sie auf Login.
  3. Erstellen Sie einen VM-Platzierungsordner im vSphere Web Client.
  4. Öffnen Sie ein PowerShell-Fenster.
  5. Führen Sie asnp citrix®* aus, um die Citrix-spezifischen PowerShell-Module zu laden.
  6. Geben Sie den FolderID im CustomProperties von Set-ProvScheme an. In diesem Beispiel ist der Ordner-ID-Wert 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. Fügen Sie dem Maschinenkatalog über Studio eine VM hinzu.
  8. Überprüfen Sie die neue VM im vSphere Web Client. Die neue VM wird im neuen Ordner erstellt.

Ordner-ID mithilfe von PowerShell-Befehlen finden

Verwenden Sie den PowerShell-Befehl Get-HypConfigurationDataForItem, um die Ordner-ID für einen vorhandenen Ordner in einem VMware-Hypervisor zu finden.
Erstellen Sie eine Hosting-Verbindung und eine Ressourcengruppe für einen VMware-Hypervisor. Führen Sie dann die folgenden Schritte aus, um die Ordner-ID eines Ordners auf diesem Hypervisor zu finden.
  1. Bestimmen Sie den XDHyp-Pfad zum Stamm des VM-Ordnerbaums. Zum Beispiel:
    XDHyp:\Connections\VMwareConn\Datacenter.datacenter
  2. Verwenden Sie Get-HypConfigurationDataForItem, um die Baumstruktur abzurufen. Zum Beispiel:
    Get-HypConfigurationDataForItem -LiteralPath XDHyp:\Connections\VMwareConn\Datacenter.datacenter
  3. Führen Sie den folgenden Befehl aus, um die Ordner-ID aus der Ausgabe-XML zu identifizieren. Suchen Sie in diesem Beispiel nach der Ordner-ID von ExampleFolder in der XML-Ausgabe.
    $result = Get-HypConfigurationDataForItem -LiteralPath XDHyp:\Connections\VMwareConn\Datacenter.datacenter
    $result.VmPlacementFolder
    XML-Ausgabe:
    <?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>

Ordner-ID in vSphere finden

Greifen Sie auf den MOB auf einem beliebigen ESXi- oder vCenter-Serversystem zu, um die Ordner-ID der VMs zu finden.
Der Managed Object Browser (MOB) ist eine webbasierte Serveranwendung, die in allen ESX/ESXi- und vCenter-Serversystemen integriert ist. Dieses vSphere-Dienstprogramm ermöglicht es Ihnen, detaillierte Informationen über Objekte wie VMs, Datastores und Ressourcenpools anzuzeigen.
  1. Öffnen Sie einen Webbrowser und geben Sie http://x.x.x.x/mob ein, wobei x.x.x.x die IP-Adresse des vCenter Servers oder ESX/ESXi-Hosts ist. Zum Beispiel, <https://10.60.4.70/mob>.
  2. Klicken Sie auf der Startseite von MOB auf den Wert der Eigenschaft content.
  3. Klicken Sie auf den Wert von rootFolder.
  4. Klicken Sie auf den Wert von childEntity.
  5. Klicken Sie auf den Wert von vmFolder.
  6. Sie finden die Ordner-ID im Wert von childEntity.

Von MCS erstellte Ressourcen identifizieren

Im Folgenden sind die Tags aufgeführt, die MCS den Ressourcen auf der VMware-Plattform hinzufügt. Die Tags in der Tabelle werden als „Schlüssel“:„Wert“ dargestellt.
Ressourcenname Tag
Vorbereitungs-VM "CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
"XdConfig:"XdProvisioned=True"
VM im Katalog "CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
"XdConfig:"XdProvisioned=True"

Weitere Informationen