Produktdokumentation
Citrix DaaS™
PDF anzeigen

VMware-Katalog verwalten

March 25, 2026
Beitrag von: 
C C

Maschinenkataloge verwalten beschreibt die Assistenten, die einen Maschinenkatalog verwalten. 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 VMware-Katalog erstellen.

Bereitgestellte VMs auf den aktuellen Bereitstellungsschema-Status 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 auf Maschinenprofil- 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 mit einer Bereitstellungsschema-ID verknüpft sind
  • Eine Liste spezifischer VMs oder alle vorhandenen VMs, die mit einem Bereitstellungsschema-Namen (Maschinenkatalogname) verknüpft sind

Vor dem Aktualisieren der vorhandenen VMs

  1. Überprüfen Sie die Konfiguration der vorhandenen VMs. Beispiel:

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

  2. Aktualisieren Sie das Bereitstellungsschema. 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>"
<!--NeedCopy-->

  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. Beispiel:

    Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion
<!--NeedCopy-->

    Sie können auch VMs mit einer bestimmten Version finden. Beispiel:

    Get-ProvVM -Filter "ProvisioningSchemeVersion -eq 1" | select VMName, ProvisioningSchemeVersion
<!--NeedCopy-->

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 anwenden zu lassen.

    • Um alle vorhandenen VMs zu aktualisieren. Beispiel:

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

    • Um eine Liste spezifischer VMs zu aktualisieren. Beispiel:

       Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -VMName <List-Of-Vm-Names> -StartsNow -DurationInMinutes -1
 <!--NeedCopy-->

    • Um VMs basierend auf der Ausgabe von Get-ProvVM zu aktualisieren. Beispiel:

      Get-ProvVM -ProvisioningSchemeName "my-catalog" | Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
 <!--NeedCopy-->

    Hinweis:

    • StartsNow gibt an, dass die geplante Startzeit die aktuelle Zeit ist.
    • DurationInMinutes mit einer negativen Zahl (z. B. –1) bedeutet keine Obergrenze für das Zeitfenster des Zeitplans.

  2. Finden Sie VMs mit einem geplanten Update. Beispiel:

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

  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. Beispiel:

    Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion
<!--NeedCopy-->

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. Beispiel:

    • So brechen Sie das für eine einzelne VM geplante Konfigurationsupdate ab:

       Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName “ my-catalog “ -VMName “vm1”
 <!--NeedCopy-->

    • So brechen Sie das für mehrere VMs geplante Konfigurationsupdate ab:

       Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName "my-catalog" -VMName "vm1","vm2"
 <!--NeedCopy-->

      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 nicht in CustomProperties angegeben ist, werden die VMs unter 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 Anmelden.
  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 die FolderID in den CustomProperties von Set-ProvScheme an. In diesem Beispiel ist der Wert der Ordner-ID 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-->
  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 unter dem neuen Ordner erstellt.

Ordner-ID mit 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. Beispiel:

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

  2. Verwenden Sie Get-HypConfigurationDataForItem, um die Baumstruktur abzurufen. Beispiel:

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

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

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

Ordner-ID in vSphere finden

Greifen Sie auf den MOB auf jedem 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, Datenspeicher 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. Beispiel: https://10.60.4.70/mob.
  2. Klicken Sie auf der Startseite des MOB auf den Wert der Eigenschaft content.
  3. Klicken Sie auf den Wert des rootFolder.
  4. Klicken Sie auf den Wert des childEntity.
  5. Klicken Sie auf den Wert des vmFolder.
  6. Sie finden die Ordner-ID im Wert des 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

VMware-Katalog verwalten
March 25, 2026
Beitrag von: 
C C
March 25, 2026
Beitrag von: 
C C

In diesem Artikel

Feedback zur Site | Your privacy choices footer linkIhre Datenschutzauswahl | Datenschutz und rechtliche Bestimmungen | Cookie-Einstellungen | Einstellungen für die Zustimmung | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.