Maschinenkataloge verwalten

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
• PowerShell verwenden

Web Studio verwenden

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

• Verwalten von Maschinenkatalogen
  • Einführung
  • Informationen zu persistenten Instanzen
• Verwalten von Maschinenkatalogen
• Web Studio verwenden
• Katalogdetails anzeigen
  • Maschinen zum Maschinenkatalog hinzufügen
  • Maschinen aus einem Maschinenkatalog löschen
• Katalog bearbeiten
• Maschinenkataloge umbenennen
• Verschieben eines Maschinenkatalogs in eine andere Zone
• Katalog löschen
• Active Directory-Computerkonten in einem Maschinenkatalog verwalten
• Aktualisieren von Maschinenkatalogen
  • Aktualisieren oder Erstellen eines Masterimages
  • Masterimage ändern
  • Rollback des Masterimages ausführen
• Funktionsebene ändern oder Änderung rückgängig machen
• Kataloge klonen
• Kataloge mit Ordnern organisieren
  • Katalogordner erstellen
  • Katalog verschieben
  • Katalogordner verwalten
• Katalogerstellung erneut versuchen
• VDAs, die nicht von MCS bereitgestellt wurden, mit Token registrieren (Preview)
• PowerShell verwenden
• Mit einem Katalog verknüpfte Warnungen und Fehler abrufen
• Einmaligen Neustart planen
• Beschreibung zu einem Image hinzufügen
• Zurücksetzen des OS-Datenträgers
• Ändern der Netzwerkeinstellung für ein vorhandenes Provisioningschema
• Versionen eines Maschinenkatalogs verwalten
• Maschinenkatalog, der nicht auf Maschinenprofilen basiert, in einen auf einem Maschinenprofil basierenden Maschinenkatalog in einer Azure-Umgebung konvertieren
• Identitätsinformationen aktiver Computerkonten reparieren
  • Bedingungen
  • Identitätsdatenträger zurücksetzen
• Cachekonfiguration eines Maschinenkatalogs ändern
  • Anforderungen
  • Cachekonfiguration ändern
• VDA-Aktualisierungsunterstützung über lokalen Dateifreigabezugriff
  • PowerShell-Cmdlets
  • Voraussetzungen
  • So legen Sie Dateifreigabeberechtigungen fest
  • VDA-Updates von einer lokalen Dateifreigabe
• Problembehandlung
• So geht es weiter

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.

Maschinen zum Maschinenkatalog 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. Beispiel: Das Benennungsschema “PC-Vertrieb-##” (und Aktivieren von 0-9) bewirkt eine Benennung der Computerkonten als “PC-Vertrieb-01”, “PC-Vertrieb-02”, “PC-Vertrieb-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.

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 Netzwerkkarte hinzufügen und dann im Feld Zugeordnetes Netzwerk ein Netzwerk aus. 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.

   • Wählen Sie auf der Seite Maschinenprofil, ob Sie ein Maschinenprofil verwenden oder ändern möchten.

   • (Nur sichtbar, wenn der Katalog mit einer dedizierten Hostgruppen konfiguriert ist) Wählen Sie auf der Seite Dedizierte Hostgruppe aus, ob eine Hostgruppe geändert werden soll.

   • Wählen Sie auf der Seite Speicher- und Lizenztypen aus, ob der Speichertyp, der Lizenztyp und die Azure Compute Gallery-Einstellungen geändert werden sollen (nur verfügbar, wenn Vorbereitetes Image in der Azure Compute Gallery platzieren verwendet wird).

   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.

   • Wählen Sie auf der Seite Lizenztyp, ob Sie die Windows- oder die Linux-Lizenzeinstellung ändern möchten.

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

   • Auf der Seite Energieverwaltung ändern Sie die Energieverwaltungseinstellungen und wählen eine Energieverwaltungsverbindung aus.
   • 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.

Maschinenkataloge 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:

   Für mit MCS erstellte Kataloge können Sie einen Hinweis zu dem Image angeben. 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 das Rollout nur für nicht persistente VMs gilt.

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. Sie müssen manuell heruntergefahren und neu gestartet werden.

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.

Wenn Sie einen einmaligen Neustart mithilfe von PowerShell planen möchten, konsultieren Sie den Abschnitt Einmaligen Neustart planen.

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, um den Fortschrittsbalken und das Fortschrittsdiagramm anzuzeigen.

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 erhält den Namen des Originals und hat das Suffix Copy. 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.

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 nach einem nicht von MCS bereitgestellten Katalog, für den in der Spalte Maschinenanzahl die Option Provisioningmethode: 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.

   

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.exe in C:\Program Files\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:

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] zum Abrufen Ihrer Protokolle verwenden.

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

