Produktdokumentation
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
PDF anzeigen

Maschinenkataloge verwalten

May 22, 2025
Beitrag von: 
C

Hinweis:

Sie können Ihre Citrix Virtual Apps and Desktops-Bereitstellung mithilfe von zwei Verwaltungskonsolen verwalten: Web Studio (webbasiert) und Citrix Studio (Windows-basiert). Dieser Artikel behandelt nur Web Studio. Informationen zu Citrix Studio finden Sie im entsprechenden Artikel in Citrix Virtual Apps and Desktops 7 2212 oder früher.

Einführung

Sie können Maschinen in Maschinenkatalogen hinzufügen, entfernen und umbenennen, Maschinenbeschreibungen ändern und die Active Directory-Computerkonten des Katalogs verwalten.

Zur Verwaltung von Katalogen kann auch die Sorge dafür gehören, dass jede Maschine über die neuesten Betriebssystemupdates verfügt. Dies schließt Antivirenupdates, Betriebssystemupgrades und Konfigurationsänderungen ein.

  • Maschinenkataloge mit gepoolt-zufälligen Maschinen, die mit Maschinenerstellungsdienste (MCS) erstellt wurden, können Sie pflegen, indem Sie das Masterimage des Katalogs und dann die Maschinen aktualisieren. So können Sie eine große Anzahl Maschinen effizient aktualisieren.
  • Bei Katalogen mit statischen (permanent zugewiesenen) oder Remote-PC-Zugriff-Maschinen verwalten Sie Updates an den Benutzermaschinen Web Studio-extern. Tun Sie dies entweder für einzelne Maschinen oder alle Maschinen mit Bereitstellungssoftware von Drittanbietern.

Weitere Informationen zum Erstellen und Verwalten von Verbindungen mit Hosthypervisors finden Sie unter Verbindungen und Ressourcen.

Hinweis:

MCS unterstützt Windows 10 IoT Core und Windows 10 IoT Enterprise nicht. Weitere Informationen finden Sie auf der Website von Microsoft.

Informationen zu persistenten Instanzen

Beim Update eines MCS-Katalogs, der mit persistenten, also dedizierten Instanzen, erstellt wurde, verwenden alle neu für den Katalog erstellten Maschinen das aktualisierte Image. Bereits vorhandene Instanzen verwenden weiterhin die ursprüngliche Instanz. Das Update eines Images wird für jeden anderen Katalogtyp auf die gleiche Weise durchgeführt. Beachten Sie Folgendes:

  • Bei persistenten Datenträgerkatalogen werden die bereits vorhandenen Maschinen nicht auf das neue Image aktualisiert. Alle neu dem Katalog hinzugefügten Maschinen verwenden aber das neue Image.
  • Bei nichtpersistenten Datenträgerkatalogen wird das Maschinenimage aktualisiert, wenn die Maschine das nächste Mal zurückgesetzt wird.
  • Bei persistenten Maschinenkatalogen werden durch das Update des Images auch die Kataloginstanzen aktualisiert, die es verwenden.
  • Bei nichtpersistenten Katalogen müssen Images in separaten Katalogen sein, wenn Sie unterschiedliche Images für verschiedene Maschinen brauchen.

Maschinenkataloge verwalten

Sie können einen Maschinenkatalog auf zweierlei Art verwalten:

Web Studio verwenden

In diesem Abschnitt wird beschrieben, wie Sie Kataloge mit Web Studio verwalten:

Katalogdetails anzeigen

  1. Verwenden Sie die Suchfunktion, um einen bestimmten Maschinenkatalog zu finden. Anweisungen finden Sie unter Nach Instanzen suchen.
  2. Wählen Sie aus den Suchergebnissen nach Bedarf einen Katalog aus.
  3. In der folgenden Tabelle finden Sie Beschreibungen der Katalogspalten.
  4. Klicken Sie im unteren Detailbereich auf eine Registerkarte, um weitere Informationen zu diesem Katalog zu erhalten.
Spalte Beschreibung
Maschinenkatalog