PowerShell verwenden

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

• Mit einem Katalog verknüpfte Warnungen und Fehler abrufen
• Einmaligen Neustart planen
• Beschreibung zu einem Image hinzufügen
• Zurücksetzen des OS-Datenträgers
• Ändern der Netzwerkeinstellung für ein vorhandenes Provisioningschema
• Versionen eines Maschinenkatalogs verwalten
• Maschinenkatalog, der nicht auf Maschinenprofilen basiert, in einen auf einem Maschinenprofil basierenden Maschinenkatalog in einer Azure-Umgebung konvertieren
• Identitätsinformationen aktiver Computerkonten reparieren
• Cachekonfiguration eines Maschinenkatalogs ändern
• VDA-Aktualisierungsunterstützung über lokalen Dateifreigabezugriff

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

Ausführen der PowerShell-Befehle:

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

Um eine Liste der Fehler und Warnungen abzurufen:

Führen Sie den Befehl Get-ProvOperationEvent aus.

• Ohne Parameter: Ruft alle Fehler und Warnungen ab.
• Mit den Parametern LinkedObjectType und LinkedObjectUid: Ruft alle Fehler und Warnungen, die mit einem bestimmten Provisioningschema verknüpft sind, ab.
• Mit Parameter EventId: Ruft den Fehler bzw. die Warnung mit der entsprechenden Ereignis-ID ab.
• Mit Parameter Filter: Ruft Fehler oder Warnungen unter Anwendung eines benutzerdefinierten Filters ab.

Statusänderung von Fehlern oder Warnungen von New in Acknowledged:

Führen Sie den Befehl Confirm-ProvOperationEvent aus.

• Mit Parameter EventId: Legt den Status des Fehlers bzw. der Warnung mit der entsprechenden Ereignis-ID ab. Sie können die EventId eines Fehlers oder einer Warnung als Ausgabe des Befehls Get-ProvOperationEvent abrufen.
• Mit den Parametern LinkedObjectType und LinkedObjectUid: Legt den Status aller Fehler und Warnungen, die mit einem bestimmten Provisioningschema verknüpft sind, fest.
• Mit Parameter All: Setzt den Status aller Fehler und Warnungen auf Acknowledged.

Fehler oder Warnungen löschen:

Führen Sie den Befehl Remove-ProvOperationEvent aus.

• Mit Parameter EventId: Entfernt den Fehler bzw. die Warnung mit der entsprechenden Ereignis-ID. Sie können die EventId eines Fehlers oder einer Warnung als Ausgabe des Befehls Get-ProvOperationEvent abrufen.
• Mit den Parametern LinkedObjectType und LinkedObjectUid: Löscht alle Fehler und Warnungen, die mit einem bestimmten Provisioningschema verknüpft sind.
• Mit Parameter All: Löscht 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 für Remove-ProvVM in 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 Szenarios 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 mit dem PowerShell-Befehl Remove-ProvVM, um Referenzen einer VM aus der MCS-Datenbank zu löschen. Beispiel:

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

Einmaligen Neustart planen

Wenn Sie mit PowerShell einen einmaligen Neustart planen möchten, verwenden Sie die folgenden PowerShell-Befehle für BrokerCatalogRebootSchedule, um den Plan für einen Neustart zu erstellen, zu ändern und zu löschen:

• Get-BrokerCatalogRebootSchedule
• New-BrokerCatalogRebootSchedule
• Set-BrokerCatalogRebootSchedule
• Remove-BrokerCatalogRebootSchedule
• Rename-BrokerCatalogRebootSchedule

Beispiel:

• Neustart der VMs im Katalog BankTellers planen, der am 3. Februar 2022 zwischen 2:00 Uhr und 4:00 Uhr beginnen soll.

   C:\PS> New-BrokerCatalogRebootSchedule -Name BankTellers -CatalogName BankTellers  -StartDate "2022-02-03" -StartTime "02:00" -Enabled $true -RebootDuration 120
   <!--NeedCopy-->
  

• Neustart der VMs im Katalog mit UID 17 planen, der am 3. Februar 2022 zwischen 1:00 Uhr und 5:00 Uhr beginnen soll. Zehn Minuten vor dem Neustart erscheint auf jeder VM in allen Benutzersitzungen ein Warnhinweis mit dem Titel WARNUNG: Ausstehender Neustart und der Nachricht Speichern Sie Ihre Arbeit.

   C:\PS> New-BrokerCatalogRebootSchedule -Name 'Update reboot' -CatalogUid 17 -StartDate "2022-02-03" -StartTime "01:00" -Enabled $true -RebootDuration 240 -WarningTitle "WARNING: Reboot pending" -WarningMessage "Save your work" -WarningDuration 10
   <!--NeedCopy-->
  

• Katalogneustartplan umbenennen von Old Name in New Name.

  C:\PS> Rename-BrokerCatalogRebootSchedule -Name "Old Name" -NewName "New Name"
  <!--NeedCopy-->
  

• Alle Katalogneustartpläne mit UID 1 anzeigen und Zeitplan für den Katalogneustart mit UID 1 in New Name umbenennen.

  C:\PS> Get-BrokerCatalogRebootSchedule -Uid 1 | Rename-BrokerCatalogRebootSchedule -NewName "New Name" -PassThru
  <!--NeedCopy-->
  

• Meldung mit dem Titel WARNUNG: Ausstehender Neustart und der Nachricht Speichern Sie Ihre Arbeit für Katalogneustartplan Accounting einrichten und festlegen, dass die Meldung zehn Minuten vor dem Neustart jeder VM angezeigt wird. Die Meldung wird in jeder Benutzersitzung auf dieser VM angezeigt.

  ``` C:\PS> Set-BrokerCatalogRebootSchedule -Name Accounting -WarningMessage “Speichern Sie Ihre Arbeit” -WarningDuration 10 -WarningTitle “WARNUNG: Ausstehender Neustart”

• Alle deaktivierten Neustartpläne anzeigen und anschließend aktivieren.

   C:\PS> Get-BrokerCatalogRebootSchedule -Enabled $false | Set-BrokerCatalogRebootSchedule -Enabled $true
   <!--NeedCopy-->
  

• Meldung Neustart in %m% Minuten für Katalogneustartplan mit UID 17 einrichten und festlegen, dass die Meldung fünfzehn, zehn und fünf Minuten vor dem Neustart jeder VM angezeigt wird.

   C:\PS> Set-BrokerCatalogRebootSchedule 17 -WarningMessage "Rebooting in %m% minutes." -WarningDuration 15 -WarningRepeatInterval 5
   <!--NeedCopy-->
  

• Zeitzone für den Katalog MyCatalog konfigurieren.

   C:\PS> Set-BrokerCatalog -Name "MyCatalog" -TimeZone <TimeZone>
   <!--NeedCopy-->
  

Beschreibung zu einem Image hinzufügen

Sie können Informationen zu Änderungen im Zusammenhang mit Image-Updates 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:

• Verwenden Sie den Parameter MasterImageNote im Befehl NewProvScheme, um beim Erstellen eines Maschinenkatalogs mit einem Masterimage eine Notiz hinzuzufügen. 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-->
  

• Verwenden Sie den Parameter MasterImageNote im Befehl Publish-ProvMasterVMImage, um das einem Maschinenkatalog zugeordnete Masterimage zu aktualisieren. Beispiel:

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

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

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

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

In folgenden Szenarios ist kein Rollback möglich. (Die Option Rollback für Masterimage ausführen wird nicht angezeigt).

• Sie haben keine Berechtigung zum Rollback.
• Der Katalog wurde nicht mit MCS erstellt.
• Der Katalog wurde mit einem Image des Betriebssystemdatenträgers erstellt.
• Der zum Erstellen des Katalogs verwendete Snapshot ist beschädigt.
• Benutzeränderungen an den Maschinen in dem Katalog bleiben nicht erhalten.
• Maschinen im Katalog werden ausgeführt.

Zurücksetzen des OS-Datenträgers

Verwenden Sie den PowerShell-Befehl Reset-ProvVMDisk, um den OS-Datenträger einer persistenten VM in einem mit MCS erstellten Maschinenkatalog zurückzusetzen. Derzeit gilt diese Funktion 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 einwandfrei.
• Hierfür müssen das Provisioningschema und der Host vorhanden sein und das Provisioningschema über korrekte Einträge verfügen.
• Der Hypervisor ist nicht im Wartungsmodus.
• Die 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 durch Trennzeichen getrennte Liste an und führen Sie das Zurücksetzen auf jeder 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 das Zurücksetzen auf jeder VM durch:

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

   • Geben Sie eine VM mit Namen an:

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

   • Erstellen Sie einen eigenen Reset-Task für jede vom Befehl Get-ProvVM zurückgegebene VM. Dies ist weniger effizient, da jeder Task 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. Eine Bestätigungsaufforderung wird angezeigt, in der die zurückzusetzenden VMs zusammen mit einer Warnmeldung aufgeführt sind, dass es sich um einen nicht umkehrbaren Vorgang handelt. Wenn Sie keine Antwort geben und die Eingabetastedrücken, findet keine weitere Aktion statt.

   Hinweis:

   Nehmen Sie VMs erst nach Abschluss der Zurücksetzung aus dem Wartungsmodus und schalten Sie sie ein.

   Sie können den PowerShell-Befehl -WhatIf ausführen, um die auszuführende Aktion zu drucken und den Vorgang ohne Ausführen der Aktion zu beenden.

   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 zu 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 von Befehl Reset-ProvVMDisk zurückgegebenen Tasks abzurufen.

Ä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:

Diese Funktion 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 Provisioningschema 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 mithilfe von PowerShell-Befehlen verwalten. Sie haben folgende Möglichkeiten:

• Liste der Versionen eines Maschinenkatalogs anzeigen
• Eine frühere Version verwenden, um den Maschinenkatalog zu aktualisieren
• Version manuell löschen, wenn sie nicht von einer VM dieses Maschinenkatalogs verwendet wird
• Maximale Anzahl von Versionen ändern, die vom Maschinenkatalog beibehalten werden sollen (Standardeinstellung 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 Versionen an, die einem Maschinenkatalog zugeordnet sind:

  ``` (Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog).Count