Der Name und der Zuteilungstyp des Katalogs. Zu den Zuordnungsarten gehören
  • Zufällig: Maschinen im Katalog werden einem Benutzer nach dem Zufallsprinzip zugewiesen.
  • Permanent: Maschinen im Katalog sind einem Benutzer dauerhaft zugeordnet.
    		•
    Maschinentyp




    		Der unterstützte Sitzungstyp der Maschinen im Katalog. Mögliche Werte sind
  • Betriebssystemtyp: Multisitzungs-OS (virtuell); Benutzerdaten: Verwerfen.
  • Betriebssystemtyp: Multisitzungs-OS (virtuell); Benutzerdaten: Auf lokalem Datenträger
  • Betriebssystemtyp: Einzelsitzungs-OS (Remote-PC-Zugriff)
  • Betriebssystemtyp: Einzelsitzungs-OS (virtuell); Benutzerdaten: Verwerfen
  • Betriebssystemtyp: Einzelsitzungs-OS (virtuell); Benutzerdaten: Auf lokalem Datenträger
    		•
    Maschinenanzahl Die Anzahl der Maschinen im Katalog und die Provisioningmethode. Zu den möglichen Provisioningmethoden gehören: Machine Creation Services (MCS-Maschine), Manuell und Citrix Provisioning Services.
    Zugewiesene Anzahl Die Anzahl der Maschinen im Katalog, die einer Bereitstellungsgruppe zugewiesen sind.
    Ordner Der Speicherort des Katalogs im Maschinenkatalogbaum. Die Angabe zeigt den Namen des Ordners an, in dem sich der Katalog befindet (einschließlich des abschließenden Backslashs) oder “-”, wenn sich der Katalog auf der Stammebene befindet.
    VDA-Upgrade VDA-Upgradestatus. Mögliche Werte: Nicht konfiguriert, Geplant, Verfügbar und Aktuell.
    Imagestatus Der Status der Imageaktualisierung des Katalogs. Gilt nur für nicht persistente Maschinenkataloge. Mögliche Werte sind: Vollständig aktualisiert, Teilweise aktualisiert, Ausstehende Aktualisierungen, Vorbereitet

    Maschinen zu einem Katalog hinzufügen

    Vorbereitungen:

    • Vergewissern Sie sich, dass der Virtualisierungshost genügend Prozessoren, Arbeitsspeicher und Speicher zur Unterbringung der zusätzlichen Maschinen hat.
    • Vergewissern Sie sich, dass Sie genügend ungenutzte Active Directory-Computerkonten haben. Wenn Sie bestehende Konten verwenden, können Sie nur so viele Maschinen erstellen, wie Sie Konten haben.
    • Wenn Sie Active Directory-Computerkonten für die zusätzlichen Maschinen mit Web Studio erstellen, müssen Sie die erforderlichen Domänenadministratorrechte haben.

    Hinzufügen von Maschinen zum Maschinenkatalog

    1. Melden Sie sich bei Web Studio an.
    2. Wählen Sie im linken Bereich Maschinenkataloge.
    3. Wählen Sie einen Maschinenkatalog und dann in der Aktionsleiste die Option Maschinen hinzufügen.
    4. Legen Sie die Anzahl der hinzuzufügenden virtuellen Maschinen fest.
    5. Gibt es nicht genügend Active Directory-Konten für die Zahl der VMs, die Sie hinzufügen möchten, wählen Sie die Domäne und den Speicherort, an dem Konten erstellt werden sollen. Legen Sie ein Kontobenennungsschema mit Hashmarkierungen zur Kennzeichnung der Platzierung sequenzieller Zahlen bzw. Buchstaben fest. Verwenden Sie keinen Schrägstrich (/) in Namen von Organisationseinheiten. Namen dürfen nicht mit einer Zahl beginnen. Beispielsweise führt ein Benennungsschema von PC-Sales-## (mit Auswahl von 0-9) zu Computerkonten mit den Namen PC-Sales-01, PC-Sales-02, PC-Sales-03 usw.
    6. Wenn Sie bestehende Active Directory-Konten verwenden, navigieren Sie zu den Konten oder klicken Sie auf Importieren und geben Sie eine CSV-Datei mit Kontonamen an. Vergewissern Sie sich, dass Sie ausreichend Konten für die hinzuzufügenden Maschinen haben. Web Studio verwaltet diese Konten. Gestatten Sie Web Studio, die Kennwörter für alle Konten zurückzusetzen, oder geben Sie das Kontokennwort an (muss für alle Konten gleich sein).

    Die Maschinen werden in einem Hintergrundprozess erstellt, der beim Erstellen einer großen Zahl von Maschinen lange dauern kann. Die Maschinenerstellung wird fortgesetzt, selbst wenn Sie Web Studio schließen.

    Maschinen aus einem Maschinenkatalog löschen

    Wenn Sie eine Maschine aus einem Maschinenkatalog löschen, können Benutzer nicht mehr darauf zugreifen. Vergewissern Sie sich vor dem Löschen daher, dass folgende Bedingungen erfüllt sind:

    • Die Benutzerdaten wurden gesichert oder werden nicht mehr benötigt.
    • Alle Benutzer sind abgemeldet. Durch das Aktivieren des Wartungsmodus wird verhindert, dass neue Verbindungen mit einer Maschine hergestellt werden.
    • Die Maschinen sind ausgeschaltet.

    Löschen von Maschinen aus einem Maschinenkatalog

    1. Melden Sie sich bei Web Studio an.
    2. Wählen Sie im linken Bereich Maschinenkataloge.
    3. Wählen Sie einen Katalog und dann in der Aktionsleiste Maschinen anzeigen.
    4. Wählen Sie eine oder mehrere Maschinen und dann in der Aktionsleiste Löschen.

    Wählen Sie aus, ob die Maschinen wirklich gelöscht werden sollen. Falls ja, geben Sie an, ob die zugehörigen Active Directory-Konten beibehalten, deaktiviert oder gelöscht werden sollen.

    Einen Katalog bearbeiten

    1. Ändern Sie auf der Seite Beschreibung die Beschreibung des Maschinenkatalogs.
    2. Wählen Sie im linken Bereich Maschinenkataloge.
    3. Wählen Sie einen Katalog und dann in der Aktionsleiste Maschinenkatalog bearbeiten.
    4. Ändern Sie die Bereiche auf der Seite Geltungsbereiche.

    5. Führen Sie auf der Seite Netzwerkkarte die folgenden Aktionen aus:

      • Um die Subnetzzuordnung einer Netzwerkkarte zu ändern, wählen Sie im Feld Zugeordnetes Netzwerk ein Netzwerk aus.
      • Um eine Subnetzzuordnung hinzuzufügen, wählen Sie NIC hinzufügen, wählen Sie ein Netzwerk aus dem Feld Zugehöriges Netzwerk und klicken Sie auf Speichern.

      Im Feld Zugeordnetes Netzwerk werden nur die Subnetze angezeigt, die auf dem mit dem Katalog verknüpften Host vorhanden sind.

      Sie können eine Netzwerkkarte nur zu Azure-Maschinenkatalogen ohne Maschinenprofile hinzufügen.

      Hinweis:

      • Bei AWS-Maschinenkatalogen können Sie dasselbe Subnetz nicht mehreren Netzwerkkarten zuordnen.
      • Bei Maschinenkatalogen mit Maschinenprofilen muss die Anzahl der Netzwerkkarten im Katalog der Anzahl der Netzwerkkarten im Maschinenprofil entsprechen.
      • Dieses Feature wird für IBM Cloud-Hypervisors nicht unterstützt.
      • Dieses Feature wird nur für Nutanix Prism Element im Fall von Nutanix-Hypervisors unterstützt.

    6. Je nach Katalogtyp werden möglicherweise andere Seiten angezeigt.

      Für Kataloge, die mit einem Azure Resource Manager-Image erstellt wurden, werden die folgenden Seiten angezeigt. Denken Sie daran, dass vorgenommene Änderungen nur für Maschinen gelten, die Sie später zum Katalog hinzufügen. Bestehende Maschinen bleiben unverändert.

      • Ändern Sie auf der Seite Virtuelle Maschinen die Maschinengröße und wählen Sie Verfügbarkeitszonen aus, in denen Sie Maschinen erstellen möchten.

        Hinweis:

        • Es werden nur Maschinengrößen angezeigt, die vom Katalog unterstützt werden.
        • Wählen Sie gegebenenfalls Nur in anderen Maschinenkatalogen verwendete Maschinengrößen anzeigen, um die Liste der Maschinengrößen zu filtern.

      • On the Machine Profile page, choose whether to use or change a machine profile.

      • (Visible only when the catalog is configured with a dedicated group host) On the Dedicated host group page, choose whether to change a host group.

      • On the Storage and License Types page, choose whether to change the storage type, license type, and Azure Computer Gallery settings (available only when Place prepared image in Azure Gallery is in use).

      Hinweis:

      Wenn die neue Einstellung die aktuelle Maschinengröße nicht unterstützt, wird eine Warnung angezeigt, dass durch eine Änderung der Einstellung die Maschinengröße zurückgesetzt wird. Wenn Sie fortfahren möchten, erscheint neben dem Menü Virtuelle Maschinen ein roter Punkt, durch den Sie aufgefordert werden, eine neue Maschinengröße auszuwählen.

      • On the License Type page, choose whether to change the Windows license or Linux license setting.

      Für Remote-PC-Zugriff-Kataloge werden die folgenden Seiten angezeigt:

      • On the Power Management page, change the power management settings and select a power management connection.
      • Verwenden Sie die Seite Organisationseinheiten zum Hinzufügen und Entfernen von Active Directory-Organisationseinheiten.
    7. Klicken Sie auf Übernehmen, um die vorgenommenen Änderungen zu übernehmen, und klicken Sie dann auf Speichern.

    Katalog umbenennen

    1. Melden Sie sich bei Web Studio an.
    2. Wählen Sie im linken Bereich Maschinenkataloge.
    3. Wählen Sie einen Katalog und dann in der Aktionsleiste Maschinenkatalog umbenennen.
    4. Geben Sie den neuen Namen ein.

    Verschieben eines Maschinenkatalogs in eine andere Zone

    Wenn eine Bereitstellung mehrere Zonen enthält, können Sie Maschinenkataloge von Zone zu Zone verschieben.

    Wenn Sie einen Maschinenkatalog aus dem Hypervisor mit den zugehörigen VMs in eine andere Zone verschieben, wirkt sich dies negativ auf die Leistung aus.

    1. Melden Sie sich bei Web Studio an.
    2. Wählen Sie im linken Bereich Maschinenkataloge.
    3. Wählen Sie einen Katalog und dann in der Aktionsleiste Verschieben.
    4. Wählen Sie die Zone aus, in die Sie den Katalog verschieben möchten.

    Katalog löschen

    Vor dem Löschen eines Katalogs müssen Sie Folgendes sicherstellen:

    • Alle Benutzer sind abgemeldet und Sie führen keine getrennten Sitzungen durch.
    • Der Wartungsmodus ist für alle Maschinen in dem Katalog aktiviert, damit keine neuen Verbindungen hergestellt werden können.
    • Alle Maschinen in dem Katalog sind ausgeschaltet.
    • Der Katalog ist keiner Bereitstellungsgruppe zugeordnet. Das heißt, keine Bereitstellungsgruppe enthält Maschinen aus dem Katalog.

    Löschen eines Maschinenkatalogs

    1. Melden Sie sich bei Web Studio an.
    2. Wählen Sie im linken Bereich Maschinenkataloge.
    3. Wählen Sie einen Katalog und dann in der Aktionsleiste Maschinenkatalog löschen.
    4. Geben Sie an, ob die Maschinen in dem Katalog gelöscht werden sollen. Falls ja, geben Sie an, ob die zugehörigen Active Directory-Computerkonten beibehalten, deaktiviert oder gelöscht werden sollen.

    Active Directory-Computerkonten in einem Maschinenkatalog verwalten

    Zum Verwalten von Active Directory-Konten in einem Maschinenkatalog haben Sie folgende Möglichkeiten:

    • Freigeben nicht verwendeter Maschinenkonten durch Entfernen von Active Directory-Computerkonten aus Katalogen mit Maschinen für Einzelsitzungs- und Multisitzungs-OS. Diese Konten können dann für andere Maschinen verwendet werden.
    • Hinzufügen von Konten, damit beim Hinzufügen weiterer Maschinen zum Katalog Computerkonten bereit stehen. Verwenden Sie keinen Schrägstrich (/) in Namen von Organisationseinheiten.

    Verwalten von Active Directory-Konten

    1. Melden Sie sich bei Web Studio an.
    2. Wählen Sie im linken Bereich Maschinenkataloge.
    3. Wählen Sie einen Maschinenkatalog und dann in der Aktionsleiste Active Directory-Konten verwalten.

    4. Entscheiden Sie, ob Sie Computerkonten hinzufügen oder löschen möchten. Wenn Sie Konten hinzufügen, geben Sie an, wie mit den Kennwörtern verfahren werden soll: Setzen Sie entweder alle zurück oder geben Sie ein für alle Konten geltendes Kennwort ein.

      Sie können die Kennwörter zurückzusetzen, wenn Sie die aktuellen Kennwörter nicht kennen. Zum Zurücksetzen von Kennwörtern müssen Sie die entsprechende Berechtigung haben. Wenn Sie ein Kennwort eingeben, wird das Kennwort von Konten beim Importieren geändert. Wenn Sie ein Konto löschen, legen Sie fest, ob das Konto in Active Directory beibehalten, deaktiviert oder gelöscht werden soll.

    Geben Sie an, ob Active Directory-Konten beibehalten, deaktiviert oder gelöscht werden sollen, wenn Sie Maschinen aus einem Katalog entfernen oder einen Katalog löschen.

    Aktualisieren von Maschinenkatalogen

    Wir empfehlen, vor dem Durchführen von Updates von Maschinen in einem Katalog Kopien oder Snapshots der Masterimages zu speichern. In der Datenbank wird von jedem Masterimage eines Maschinenkatalogs ein historischer Datensatz beibehalten. Rollback oder Wiederherstellen von Maschinen in einem Katalog, um die vorherige Masterimageversion zu verwenden. Führen Sie diese Aufgabe aus, wenn Benutzer Probleme durch Updates haben, die Sie auf den Desktops bereitgestellt haben. Dadurch werden Ausfallzeiten für die Benutzer minimiert. Masterimages dürfen nicht gelöscht, verschoben oder umbenannt werden. Sie können einen Katalog nicht zu ihrer Verwendung wiederherstellen.

    Nachdem eine Maschine aktualisiert wurde, wird sie automatisch neu gestartet.

    Aktualisieren oder Erstellen eines Masterimages

    Bevor Sie einen Maschinenkatalog aktualisieren, aktualisieren Sie zunächst ein vorhandenes Masterimage oder erstellen Sie eins auf dem Hypervisor.

    1. Erstellen Sie auf dem Hypervisor einen Snapshot der aktuellen VM und geben Sie diesem einen aussagekräftigen Namen. Der Snapshot kann notfalls zur Wiederherstellung (Rollback) der Maschinen in dem Katalog verwendet werden.
    2. Falls erforderlich, schalten Sie das Masterimage ein und melden Sie sich an.
    3. Installieren Sie Updates bzw. nehmen Sie die erforderlichen Änderungen am Masterimage vor.
    4. Schalten Sie die virtuelle Maschine aus.
    5. Erstellen Sie einen Snapshot der VM. Geben Sie diesem einen aussagekräftigen Namen, der bei der Aktualisierung des Katalogs in Web Studio erkannt wird. Obwohl Web Studio einen Snapshot erstellen kann, empfiehlt Citrix, dass Sie diesen mit der Hypervisor-Verwaltungskonsole erstellen. Wählen Sie dann den Snapshot in Web Studio aus. Dadurch können Sie statt eines automatisch erstellten Namens einen aussagekräftigen Namen und eine Beschreibung zuweisen. Bei GPU-Masterimages können Sie das Masterimage nur über die XenServer-Konsole ändern.

    Masterimage ändern

    Vorbereiten und Verteilen des Updates auf allen Maschinen in einem Katalog

    1. Melden Sie sich bei Web Studio an.
    2. Wählen Sie im linken Bereich Maschinenkataloge.
    3. Wählen Sie einen Katalog und dann in der Aktionsleiste Masterimage ändern.
    4. Wählen Sie auf der Seite Image den Host und das Masterimage aus, das Sie verwenden möchten. > Tipp: > > Bei einem mit MCS erstellten Katalog können Sie das Bild mit Anmerkungen versehen, indem Sie eine Notiz zum Bild hinzufügen. Ein Hinweis kann bis zu 500 Zeichen enthalten. Bei jeder Änderung des Masterimages wird ein Hinweis-Eintrag erstellt, unabhängig davon, ob Sie einen Hinweis hinzufügen. Wenn Sie beim Aktualisieren eines Katalogs keinen Hinweis hinzuzufügen, wird der Eintrag als Null (-) angezeigt. Um den Hinweisverlauf für ein Image anzuzeigen, wählen Sie den Katalog, klicken Sie im unteren Bereich auf Vorlageneigenschaften und klicken Sie dann auf Hinweisverlauf anzeigen.
    5. Legen Sie auf der Seite Rolloutstrategie fest, wann die Aktualisierung der Maschinen im Maschinenkatalog erfolgen soll: beim nächsten Herunterfahren oder sofort. > Hinweis: > > Die Seite Rolloutstrategie ist für persistente VMs nicht verfügbar, da Rollout nur auf nicht persistente VMs anwendbar ist.
    6. Überprüfen Sie die Informationen auf der Seite Zusammenfassung und klicken Sie auf Fertigstellen. Jede Maschine wird nach erfolgter Aktualisierung automatisch neu gestartet.

    Um den Fortschritt des Updates zu verfolgen, suchen Sie den Katalog in Maschinenkatalogen, um den Fortschrittsbalken und das Fortschrittsdiagramm anzuzeigen.

    Wenn Sie einen Katalog nicht in Web Studio, sondern direkt mit dem PowerShell-SDK aktualisieren, geben Sie eine Hypervisorvorlage (VMTemplates) an. Verwenden Sie diese Option als Alternative zu einem Image oder einem Imagesnapshot.

    Rolloutstrategie:

    Das Imageupdate beim nächsten Herunterfahren wirkt sich sofort auf alle nicht in Verwendung befindliche Maschinen aus, d. h. auf Maschinen ohne aktive Benutzersitzung. In Verwendung befindliche Systeme erhalten das Update bei Beenden der aktiven Sitzung. Beachten Sie Folgendes:

    • Neue Sitzungen können erst gestartet werden, wenn das Update auf einer Maschine abgeschlossen ist.
    • Einzelsitzungs-OS-Maschinen werden, wenn sie nicht in Verwendung sind bzw. keine Benutzer angemeldet sind, sofort aktualisiert.
    • Bei Multisitzungs-OS mit untergeordneten Maschinen werden keine automatischen Neustarts durchgeführt. Um das aktualisierte Masterimage anzuwenden, starten Sie die Maschinen mit Studio, PowerShell oder Workspace neu. Ein Neustart der Maschinen oder des Hypervisors führt nicht zur Anwendung des Updates.

    Tipp

    Zum Beschränken der Anzahl neu gestarteter Maschine können Sie die erweiterten Einstellungen für eine Hostverbindung verwenden. Über diese Einstellungen können Sie die für einen Katalog durchgeführten Aktionen ändern. Erweiterte Einstellungen variieren je nach Hypervisor.

    Rollback des Masterimages ausführen

    Nach Bereitstellung eines aktualisierten oder neuen Masterimages können Sie diese mit einem Rollback rückgängig machen. Dieser Prozess kann erforderlich sein, wenn Probleme bei den aktualisierten Maschinen auftreten. Bei einem Rollback werden die Maschinen in dem Katalog auf das letzte funktionierende Image zurückgesetzt. Was ist neu, die das neue Image erfordern, stehen dann nicht mehr zur Verfügung. Bei einem Rollback einer Maschine ist ein Neustart erforderlich.

    1. Melden Sie sich bei Web Studio an.
    2. Wählen Sie im linken Bereich Maschinenkataloge.
    3. Wählen Sie den Katalog und dann in der Aktionsleiste Rollback für Masterimage ausführen.
    4. Legen Sie fest, wann das ältere Masterimage auf die Maschinen angewendet werden soll (gemäß den Rollout-Anweisungen im vorigen Abschnitt).

    Das Rollback wird nur auf Maschinen angewendet, die zurückgesetzt werden müssen. Maschinen, die nicht mit dem neuen oder aktualisierten Masterimage aktualisiert wurden, erhalten keine Benachrichtigung und müssen sich nicht abmelden.

    Um den Rollback-Fortschritt zu verfolgen, suchen Sie den Katalog in Maschinenkatalogen, damit der Fortschrittsbalken und das Fortschrittsdiagramm angezeigt werden.

    Funktionsebene ändern oder Änderung rückgängig machen

    Ändern Sie die Funktionsebene für den Maschinenkatalog nach dem Upgrade der VDAs auf den Maschinen auf eine neuere Version. Citrix empfiehlt das Upgrade aller VDAs auf die aktuelle Version, damit Zugriff auf alle neuen Features besteht.

    Führen Sie folgende Schritte aus, bevor Sie die Funktionsebene für einen Maschinenkatalog ändern:

    • Starten Sie die aktualisierten Maschinen, damit sie sich bei dem Controller registrieren. Auf diese Weise kann Web Studio feststellen, dass die Maschinen im Maschinenkatalog aktualisiert werden müssen.

    Ändern der Funktionsebene für einen Katalog:

    1. Melden Sie sich bei Web Studio an.
    2. Wählen Sie im linken Bereich Maschinenkataloge.
    3. Wählen Sie den Katalog aus. Auf der Registerkarte Details im unteren Bereich werden Versionsinformationen angezeigt.
    4. Wählen Sie Funktionsebene ändern. Wenn Web Studio erkennt, dass für den Katalog ein Upgrade erforderlich ist, wird eine Meldung angezeigt. Folgen Sie den Anweisungen. Kann eine Maschine nicht aktualisiert werden, wird eine Meldung mit einer Erläuterung der Ursache des Problems angezeigt. Um einen ordnungsgemäßen Betrieb aller Maschinen sicherzustellen, empfiehlt Citrix, Maschinenprobleme zu beheben, bevor Sie zum Fortfahren auf Ändern klicken.

    Nach Abschluss der Katalogänderung können Sie Maschinen auf ihre vorherige VDA-Version zurücksetzen, indem Sie zunächst den Maschinenkatalog und dann in der Aktionsleiste Änderung der Funktionsebene rückgängig machen wählen.

    Kataloge klonen

    Beim Klonen von Katalogen ist Folgendes zu berücksichtigen:

    • Sie können die Einstellungen für Betriebssystem und Maschinenverwaltung nicht ändern. Der Klon erbt diese Einstellungen vom Original.
    • Das Klonen eines Katalogs kann einige Zeit in Anspruch nehmen. Wählen Sie bei Bedarf Fortschritt ausblenden aus, um das Klonen im Hintergrund auszuführen.
    • Der geklonte Katalog erbt den Namen des Originals und hat das Suffix Kopie. Der Name kann geändert werden. Weitere Informationen finden Sie unter Umbenennen von Maschinenkatalogen.
    • Weisen Sie den geklonten Katalog unbedingt einer Bereitstellungsgruppe zu.
    1. Melden Sie sich bei Web Studio an und wählen Sie im linken Bereich Maschinenkataloge.
    2. Wählen Sie einen Katalog und dann in der Aktionsleiste Klonen.
    3. Prüfen Sie im Fenster Ausgewählten Maschinenkatalog klonen die Einstellungen für den geklonten Katalog und bearbeiten Sie diese nach Bedarf. Wählen Sie Weiter, um mit der nächsten Seite fortzufahren.
    4. Überprüfen Sie auf der Seite Zusammenfassung die Einstellungen und wählen Sie Fertigstellen, um das Klonen zu starten.
    5. Wählen Sie bei Bedarf Fortschritt ausblenden aus, um das Klonen im Hintergrund auszuführen.

    Kataloge mit Ordnern organisieren

    Sie können Ordner erstellen, um Kataloge für einfachen Zugriff zu organisieren. Sie können beispielsweise Kataloge nach Imagetyp oder Organisationsstruktur organisieren.

    Tipp

    Sie können Ihre bevorzugte Standardansicht (Ordner- oder Listenansicht) für den Knoten “Maschinenkataloge” festlegen, indem Sie oben rechts in der Aktionsleiste auf das Symbol Ordner klicken.

    Katalogordner erstellen

    Planen Sie zunächst, wie Sie Ihre Kataloge organisieren wollen. Beachten Sie Folgendes:

    • Sie können Ordner mit einer Tiefe von bis zu fünf Ebenen verschachteln (mit Ausnahme des Standardstammordners).
    • Ein Katalogordner kann Kataloge und Unterordner enthalten.
    • Alle Knoten in Web Studio (wie die Knoten Maschinenkataloge und Anwendungen) teilen sich eine Ordnerstruktur im Back-End. Um Namenskonflikte mit anderen Knoten beim Umbenennen oder Verschieben von Ordnern zu vermeiden, empfehlen wir, Ordnern der ersten Ebene in verschiedenen Knoten unterschiedliche Namen zu geben.

    Gehen Sie wie folgt vor, um einen Katalogordner zu erstellen:

    1. Wählen Sie im linken Bereich Maschinenkataloge.
    2. Wählen Sie in der Ordnerhierarchie einen Ordner aus und klicken Sie dann in der Aktionsleiste auf Ordner erstellen.
    3. Geben Sie einen Namen für den neuen Ordner ein und klicken Sie dann auf Fertig.

    Tipp

    Wenn Sie einen Ordner an einem falschen Speicherort erstellen, können Sie ihn an den korrekten Speicherort ziehen.

    Katalog verschieben

    Sie können einen Katalog zwischen Ordnern verschieben. Verfahren:

    1. Wählen Sie im linken Bereich Maschinenkataloge.
    2. Zeigen Sie Kataloge nach Ordnern an. Sie können auch die Option Alle anzeigen über der Ordnerhierarchie aktivieren, um alle Kataloge gleichzeitig anzuzeigen.
    3. Klicken Sie mit der rechten Maustaste auf einen Katalog und wählen Sie dann Maschinenkatalog verschieben aus.
    4. Wählen Sie den Ordner aus, in den Sie den Katalog verschieben möchten, und klicken Sie dann auf Fertig.

    Tipp

    Sie können einen Katalog in einen Ordner ziehen.

    Katalogordner verwalten

    Sie können Katalogordner löschen, umbenennen und verschieben.

    Sie können einen Ordner nur löschen, wenn er und seine Unterordner keine Kataloge enthalten.

    Gehen Sie wie folgt vor, um einen Ordner zu verwalten:

    1. Wählen Sie im linken Bereich Maschinenkataloge.

    2. Wählen Sie in der Ordnerhierarchie einen Ordner aus und wählen Sie dann eine gewünschte Aktion in der Aktionsleiste aus:

      • Wählen Sie zum Umbenennen des Ordners Ordner umbenennen aus.
      • Wählen Sie zum Löschen des Ordners Ordner löschen aus.
      • Wählen Sie zum Verschieben des Ordners Ordner verschieben aus.
    3. Folgen Sie den Anweisungen auf dem Bildschirm, um die restlichen Schritte auszuführen.

    Katalogerstellung erneut versuchen

    Hinweis:

    Dieses Feature gilt nur für MCS-Kataloge.

    Fehlerhafte Kataloge sind mit einem Fehlersymbol gekennzeichnet. Zum Anzeigen von Details gehen Sie zur Registerkarte Problembehandlung des jeweiligen Katalogs. Beim Neuversuch der Erstellung Klonen von Katalogen ist Folgendes zu berücksichtigen:

    • Prüfen Sie zuerst die Informationen zur Problembehandlung und beheben Sie die Probleme. Die Informationen beschreiben die Probleme und enthalten Empfehlungen zu deren Behebung.
    • Sie können die Einstellungen für Betriebssystem und Maschinenverwaltung nicht ändern. Der Katalog erbt diese Einstellungen vom Original.
    • Es kann einige Zeit dauern, bis die Erstellung abgeschlossen ist. Wählen Sie bei Bedarf Fortschritt ausblenden aus, um die Erstellung im Hintergrund auszuführen.

    Gehen Sie wie folgt vor, um erneut zu versuchen, einen Katalog zu erstellen:

    1. Wählen Sie in Web Studio im linken Bereich Maschinenkataloge aus.
    2. Wählen Sie den Katalog aus und gehen Sie zur Registerkarte Problembehandlung.
    3. Klicken Sie auf den Hyperlink “Wiederholen”, um erneut zu versuchen, den Katalog zu erstellen.
    4. Ändern Sie im daraufhin angezeigten Assistenten die Einstellungen bei Bedarf. Wenn Sie keine Änderungen vornehmen müssen, können Sie direkt zur Übersichtsseite wechseln.
    5. Wenn Sie fertig sind, wählen Sie Fertig stellen, um mit der Erstellung zu beginnen.

    VDAs, die nicht von MCS bereitgestellt wurden, mit Token registrieren (Preview)

    Sie können jetzt Registrierungstoken für nicht von MCS bereitgestellte VDAs generieren und verwalten. Diese Implementierung ermöglicht die VDA-Registrierung über WebSocket, ohne dass die VDAs mit MCS ausgestattet werden müssen. Diese Funktion unterstützt auch Linux Virtual Delivery Agent, Citrix Virtual Delivery Agent für macOS und nicht domänengebundene VDAs mit Citrix Virtual Apps and Desktops.

    Voraussetzungen

    1. Konfigurieren Sie Ihre Site. Weitere Informationen finden Sie unter Site erstellen.
    2. Installieren Sie TLS-Zertifikate auf den Delivery Controllern. Weitere Informationen finden Sie unter TLS-Serverzertifikaten auf Controllern installieren.
    3. Installieren Sie die Stammzertifizierungsstelle und die Zwischenzertifizierungsstelle auf dem VDA, um dem Delivery Controller zu vertrauen.

    4. Aktivieren Sie die WebSocket-Verbindung auf dem Delivery Controller. Führen Sie den folgenden Befehl auf jedem Delivery Controller auf Ihrer Site aus:

        New-ItemProperty "HKLM:\SOFTWARE\Citrix\DesktopServer\WorkerProxy" -Name "WebSocket_Enabled" -PropertyType "DWord" -Value 1 -Force