• 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.

Gehen Sie hierzu folgendermaßen vor:

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

   • Azure:

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

   • AWS:

      Set-ProvScheme = 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 nur für AWS-, GCP-, Azure-, XenServer- und VMware-Virtualisierungsumgebungen unterstützt.

Bedingungen

Um den Identitätsdatenträger erfolgreich zurückzusetzen:

• Schalten Sie die VM aus und versetzen Sie sie in den Wartungsmodus.
• Verwendung 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 Maschinenkennwort und Vertrauensschlüssel zurückzusetzen, führen Sie die folgenden Befehle in der Reihenfolge ihrer Aufführung aus:

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

     Die Beschreibungen der Befehlsparameter:

     • IdentityAccountName: 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.
     • Target: 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.

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

     Der Parameter ResetIdentityInfo setzt Folgendes zurück:

     • Kennwort und Vertrauensschlüssel: wenn die VM einer AD-Domäne angehört
     • Nur Vertrauensschlüssel: wenn die VM keiner AD-Domäne angehört
     • Nur Kennwort: Wenn die VM einer AD-Domäne angehört

   • 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-->
     

4. Geben Sie y ein, um die Aktion zu bestätigen. Sie können die Bestätigungsaufforderung auch mithilfe des Parameters -Force auslassen. Beispiel:

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

5. Führen Sie den Befehl Get-ProvVM -ProvisioningSchemeName <name -VMName <name> aus, um die Einstellung des aktualisierten Identitätsdatenträgers zu überprüfen. Die Attribute des Identitätsdatenträgers (z. B. IdentityDiskId) müssen aktualisiert worden sein. 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 persistenter Katalog mit aktiviertem MCSIO

Anforderungen

Anforderungen zum Ändern der Cachekonfiguration:

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

• Aktivieren des Parameters UseWriteBackCache für den Maschinenkatalog. Verwendung von 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 Cachedatenträgerplatz erforderlich ist.
• Der Wert von WriteBackCacheMemorySize muss kleiner als die Speichergröße des Maschinenkatalogs sein.
• 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.
   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

• Empfehlungen für Maschinen mit einem unbekannten Energiezustand finden Sie unter CTX131267.
• Informationen zum Beheben von Problemen bei VMs, für die ständig ein unbekannter Energiezustand angezeigt wird, finden Sie unter How to fix VMs that continuously show an unknown power state.

So geht es weiter

Informationen zum Verwalten bestimmter Cloudservices-Kataloge finden Sie unter:

• AWS-Katalog verwalten
• XenServer-Katalog verwalten
• Google Cloud Platform -Katalog verwalten
• Microsoft Azure-Katalog verwalten
• Microsoft System Center Virtual Machine Manager-Katalog verwalten
• VMware-Katalog verwalten