<!--NeedCopy-->

      Hinweis:

      Sie müssen die Delivery Controller neu starten, nachdem Sie den WebSocket aktiviert haben.

    Registrierungstoken generieren

    Nachdem Sie sich entschieden haben, die tokenbasierte Registrierung für Maschinen zu aktivieren, die nicht von Citrix bereitgestellt werden, müssen Sie zunächst Token pro Maschinenkatalog generieren und sie dann für VDA-Installationsadministratoren freigeben.

    Ein Registrierungstoken bietet:

    • Registrierungsbereich: 1—100 VDA-Maschinen
    • Gültigkeitsdauer: bis zu 14 Tage

    Gehen Sie folgendermaßen vor, um mit Web Studio ein Token für einen Katalog zu generieren:

    1. Suchen Sie in Web Studio > Maschinenkataloge einen nicht von MCS bereitgestellten Katalog, bei dem in der Spalte Maschinenanzahl die Angabe Bereitstellungsmethode: Manuell angezeigt wird.
    2. Klicken Sie mit der rechten Maustaste auf den Katalog und wählen Sie dann Registrierungstoken verwalten aus.
    3. Geben Sie auf der Seite Registrierungstoken generieren, die daraufhin angezeigt wird, die folgenden Tokeninformationen ein:
      • Geben Sie einen Namen für das Token ein.
      • Geben Sie den Gültigkeitszeitraum ein. Der Zeitraum darf nicht mehr als 14 Tage betragen. Das Token ist nur für den angegebenen Zeitraum gültig.
      • (Optional) Wählen Sie eine Hostverbindung für die Energieverwaltung von VDAs aus, die mit dem Token registriert sind. Zu den Optionen gehören alle Hostverbindungen in der Zone dieses Katalogs.
      • Geben Sie die Grenzwerte für die Tokennutzung ein (zwischen 1 und 100).
    4. Klicken Sie auf Generieren.

    5. Kopieren Sie im daraufhin angezeigten Fenster Token erfolgreich generiert das Token und speichern Sie es an einem sicheren Ort, oder klicken Sie auf Herunterladen, um es in den Download-Ordner herunterzuladen.

      Ein Tokendatensatz wird in der Tokenliste angezeigt.

      Tokengenerierung

    6. Teilen Sie das Token mit den VDA-Installationsadministratoren.

      Weitere Informationen zur Installation von VDA und einem Token auf Maschinen finden Sie unter VDAs installieren.

    Token verwalten

    Sie haben zwei Möglichkeiten, ein Token zu widerrufen und es für die VDA-Registrierung nicht verfügbar zu machen:

    • Widerrufen: Widerrufen Sie das Token, behalten Sie es jedoch zu Protokollierungszwecken in der Liste.
    • Löschen: Widerrufen Sie das Token und löschen Sie es aus der Liste.

    Hinweis:

    Abgelaufene Token werden nach 14 Tagen automatisch gelöscht.

    Registrieren Sie Maschinen mit dem WebSocket VDA-Registrierungstool für Kataloge

    Das WebSocket VDA-Registrierungstool erleichtert die tokenbasierte Registrierung für VDA-Maschinen. Mit diesem Tool können Sie eine Verbindung in eine WebSocket-Verbindung konvertieren, indem Sie den VDA mit dem Registrierungstoken zum Maschinenkatalog hinzufügen.

    Hinweis:

    Dieses Tool dient zur Registrierung von VDA-Maschinen, die in keinem Maschinenkatalog registriert wurden.

    Folgen Sie den Anweisungen, um das Registrierungstool auszuführen:

    1. Melden Sie sich beim VDA an.
    2. Suchen Sie das Tool EnrollMachine.exein C:\Programme\Citrix\Virtual Desktop Agent\Web Socket Vda Enrollment Tool.
    3. Führen Sie das Werkzeug mit den entsprechenden Eingabeparametern aus. Beispiel: EnrollMachine.exe -websocket_token_string:xxxxxxxxx

    In der folgenden Tabelle werden die Eingabeparameter des Registrierungstools beschrieben:

    Parametername Erforderlich Beschreibung Beispiel
    -websocket_token_stdin Ja

    		Liest das Registrierungstoken. .\EnrollMachine.exe -websocket_token_stdin
    -websocket_token_string Liest das Registrierungstoken direkt aus dem Befehlszeilenparameter. .\EnrollMachine.exe -websocket_token_string:<token>
    -websocket_token_file:[token-file-path] Liest das Registrierungstoken aus dem angegebenen Pfad. .\EnrollMachine.exe -websocket_token_file:C:\token\test2.txt
    log:[log-file-path] Nein Zeigt die Protokolle des Registrierungstools an. .\EnrollMachine.exe log:[C:\ProgramData\Citrix\EnrollMachine\EnrollMachine.txt]
    -help Nein Zeigt einen kurzen Hilfetext an. .\EnrollMachine.exe -help

    Nach erfolgreicher Registrierung erhalten Sie eine Erfolgsmeldung im Tool und in den Protokollen. Achten Sie darauf, sich bei Web Studio anzumelden, um sicherzustellen, dass die VDA-Maschine zum Katalog hinzugefügt wurde und der Status der Maschine registriert ist.

    Problembehandlung

    Standardmäßig finden Sie die Protokolle des Registrierungstools unter:

    C:\ProgramData\Citrix\EnrollMachine\EnrollMachine.txt

    Wenn Sie einen anderen Pfad für die Protokolle angegeben haben, können Sie log:[log-file-path] verwenden, um Ihre Protokolle abzurufen.

    In der folgenden Tabelle sind die vom Registrierungstool zurückgegebenen Codes aufgeführt:

    Code Zeichenfolge Beschreibung
    0 Erfolg Der VDA wurde erfolgreich zum Maschinenkatalog hinzugefügt.
    -1 InvalidArgument Der Eingabeparameter im Registrierungstoken ist ungültig.
    -2 BrokerAgentNotFound Der Broker-Agent-Service wurde nicht gefunden.
    -3 TokenInvalid Das eingegebene Token ist ungültig.
    -4 TokenMissingRequiredClaims Die erforderlichen Ansprüche für das Token fehlen, z. B. CustomerId oder Enrollment URIs.
    -5 InternalError Ein allgemeiner Fehler ist aufgetreten.
    -6 TimedOut Für die Aufgabe ist ein Timeout aufgetreten.
    -7 FailedToDetermineMachineADJoinedStatus Der Dienst, der den Status “AD Joined” des Computers zurückgibt, ist fehlgeschlagen.
    -8 ADMachineFailedToFindSid Der Dienst, der die AD-Computer-Sid zurückgibt, ist fehlgeschlagen.
    -9 EnrollRequestFailed Die Anfrage ist aufgrund eines HTTP-Fehlers fehlgeschlagen.
    -10 EnrollResponseMissingRequiredFields In der Antwort des Registrierungstools fehlt der Parameter VirtualSiteId.
    -11 InsufficientPermission Sie haben nicht die erforderliche Berechtigung, um die Aufgabe auszuführen.
    -12 FailedToDetermineMachineAadJoinedStatus Der Dienst, der den AD-Join-Status des Computers überprüft, gibt einen Fehler aus.
    -13 AadMachineFailedToFindDeviceId Der vom System hinzugefügte zusätzliche Parameter AAD-Geräte-ID ist leer.
    -14 AadDeviceIdNotValid Der vom System hinzugefügte zusätzliche Parameter AAD-Geräte-ID ist keine gültige GUID.
    -15 NoValidMacAddress Ungültige MAC-Adresse.
    -16 FailedToGetComputerHostNameForVdaInstanceName Der Computerhostname zum Festlegen des zusätzlichen Parameters VdaInstanceName konnte nicht abgerufen werden.
    -17 VirtualDesktopAgentRegistryKeyFailedToOpen Der VDA-Registrierungsschlüssel konnte nicht geöffnet werden, um die Liste der Delivery Controller zu schreiben.
    -18 Das fehlgeschlagene Token hat die maximale Anzahl erreicht Das fehlgeschlagene Token hat die maximale Anzahl erreicht.

    PowerShell verwenden

    In diesem Abschnitt wird beschrieben, wie Sie Kataloge mit PowerShell verwalten:

    Mit einem Katalog verknüpfte Warnungen und Fehler abrufen

    Sie können historische Fehler und Warnungen abrufen, um Probleme mit Ihrem MCS-Maschinenkatalog zu diagnostizieren und zu beheben.

    Mithilfe von PowerShell-Befehlen können Sie:

    • eine Liste der Fehler und Warnungen abrufen
    • Status von Warnungen von New in Acknowledged ändern
    • Fehler oder Warnungen löschen

    So führen Sie die PowerShell-Befehle aus:

    1. Öffnen Sie ein PowerShell-Fenster.
    2. Führen Sie asnp citrix* aus, um die Citrix-spezifischen PowerShell-Module zu laden.

    So rufen Sie eine Liste der Fehler und Warnungen ab:

    Führen Sie den Befehl Get-ProvOperationEvent aus.

    • Ohne Parameter: Ruft alle Fehler und Warnungen ab.
    • Mit LinkedObjectType- und LinkedObjectUid-Parameter: Ruft alle Fehler und Warnungen ab, die mit einem bestimmten Bereitstellungsschema verknüpft sind
    • Mit dem Parameter EventId: Ruft einen bestimmten Fehler oder eine Warnung ab, der oder die dieser Ereignis-ID entspricht
    • Mit Filter-Parameter: Ruft Fehler oder Warnungen durch benutzerdefinierten Filter ab

    Statusänderung von Fehlern oder Warnungen von Neu in Quittiert:

    Führen Sie den Befehl Confirm-ProvOperationEvent aus.

    • Mit dem Parameter EventId: Legt den Status eines bestimmten Fehlers oder einer bestimmten Warnung fest, der/die mit dieser Ereignis-ID übereinstimmt. Sie können die EventId eines bestimmten Fehlers oder einer Warnung als Ausgabe des Befehls Get-ProvOperationEvent abrufen
    • Mit den Parametern LinkedObjectType und LinkedObjectUid: Legt den Status aller Fehler und Warnungen fest, die mit einem bestimmten Bereitstellungsschema verknüpft sind.
    • Mit Alle-Parameter: Setzt den Status aller Fehler und Warnungen auf Bestätigt

    Fehler oder Warnungen löschen:

    Führen Sie den Befehl Remove-ProvOperationEvent aus.

    • Mit dem Parameter EventId: Entfernt einen bestimmten Fehler oder eine Warnung, der oder die dieser Ereignis-ID entspricht. Sie können die EventId eines bestimmten Fehlers oder einer Warnung als Ausgabe des Befehls Get-ProvOperationEvent abrufen
    • Mit den Parametern LinkedObjectType und LinkedObjectUid: Entfernt alle Fehler und Warnungen, die mit einem bestimmten Bereitstellungsschema verbunden sind
    • Mit Alle-Parameter: Entfernt alle Fehler und Warnungen

    Weitere Informationen finden Sie unter Citrix PowerShell SDK.

    Maschinen ohne Hypervisor-Zugriff löschen

    Beim Löschen einer VM oder eines Provisioningschemas müssen die Maschinenerstellungsdienste (MCS) Tags von der VM und manchmal auch vom Basisdatenträger entfernen, damit die in den Löschoptionen enthaltenen Ressourcen nicht mehr von MCS verfolgt oder identifiziert werden. Auf einige dieser Ressourcen kann jedoch nur über den Hypervisor zugegriffen werden. Verwenden Sie die Option PurgeDBOnly in Remove-ProvVM PowerShell, um VM-Ressourcenobjekte wie VM, Basisdatenträger, Image in ACG usw. aus der Datenbank zu löschen, auch wenn kein Hypervisor-Zugriff besteht.

    Diese Option ist aktiviert für:

    • Alle unterstützten Hypervisors
    • Persistente und nicht persistente VMs

    Einschränkungen

    Sie können die Befehle -PurgeDBOnly und -ForgetVM nicht gleichzeitig verwenden.

    Befehl PurgeDBOnly verwenden

    Beim Ausführen des PowerShell-Befehls Remove-ProvVM -ProvisioningSchemeName SCVMM-MC -VMName SCVMM01 -ForgetVM kann der Löschvorgang in den folgenden Szenarien fehlschlagen:

    • Die Hostverbindung ist im Wartungsmodus
    • Ungültige Anmeldeinformationen
    • Authentifizierungsfehler
    • Nicht autorisierter Betrieb
    • Der Hypervisor ist nicht erreichbar

    Hinweis:

    Remove-provVM -ForgetVM zielt nur auf persistente VMs ab. Wenn eine der VMs in der Liste nicht persistent ist, schlägt der Vorgang fehl.

    Wenn der Vorgang fehlschlägt, weil der Hypervisor nicht erreichbar ist, wird die Folgendes angezeigt:

    Try to use -PurgeDBOnly option to clean DDC database.

    Verwenden Sie die Option -PurgeDBOnly im PowerShell-Befehl Remove-ProvVM, um Referenzen einer VM aus der MCS-Datenbank zu löschen. Beispiel:

    Remove-ProvVM -ProvisioningSchemeName SCVMM-MC -VMName SCVMM01 -PurgeDBOnly

    Beschreibungen zu einem Bild hinzufügen

    Sie können Informationen zu Änderungen im Zusammenhang mit Imageupdates für Maschinenkataloge hinzufügen. Mit dem Feature können Sie beim Erstellen eines Katalogs oder beim Aktualisieren eines bestehenden Masterimages für einen Katalog eine Beschreibung hinzufügen. Sie können auch Informationen für jedes Masterimage im Katalog anzeigen. Verwenden Sie die folgenden Befehle, um Imagebeschreibungen hinzuzufügen oder anzuzeigen:

    • Um beim Erstellen eines Maschinenkatalogs mit einem Masterimage eine Notiz hinzuzufügen, verwenden Sie den Parameter MasterImageNote im Befehl NewProvScheme. Beispiel:

         C:\PS>New-ProvScheme -ProvisioningSchemeName <name> -HostingUnitName <name> -IdentityPoolName <name> -MasterImageVM
 XDHyp:\HostingUnits\<hosting unit name>\<vm name>.vm\Base.snapshot -MasterImageNote "Note"
 <!--NeedCopy-->

    • Um das mit einem Maschinenkatalog verknüpfte Masterimage zu aktualisieren, verwenden Sie den Parameter MasterImageNote im Befehl Publish-ProvMasterVMImage. Beispiel:

         C:\PS>Publish-ProvMasterVMImage -ProvisioningSchemeName <name> -MasterImageVM XDHyp:\HostingUnits\<hosting unit name>\<vm name>.vm\base.snapshot -MasterImageNote "Note"
 <!--NeedCopy-->

    • Um die Informationen für jedes Image anzuzeigen, verwenden Sie den Befehl Get-ProvSchemeMasterVMImageHistory. Beispiel:

         C:\PS>Get-ProvSchemeMasterVMImageHistory -ProvisioningSchemeName MyScheme -Showall
 <!--NeedCopy-->

    Um den Rollback-Fortschritt zu verfolgen, suchen Sie den Katalog in Maschinenkatalogen, damit der Fortschrittsbalken und das Fortschrittsdiagramm angezeigt werden.

    In folgenden Szenarios ist kein Rollback möglich. (Die Option Masterimage zurücksetzen ist nicht sichtbar).

    • Sie sind nicht zum Rollback berechtigt.
    • Der Katalog wurde nicht mit MCS erstellt.
    • Der Katalog wurde mit einem Image des OS-Datenträgers erstellt.
    • Der zum Erstellen des Katalogs verwendete Snapshot ist beschädigt.
    • Benutzeränderungen an den Maschinen im Katalog werden nicht beibehalten.
    • Die im Katalog aufgeführten Maschinen sind betriebsbereit.

    OS-Datenträger zurücksetzen

    Verwenden Sie den PowerShell-Befehl Reset-ProvVMDisk, um den OS-Datenträger einer persistenten VM in einem von MCS erstellten Maschinenkatalog zurückzusetzen. Derzeit gilt dieses Feature für AWS, Azure, XenServer und Google Cloud. SCVMM- und VMware-Virtualisierungsumgebungen.

    Um den PowerShell-Befehl erfolgreich auszuführen, stellen Sie Folgendes sicher:

    • Die Ziel-VMs befinden sich in einem persistenten MCS-Katalog.
    • Der MCS-Maschinenkatalog funktioniert ordnungsgemäß.
    • Dies setzt voraus, dass das Bereitstellungsschema und der Host vorhanden sind und das Bereitstellungsschema über korrekte Einträge verfügt.
    • Der Hypervisor befindet sich nicht im Wartungsmodus.
    • Ziel-VMs sind ausgeschaltet und im Wartungsmodus.

    Führen Sie die folgenden Schritte aus, um den OS-Datenträger zurückzusetzen:

    1. Öffnen Sie ein PowerShell-Fenster.
    2. Führen Sie asnp citrix* aus, um die Citrix-spezifischen PowerShell-Module zu laden.

    3. Führen Sie den PowerShell-Befehl Reset-ProvVMDisk auf eine der folgenden Arten aus:

      • Geben Sie die Liste der VMs als Komma-getrennte Liste an und führen Sie den Reset für jede VM durch:

           Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName ("abc","def") -OS
 <!--NeedCopy-->

      • Geben Sie die Liste der VMs als Ausgabe des Befehls Get-ProvVM an und führen Sie den Reset auf jeder VM aus:

           (Get-ProvVM -ProvisioningSchemeName "xxx") | Reset-ProvVMDisk "abc" -OS
 <!--NeedCopy-->

      • Geben Sie eine einzelne VM anhand des Namens an:

           Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS
 <!--NeedCopy-->

      • Erstellen Sie separate Reset-Aufgaben für jede der VMs, die vom Befehl Get-ProvVM zurückgegeben werden. Dies ist weniger effizient, da jede Aufgabe dieselben redundanten Prüfungen durchführt (z. B. Hypervisor-Funktionsprüfung und Verbindungsprüfung).

           Get-ProvVM -ProvisioningSchemeName "xxx" | Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -OS
 <!--NeedCopy-->

    4. Es wird eine Bestätigungsaufforderung angezeigt, in der die zurückzusetzenden VMs aufgelistet sind, sowie eine Warnmeldung, dass der Vorgang nicht wiederherstellbar ist. Wenn Sie keine Antwort eingeben und Enterdrücken, erfolgt keine weitere Aktion.

      Hinweis:

      Nehmen Sie VMs nicht aus dem Wartungsmodus und schalten Sie sie nicht ein, bis der Zurücksetzungsvorgang abgeschlossen ist.

      Sie können den PowerShell-Befehl -WhatIf ausführen, um die auszuführende Aktion auszudrucken und das Programm zu beenden, ohne die Aktion auszuführen.

      Sie können die Bestätigungsaufforderung auch mit einer der folgenden Methoden umgehen:

      • Geben Sie den Parameter -Force an:

           Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Force
 <!--NeedCopy-->

      • Geben Sie den Parameter -Confirm:$false an:

           Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Confirm:$false
 <!--NeedCopy-->

      • Bevor Sie Reset-ProvVMDisk ausführen, ändern Sie $ConfirmPreference in None:

           PS C:\Windows\system32> $ConfirmPreference='None'
 PS C:\Windows\system32> $ConfirmPreference
 None
 PS C:\Windows\system32> Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS
 <!--NeedCopy-->
    5. Führen Sie Get-ProvTask aus, um den Status der Aufgaben abzurufen, die vom Befehl Reset-ProvVMDisk zurückgegeben werden.

    Ändern der Netzwerkeinstellung für ein vorhandenes Provisioningschema

    Sie können die Netzwerkeinstellung für ein vorhandenes Provisioningschema ändern, sodass die neuen VMs im neuen Subnetz erstellt werden. Verwenden Sie den Parameter -NetworkMapping im Befehl Set-ProvScheme, um die Netzwerkeinstellung zu ändern.

    Hinweis:

    Dieses Feature wird auf Citrix Virtual Apps and Desktops 2203 LTSR CU3 und späteren Versionen unterstützt.

    Führen Sie folgende Schritte aus, um die Netzwerkeinstellung für ein vorhandenes Provisioningschema zu ändern:

    1. Führen Sie im PowerShell-Fenster den Befehl asnp citrix* aus, um die PowerShell-Module zu laden.
    2. Führen Sie (Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps aus, um zum Netzwerkpfad zu gelangen, den Sie ändern möchten.

    3. Weisen Sie der neuen Netzwerkeinstellung eine Variable zu. Beispiel:

        $NewNetworkMap = @{"0"= "XDHYP:\HostingUnits\MyNetworks\Network 0.network"}
<!--NeedCopy-->
    4. Führen Sie Set-ProvScheme -ProvisioningSchemeName "name" -NetworkMapping $NewNetworkMap aus.
    5. Führen Sie (Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps aus, um die neue Netzwerkeinstellung für das vorhandene Bereitstellungsschema zu überprüfen.

    Versionen eines Maschinenkatalogs verwalten

    Wenn ein MCS-Maschinenkatalog mit dem Befehl Set-ProvScheme aktualisiert wird, wird die aktuelle Konfiguration als Version gespeichert. Anschließend können Sie die verschiedenen Versionen des Maschinenkatalogs mit PowerShell-Befehlen verwalten. Sie haben folgende Möglichkeiten:

    • Sehen Sie sich die Liste der Versionen eines Maschinenkatalogs an
    • Verwenden Sie eine beliebige frühere Version, um den Maschinenkatalog zu aktualisieren
    • Löschen Sie eine Version manuell, wenn sie nicht von einer VM dieses Maschinenkatalogs verwendet wird
    • Ändern Sie die maximale Anzahl der Versionen, die vom Maschinenkatalog beibehalten werden sollen (Standard ist 99).

    Eine Version enthält die folgenden Informationen eines Maschinenkatalogs:

    • VMCpuCount
    • VMMemoryMB
    • CustomProperties
    • ServiceOffering
    • MachineProfile
    • NetworkMapping
    • SecurityGroup

    Führen Sie die folgenden Befehle (Beispiele werden angezeigt) aus, um die verschiedenen Versionen eines Maschinenkatalogs zu verwalten.

    • So zeigen Sie die Konfigurationsdetails der verschiedenen Versionen eines Maschinenkatalogs an:

         Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog
 <!--NeedCopy-->

    • So zeigen Sie die Konfigurationsdetails einer bestimmten Version eines Maschinenkatalogs an:

         Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 2
 <!--NeedCopy-->

    • So zeigen Sie die Gesamtzahl der mit einem Maschinenkatalog verknüpften Versionen an:

         (Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog).Count
 <!--NeedCopy-->

    • So aktualisieren Sie den Maschinenkatalog mit einer früheren Version:

         Set-ProvScheme -ProvisioningSchemeName AzureCatalog -Version 2
 <!--NeedCopy-->

    • So löschen Sie eine Version manuell, wenn sie nicht von einer VM dieses Maschinenkatalogs verwendet wird:

         Remove-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 3
 <!--NeedCopy-->

    • So legen Sie die maximale Anzahl von Versionen fest, die vom Maschinenkatalog beibehalten werden sollen (Standardeinstellung ist 99). Diese Einstellung wird auf alle Kataloge angewendet. In diesem Fall werden beispielsweise maximal 15 Versionen für alle von MCS bereitgestellten Kataloge beibehalten.

         Set-ProvServiceConfigurationData -Name "MaxProvSchemeVersions" -Value 15
 <!--NeedCopy-->

    Wenn die Anzahl der Versionen die maximale Anzahl erreicht, kann keine neue Version erstellt werden, solange ältere Versionen von einer der virtuellen Maschinen im Maschinenkatalog verwendet werden. Führen Sie in diesem Fall einen der folgenden Schritte aus:

    • Erhöhen Sie das Limit für die maximale Anzahl von Versionen, die im Maschinenkatalog aufbewahrt werden sollen.
    • Aktualisieren Sie einige VMs, die sich auf älteren Versionen befinden, sodass diese älteren Versionen von keiner VM mehr referenziert werden und gelöscht werden können.

    Maschinenkatalog, der nicht auf Maschinenprofilen basiert, in einen auf einem Maschinenprofil basierenden Maschinenkatalog in einer Azure-Umgebung konvertieren

    Sie können eine VM, eine Vorlagenspezifikation (Azure) oder eine Startvorlage (AWS) als Maschinenprofileingabe verwenden, um einen Maschinenkatalog, der nicht auf Maschinenprofilen basiert, in einen auf einem Maschinenprofil basierenden Maschinenkatalog zu konvertieren. Neue virtuelle Maschinen, die dem Katalog hinzugefügt werden, übernehmen Eigenschaftswerte aus dem Maschinenprofil, sofern sie nicht durch eine explizite benutzerdefinierte Eigenschaft überschrieben werden.

    Hinweis:

    Ein Maschinenkatalog, der auf einem Maschinenprofil basiert, kann nicht in einen Maschinenkatalog geändert werden, der nicht auf einem Maschinenprofil basiert.

    Vorgehensweise:

    1. Erstellen Sie einen persistenten oder nicht persistenten Maschinenkatalog mit VMs und ohne Maschinenprofil.
    2. Öffnen Sie das PowerShell-Fenster.

    3. Führen Sie den Befehl Set-ProvScheme aus, um die Eigenschaftswerte aus dem Maschinenprofil auf die neuen VMs anzuwenden, die dem Maschinenkatalog hinzugefügt wurden. Beispiel:

      • Azure:

           Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile XDHyp:\HostingUnits\<HostingUnitName>\machineprofile.folder\<ResourceGroupName>\<TemplateSpecName>\<VersionName>
 <!--NeedCopy-->

      • AWS:

           Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\<launch-template>.launchtemplate\<launch-template-version>.launchtemplateversion"
 <!--NeedCopy-->

    Identitätsinformationen aktiver Computerkonten reparieren

    Sie können die Identitätsinformationen von aktiven Computerkonten mit Identitätsproblemen zurücksetzen. Sie können wählen, ob Sie nur das Maschinenkennwort und die vertrauenswürdigen Schlüssel-IDs oder die gesamte Konfiguration des Identitätsdatenträgers zurücksetzen möchten. Diese Implementierung gilt für persistente und nicht persistente MCS-Maschinenkataloge.

    Hinweis:

    Derzeit wird das Feature für AWS-, GCP-, Azure-, SCVMM-, XenServer- und VMware-Virtualisierungsumgebungen unterstützt.

    Bedingungen

    Achten Sie auf Folgendes, um den Identitätsdatenträger erfolgreich zurückzusetzen:

    • Schalten Sie die VM aus und versetzen Sie sie in den Wartungsmodus.
    • Verwenden Sie nicht den Parameter “-OS” im PowerShell-Befehl.

    Identitätsdatenträger zurücksetzen

    Gehen Sie zum Zurücksetzen des Identitätsdatenträgers folgendermaßen vor:

    1. Öffnen Sie das PowerShell-Fenster.
    2. Führen Sie asnp citrix* aus, um die Citrix-spezifischen PowerShell-Module zu laden.

    3. Setzen Sie die Identitätsinformationen zurück.

      • Um nur das Maschiinenkennwort und die Vertrauensschlüssel zurückzusetzen, führen Sie den folgenden Befehl aus:

           Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo
 <!--NeedCopy-->

        Die Beschreibung der im Befehl verwendeten Parameter lautet wie folgt:

        • IdentityAccountName: Der Name des Identitätskontos, das repariert werden muss.
        • PrivilegedUserName: Benutzerkonto mit Schreibberechtigung für den Identitätsanbieter (AD oder AzureAD).
        • PrivilegedUserPassword: Kennwort für PrivilegedUserName.
        • Ziel: Ziel für die Reparaturaktion. Dies kann IdentityInfo zur Reparatur von Kontokennwort/Vertrauensschlüssel sein und UserCertificate für Benutzerzertifikatattribute von Maschinenidentitäten mit Hybrid-AzureAD-Verbindung.

      • Um die gesamte Konfiguration des Identitätsdatenträgers zurückzusetzen, führen Sie die folgenden Befehle in der angegebenen Reihenfolge aus:

           Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo
 <!--NeedCopy-->

           Reset-ProvVMDisk ProvisioningSchemeName <name> -VMName <name>  -Identity
 <!--NeedCopy-->

      • So erstellen Sie den Identitätsdatenträger vollständig neu:

           Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMname <name> -Identity -Recreate
 <!--NeedCopy-->

    4. Geben Sie y ein, um die Aktion zu bestätigen. Sie können die Bestätigungsaufforderung auch mit dem Parameter -Force überspringen. Beispiel:

        Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMName <name> -Identity -Force
<!--NeedCopy-->
    5. Führen Sie Get-ProvVM -ProvisioningSchemeName &lt;name -VMName &lt;name&gt; aus, um die aktualisierte Identitätsdisk-Einstellung zu überprüfen. Die Attribute des Identitätsdatenträgers (z. B. IdentityDiskId) müssen aktualisiert werden. StorageId und IdentityDiskIndex dürfen sich nicht ändern.

    Cachekonfiguration eines Maschinenkatalogs ändern

    Nach der Erstellung eines nicht persistenten Katalogs mit aktiviertem MCSIO können Sie mit dem Befehl “Set-ProvScheme” die folgenden Parameter ändern:

    • WriteBackCacheMemorySize
    • WriteBackCacheDiskSize

    Das Feature gilt derzeit für:

    • GCP- und Microsoft Azure-Umgebungen sowie
    • nicht persistenten Katalog mit aktiviertem MCSIO

    Anforderungen

    Anforderungen zum Ändern der Cachekonfiguration:

    • Update auf die neueste VDA-Version (2308 oder höher).

    • Aktivieren Sie den Parameter UseWriteBackCache für den vorhandenen Maschinenkatalog. Verwenden Sie New-ProvScheme, um einen Maschinenkatalog mit aktiviertem UseWriteBackCache zu erstellen. Beispiel:

         New-ProvScheme -ProvisioningSchemeName $CatalogName -HostingUnitUid $HostingUnitUid `
 -IdentityPoolUid $acctPool.IdentityPoolUid -CleanOnBoot `
 -MasterImageVM $MasterImage `
 -ServiceOffering $ServiceOffering `
 -NetworkMap $NetworkMap `
 -SecurityGroup $SecurityGroup `
 -UseWriteBackCache -WriteBackCacheDiskSize 8
 <!--NeedCopy-->

    Cachekonfiguration ändern

    Führen Sie den Befehl Set-ProvScheme aus. Beispiel:

      Set-ProvScheme -ProvisioningSchemeName $provScheme.ProvisioningSchemeName -WriteBackCacheDisk32 -WriteBackCacheMemorySize 128
<!--NeedCopy-->

    Hinweis:

    • Der Wert von WriteBackCacheDiskSize muss größer als Null sein, da mindestens 1 GB Cache-Datenträgerspeicher erforderlich ist.
    • Der Wert von WriteBackCacheMemorySize muss kleiner sein als die Speichergröße des Maschinenkatalogs.
    • Diese Änderungen werden nur auf neue VMs anwendet, die dem Katalog hinzugefügt wurden, nachdem die Änderung vorgenommen wurde. Bestehende VMs sind von diesen Änderungen nicht betroffen.

    VDA-Aktualisierungsunterstützung über lokalen Dateifreigabezugriff

    Geben Sie den Speicherort des VDA-Installationsprogramms mit PowerShell-Cmdlets an, sodass Sie weniger Netzwerkregeln bereitstellen müssen, damit jeder VDA das neue VDA-Installationsprogramm vom Citrix Managed Azure CDN abrufen kann.

    PowerShell-Cmdlets

    Den Cmdlets New-VusCatalogSchedule und New-VusMachineUpgrade wurden zwei neue optionale Parameter hinzugefügt, mit denen Sie Installationsprogramme von einer lokalen Dateifreigabe aus verwenden können.

    • VdaWorkstationPackageUri: um den UNIC-Pfad zum VDA-Installationsprogramm für Arbeitsstationsbetriebssysteme anzugeben
    • VdaServerPackageUri: um den UNC-Pfad zum VDA-Installationsprogramm für das Serverbetriebssystem anzugeben

    Voraussetzungen

    • VUS Agent-Installationsprogramm, das im Lieferumfang von VDA 2311 enthalten ist
    • VDA Upgrade Agent auf Version 7.40.0.35 oder höher (mit dem VDA-Installationsprogramm Version 2311 oder höher)
    • Virtual Apps and Desktops Remote PowerShell SDK Version 7.40 oder höher (veröffentlicht am 10. Januar 2024 oder später)

    So legen Sie Dateifreigabeberechtigungen fest

    Die Netzwerkfreigaben, die VDA-Installationspakete enthalten, müssen Lesezugriff für den VDA Upgrade Agent-Dienst haben, der als Lokales System (NT AUTHORITY\SYSTEM-Prinzipal) ausgeführt wird.

    • Freigabeberechtigung für Dateien, die in eine Domäne eingebunden sind

      Wenn die VDA-Maschine einer Domäne beigetreten ist, verwendet das lokale Systemkonto (VUA wird als lokales System ausgeführt) Computeranmeldeinformationen für den Zugriff auf Netzwerkfreigaben.

      Die geringste Berechtigung kann festgelegt werden, indem Domänencomputern Lesezugriff gewährt wird.

      1. Wählen Sie Personen in Ihrem Netzwerk aus, für die Sie die Datei freigeben möchten.
      2. Klicken Sie auf Erweiterte Freigabeeinstellungen und aktivieren Sie die Datei- und Druckerfreigabe.

    • Erlaubnis zur Freigabe von Dateien, die nicht mit einer Domäne verbunden sind

      Wenn die VDA-Maschine nicht in eine Domäne eingebunden ist, verwendet das lokale Systemkonto (VUA wird als lokales System ausgeführt) ANONYMOUS LOGON, wenn auf Netzwerkfreigaben zugegriffen wird.

      1. Wählen Sie einen freigegebenen Ordner aus.
      2. Deaktivieren Sie den Kennwortschutz.
        1. Gehen Sie zum Ordner Eigenschaften.
        2. Wählen Sie Netzwerk- und Freigabecenter aus.
        3. Schalten Sie Kennwortgeschützte Freigabe aus.
      3. Klicken Sie auf Erweiterte Freigabe, um eine Freigabeberechtigung zu erteilen.
        1. Wählen Sie Berechtigungen.
        2. Erteilen Sie ANONYMOUS LOGON eine Freigabe-Leseberechtigung.
      4. Wählen Sie die Registerkarte Sicherheit, um Ordnerberechtigungen zu gewähren
        1. Klicken Sie auf Bearbeiten, um dem freigegebenen Ordner Berechtigungen hinzuzufügen.
        2. Wählen Sie den freigegebenen Ordner aus, um ANONYMOUS LOGON Ordnerberechtigungen zu gewähren.
      5. Klicken Sie auf Erweitert, um die Datei- und Druckerfreigabe zu aktivieren.
      6. Fügen Sie den Namen des freigegebenen Ordners zur Netzwerkzugriffssicherheitsrichtlinie hinzu.

      Hinweis:

      Starten Sie Ihre Maschine neu, damit die Änderung sofort wirksam wird.

    VDA-Updates von einer lokalen Dateifreigabe

    1. Laden Sie das VDA-Installationsprogramm herunter und platzieren Sie es in der freigegebenen Datei.

      Hinweis:

      Mit Virtual Upgrade Service können Sie zwischen dem Titel Current Release oder LTSR-Track wählen.

      Beispiel: Wenn für den Maschinenkatalog die aktuelle Version 2311 festgelegt ist und die VDA-Version 2305 ist, müssen Sie den VDA auf Version 2311 aktualisieren.

      1. Navigieren Sie zur Seite Downloads auf unserer Website.
      2. Wählen Sie Citrix Virtual Apps and Desktops als Produkt aus.
      3. Wählen Sie Citrix Virtual Apps and Desktops 7 2311, alle Editionen aus.
      4. Wählen Sie das VDA-Installationsprogramm aus den Komponenten aus, die sich auf der Produkt-ISO befinden, aber auch separat erweiterbar sind.

    2. Wählen Sie das entsprechende VDA-Installationsprogramm basierend auf dem Katalogtyp aus.

      • Laden Sie das VDA-Installationsprogramm für Multisitzungs-OS herunter, wenn der Katalogtyp Mehrere Sitzungen ist.
      • Laden Sie das VDA-Installationsprogramm für Einzelsitzungs-OS herunter, wenn der Katalogtyp Einzelsitzung ist.
      • Laden Sie das Installationsprogramm des Kernkomponenten-VDA unter Einzelsitzungs-OS-Betriebssystem herunter, wenn der Katalogtyp Remote-PC-Zugriff ist.

    Hinweis:

    Die Version des Fileshare-Installationsprogramms muss genau mit der Version der neuesten Version des Installationsprogramms übereinstimmen, die von VUS in der Cloud veröffentlicht wurde.

    Problembehandlung

    So geht es weiter

    Informationen zum Verwalten bestimmter Cloudservices-Kataloge finden Sie unter:

    Maschinenkataloge verwalten
    May 22, 2025
    Beitrag von: 
    C
    May 22, 2025
    Beitrag von: 
    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.