Installation und Deinstallation

Sie können die Citrix Workspace-App von der Citrix Downloadseite oder der Downloadseite Ihres Unternehmens (falls verfügbar) herunterladen.

Sie können das Paket wie folgt installieren:

• Ausführen eines interaktiven Windows-Installationsassistenten.

  Oder

• Eingeben des Dateinamens des Installationsprogramms, der Installationsbefehle und der Installationseigenschaften über die Befehlszeilenschnittstelle. Informationen zum Installieren der Citrix Workspace-App über die Befehlszeilenschnittstelle finden Sie unter Verwenden von Befehlszeilenparametern.

Hinweis:

Stellen Sie sicher, dass Sie alle erforderlichen Systemanforderungen installiert haben, wie im Abschnitt Systemanforderungen beschrieben.

Installation mit Administrator- und Nicht-Administrator-Rechten:

Benutzer und Administratoren können die Citrix Workspace-App installieren. Sie benötigen nur dann Administratorrechte, wenn Sie die Passthrough-Authentifizierung, Single Sign-On, App Protection und Microsoft Teams VDI Plug-In mit der Citrix Workspace-App für Windows verwenden.

Die folgende Tabelle zeigt die Unterschiede bei der Installation der Citrix Workspace-App als Administrator oder als Benutzer:

Hinweis:

Administratoren können die vom Benutzer installierte Instanz der Citrix Workspace-App überschreiben und die Installation erfolgreich fortsetzen.

Befehl zum Bereinigen und Installieren der Citrix Workspace-App

Verwenden Sie den Befehl /CleanInstall, um alle nach einer Deinstallation verbleibenden Spuren wie Dateien und Registrierungswerte zu entfernen, und die neue Version der Citrix Workspace-App zu installieren.

Beispiel:

CitrixWorkspaceApp.exe /CleanInstall
<!--NeedCopy-->

Einschränkung:

Um den /CleanInstall Befehl zu nutzen, während App Protection aktiviert ist, müssen Sie zuerst die Citrix Workspace-App deinstallieren, den Computer neu starten und dann eine Neuinstallation mit dem Befehl initiieren /CleanInstall.

Installation über die Benutzeroberfläche

Sie können die Citrix Workspace-App für Windows manuell installieren, indem Sie das Installationspaket CitrixWorkspaceApp.exe ausführen:

1. Starten Sie die Datei CitrixWorkspaceApp.exe.

   Das System überprüft die Voraussetzungen für die Citrix Workspace-App und installiert sie bei Bedarf automatisch.

    

   Nach der Installation der Voraussetzungen wird die Begrüßung zum Citrix Workspace-Installationsprogramm angezeigt.

2. Klicken Sie auf Weiter. Die Seite mit dem Citrix Lizenzvertrag wird angezeigt.
3. Lesen und akzeptieren Sie die Citrix Lizenzvereinbarung und fahren Sie mit der Installation fort. Die Installation der Citrix Workspace-App wird fortgesetzt und erfolgreich abgeschlossen.

4. Bei der Installation mit Administratorrechten können Sie auf der Seite Add-on (s) Folgendes auswählen:

   • App Protection nach der Installation starten
   • Single Sign-On aktivieren
   • Microsoft Teams VDI-Plug-In installieren

Die Installation der Citrix Workspace-App wird fortgesetzt und erfolgreich abgeschlossen.

Wichtig:

Ab der Version 2311.1 der Citrix Workspace-App für Windows wird TrolleyExpress durch CWAInstaller-<date and timestamp> ersetzt. Das Protokoll wird beispielsweise unter C:\Program Files (x86)\Citrix\Logs\CTXWorkspaceInstallLogs-20231225-093441 aufgezeichnet.

Windows Store verwenden

1. Gehen Sie zum Microsoft Store.
2. Suchen Sie nach Citrix Workspace.

1. Klicken Sie auf Get. Die Citrix Workspace-App ist installiert.

Befehlszeileninstallation

Sie können das Installationsprogramm für die Citrix Workspace-App durch Festlegen verschiedener Befehlszeilenoptionen anpassen. Das Installationspaket wird vor dem Start des Setupprogramms automatisch im Temp-Verzeichnis des Betriebssystems extrahiert. Der benötigte Speicherplatz berücksichtigt Programmdateien, Benutzerdaten und Temp-Verzeichnisse nach dem Start mehrerer Anwendungen.

Um die Citrix Workspace-App über die Windows-Befehlszeile zu installieren, starten Sie die Eingabeaufforderung und geben dann Folgendes auf einer einzigen Zeile ein:

• Name der Installationsdatei,
• Installationsbefehle und
• Installationseigenschaften.

Die verfügbaren Installationsbefehle und -eigenschaften lauten wie folgt:

CitrixWorkspaceApp.exe [commands] [properties]

Liste der Befehlszeilenparameter

Die Parameter werden wie folgt klassifiziert:

• Allgemeine Parameter
• Update-Parameter
• Installationsparameter
• HDX-Parameter
• Parameter für Einstellungen und Benutzeroberfläche
• Authentifizierungsparameter

Allgemeine Parameter

Hinweis:

Der Switch forceinstall ersetzt den Switch rcu. Die Befehlszeilenoption rcu ist ab Version 1909 veraltet. Weitere Informationen finden Sie unter Einstellung von Features und Plattformen.

Parameter für automatisches Update

Verfügbares Update erkennen

• Befehl: AutoUpdateCheck
• Beschreibung: Dieser Befehl gibt an, dass die Citrix Workspace für Windows erkennt, wenn ein Update verfügbar ist.

Zulässige Werte:

Hinweis:

AutoUpdateCheck ist ein obligatorischer Parameter, den Sie festlegen müssen, um andere Parameter wie AutoUpdateStream, DeferUpdateCount und AURolloutPriority zu konfigurieren.

Updateversion auswählen

• BefehlAutoUpdateStream
• Beschreibung: Wenn Sie die automatische Aktualisierung aktiviert haben, können Sie auswählen, welche Version Sie aktualisieren möchten. Weitere Informationen finden Sie unter Lifecycle Milestones.

Zulässige Werte:

Benachrichtigungen über Update ignorieren

• Befehl: DeferUpdateCount
• Beschreibung: Gibt an, wie oft Sie Benachrichtigungen für ein verfügbares Update ignorieren können. Weitere Informationen finden Sie unter Citrix Workspace-Updates.

Zulässige Werte:

Hinweis:

Ab Version 2207 der Citrix Workspace-App für Windows ist das Feature für automatische Updates verbessert und der Parameter DeferUpdatCount gilt nicht mehr.

Rolloutpriorität festlegen

• Befehl: AURolloutPriority
• Beschreibung: Wenn eine neue App-Version verfügbar ist, stellt Citrix das Update während des Bereitstellungszeitraums bereit. Mit diesem Parameter können Sie steuern, zu welchem Zeitpunkt während des Bereitstellungszeitraums Sie das Update erhalten können.

Zulässige Werte:

Store-Konfigurationsparameter

Store konfigurieren

• Befehl: ALLOWADDSTORE
• Beschreibung: Ermöglicht es Ihnen, die Stores (HTTP oder https) basierend auf dem angegebenen Parameter zu konfigurieren.

Zulässige Werte:

Store-Anmeldeinformationen lokal speichern

• Befehl: ALLOWSAVEPWD
• Beschreibung: Ermöglicht Ihnen, die Anmeldeinformationen für den Store lokal zu speichern. Dieser Parameter gilt nur für Stores, die das Citrix Workspace-App-Protokoll verwenden.

Zulässige Werte:

Beispiele für die Store-Konfiguration bei Installation per Befehlszeile

StoreFront- angeben:

CitrixWorkspaceApp.exe /silent
STORE0="AppStore;https://testserver.net/Citrix/MyStore/discovery;on;HR App Store"

<!--NeedCopy-->

Angeben der Citrix Gateway :

CitrixWorkspaceApp.exe STORE0=HRStore;https://ag.mycompany.com#Storename;On;Store
<!--NeedCopy-->

Dabei gibt Storename den Namen des Stores an, der konfiguriert werden muss.

Hinweis:

• Die mit dieser Methode konfigurierte Citrix Gateway unterstützt keine PNA-Dienste-Sites, die Citrix Gateway verwenden.
• Der Parameter “Discovery” ist nicht erforderlich, wenn Sie eine Citrix Gateway- angeben.

Mehrere Stores konfigurieren:

CitrixWorkspaceApp.exe  STORE0="StoreFront Store;https://testserver.net/Citrix/MyBackupStore/discovery;on; StoreFrontStore"

STORE1="NetScaler Store;https://ag.mycompany.com#Storename;On;NetScaler Store"
<!--NeedCopy-->

Hinweis:

Für eine erfolgreiche Passthrough-Authentifizierung ist es zwingend erforderlich, discovery in die aufzunehmen.

Installationsparameter

App Protection starten

• Befehl: startAppProtection
• Beschreibung: Startet App Protection und bietet mehr Sicherheit, da Clients besser vor Bildschirmerfassungs- und Keylogging-Malware geschützt sind.
• Beispiel: CitrixWorkspaceApp.exe startAppProtection

Weitere Informationen finden Sie unter App Protection.

Hinweis:

Der Switch startAppProtection ersetzt den Switch includeAppProtection. Die Befehlszeilenoption includeAppProtection ist ab Version 2212 veraltet. Weitere Informationen finden Sie unter Einstellung von Features und Plattformen.

Citrix Enterprise Browser-Binärdateien ausschließen

• Beschreibung: Schließt die Binärdateien für den Citrix Enterprise Browser aus.
• Führen Sie den folgenden Befehl aus, um den Citrix Enterprise Browser auszuschließen:

CitrixWorkspaceapp.exe ADDLOCAL=ReceiverInside,ICA_Client,BCR_Client,USB,DesktopViewer,AM,SSON,SelfService,WebHelper
<!--NeedCopy-->

Sie können die Binärdateien für den Citrix Enterprise Browser nur in folgenden Fällen ausschließen:

• Neuinstallation
• Upgrade von einer Version ohne Binärdateien für den Citrix Enterprise Browser.

Installationsverzeichnis angeben

• Befehl: INSTALLDIR
• Beschreibung: Gibt das benutzerdefinierte Installationsverzeichnis für die Installation der Citrix Workspace-App an. Der Standardpfad ist C:\Program Files\Citrix.
• Beispiel: CitrixWorkspaceApp.exe INSTALLDIR=C:\custom path\Citrix.

Hinweis:

Der Ordner Program Files ist durch das Betriebssystem geschützt. Wenn Sie einen anderen Ordner verwenden möchten, stellen Sie sicher, dass dieser über die richtigen Berechtigungen verfügt und geschützt ist.

Eine oder mehrere der spezifischen Komponenten installieren

• Befehl: ADDLOCAL
• Beschreibung: Verwenden Sie den Schlüssel ADDLOCAL, um eine oder mehrere der bestimmten Komponenten der Citrix Workspace-App zu installieren. Wenn Sie mit diesem Schlüssel bestimmte Komponenten installieren, installiert die Citrix Workspace-App standardmäßig alle obligatorischen Komponenten.

Hinweis:

Sie sollten den Schlüssel ADDLOCAL nur verwenden, um bestimmte Komponenten der Citrix Workspace-App zu installieren. Wenn kein Parameter ADDLOCAL angegeben ist, werden standardmäßig alle unterstützten Komponenten während der Installation der Citrix Workspace-App installiert.

In der folgenden Tabelle sind die Komponenten aufgeführt, die vom Schlüssel ADDLOCAL unterstützt werden:

Beispielsweise können Sie mit dem folgenden Befehl die im Befehl genannten Komponenten installieren:

CitrixWorkspaceapp.exe ADDLOCAL=ReceiverInside,ICA_Client,BCR_Client,USB,DesktopViewer,AM,SSON,SelfService,WebHelper,CitrixEnterpriseBrowser
<!--NeedCopy-->

Hinweis:

Ab Version 2212 ist App Protection standardmäßig installiert. Daher ist AppProtection keine für ADDLOCAL gültige Option mehr.

Einschränkung:

Wenn Sie die Citrix Workspace-App mit ADDLOCAL-Parametern installieren, reagiert das Fenster Geräte und Einstellungen möglicherweise nicht vom Connection Centeraus. Dieses Problem tritt nur auf, wenn Sie die Citrix Workspace-App ohne den Parameter DesktopViewer installieren. Um das Problem zu umgehen, schließen Sie auch den Parameter DesktopViewer ein. [HDX-67173]

Citrix Casting installieren

Wichtig:

Für die Citrix Workspace-App LTSR Version 2402 und höher kann Citrix Casting auch mit dem Befehl IncludeCitrixCasting nicht installiert werden. Um dieses Feature verwenden zu können, müssen Sie eine ältere Version der Citrix Workspace-App verwenden. Weitere Informationen finden Sie auf der Seite Deprecation.

• Befehl: IncludeCitrixCasting
• Beschreibung: Installiert Citrix Casting während der Installation.

Weitere Informationen zu Citrix Casting finden Sie unter Citrix Casting.

HDX-Parameter

Bidirektionale Inhaltsumleitung einrichten

• Befehl: ALLOW_BIDIRCONTENTREDIRECTION
• Beschreibung: Gibt an, ob die bidirektionale Inhaltsumleitung zwischen Client und Host aktiviert ist. Weitere Informationen finden Sie unter Richtlinieneinstellungen für die bidirektionale Inhaltsumleitung in der Dokumentation zu Citrix Virtual Apps and Desktops.

Zulässige Werte:

Lokalen App-Zugriff einrichten

• Befehl: FORCE_LAA
• Beschreibung: Gibt an, dass die Citrix Workspace-App mit der clientseitigen Komponente für den lokalen App-Zugriff installiert ist. Installieren Sie die Citrix Workspace-App mit Administratorrechten, damit diese Komponente funktioniert. Weitere Informationen finden Sie unter Lokaler App-Zugriff in der Dokumentation zu Citrix Virtual Apps and Desktops.

Zulässige Werte:

URL-Umleitung auf Benutzergeräten einrichten

• Befehl: ALLOW_CLIENTHOSTEDAPPSURL
• Beschreibung: Aktiviert die URL-Umleitung auf einem Benutzergerät. Weitere Informationen finden Sie unter Lokaler App-Zugriff in der Dokumentation zu Citrix Virtual Apps and Desktops.

Zulässige Werte:

Symbole für Dokumente oder Dateien anzeigen

• Befehl: LEGACYFTAICONS
• Beschreibung: Legt fest, ob Sie für Dokumente oder Dateien, die Dateitypzuordnungen für abonnierte Anwendungen haben, Symbole anzeigen möchten.

Zulässige Werte:

Parameter für Einstellungen und Benutzeroberfläche

Verzeichnis für Startmenü- und Desktop-Verknüpfungen einrichten

Hinweis:

Wenn Sie die Option DESKTOPDIR verwenden, legen Sie den Schlüssel PutShortcutsOnDesktop auf True fest.

Zugriff auf Self-Service steuern

• Befehl: SELFSERVICEMODE
• Beschreibung: Steuert den Zugriff auf die Self-Service-Benutzeroberfläche der Citrix Workspace-App.

Zulässige Werte:

Vorabstart von Sitzungen steuern

• Befehl: ENABLEPRELAUNCH
• Beschreibung: Steuert den Vorabstart von Sitzungen. Weitere Informationen finden Sie unter Dauer des Anwendungsstarts.

Zulässige Werte:

Tastenkombinationen und Option “Verbindung wiederherstellen” ausblenden

• Befehl: DisableSetting
• Beschreibung: Ausblenden der Option Verknüpfungen und Wiederverbinden auf der Seite Erweiterte Einstellungen. Weitere Informationen finden Sie unter Ausblenden bestimmter Einstellungen auf der Seite “Erweiterte Einstellungen”.

Zulässige Werte:

Programm zur Verbesserung der Benutzerfreundlichkeit aktivieren

• Befehl: EnableCEIP
• Beschreibung: Gibt an, dass Sie am Programm zur Verbesserung der Benutzerfreundlichkeit (CEIP) teilnehmen. Weitere Informationen finden Sie unter CEIP.

Zulässige Werte:

Always-On-Ablaufverfolgung aktivieren

• Befehl: EnableTracing
• Beschreibung: Steuert das Feature Always-On-Ablaufverfolgung.

Zulässige Werte:

Namen für Benutzergerät eingeben

• Befehl: CLIENT_NAME
• Beschreibung: Gibt den Namen an, mit dem das Benutzergerät beim Server identifiziert wird.
• <ClientName> - Gibt den Namen an, mit dem das Benutzergerät beim Server identifiziert wird. Der Standardname lautet %COMPUTERNAME%.
• Beispiel: CitrixReceiver.exe CLIENT_NAME=%COMPUTERNAME%.

Clientnamen auf Computernamen einstellen

• Befehl: ENABLE_DYNAMIC_CLIENT_NAME
• Beschreibung: Ermöglicht, dass der Clientname mit dem Computernamen übereinstimmt. Wenn Sie den Computernamen ändern, ändert sich auch der Clientname.

Zulässige Werte:

Authentifizierungsparameter

Single Sign-On einbeziehen

• Befehl: /includeSSON
• Beschreibung: Erfordert die Installation als Administrator. Gibt an, dass die Citrix Workspace-App mit der Single Sign-On-Komponente installiert wird. Weitere Informationen finden Sie unter Domänen-Passthrough-Authentifizierung.
• Beispiel:CitrixWorkspaceApp.exe /includeSSON

Hinweis:

Der Befehl includeSSON unterstützt nur die Neuinstallation der Citrix Workspace-App.

Single Sign-On aktivieren

• Befehl: ENABLE_SSON
• Beschreibung: Aktiviert Single Sign-On, wenn die Citrix Workspace-App mit dem Befehl /includeSSON installiert wird. Weitere Informationen finden Sie unter Domänen-Passthrough-Authentifizierung.

Zulässige Werte:

Citrix Workspace-App deinstallieren

Deinstallation mit einem Windows-basierten Deinstallationsprogramm

Sie können die Citrix Workspace-App für Windows über die Systemsteuerung deinstallieren: Weitere Informationen finden Sie im Abschnitt Citrix Workspace-App für Windows deinstallieren.

Hinweis:

Bei der Installation der Citrix Workspace-App werden Sie aufgefordert, das Citrix HDX RTME-Paket zu deinstallieren. Klicken Sie auf OK, um mit der Deinstallation fortzufahren.

Deinstallation über die Befehlszeilenschnittstelle

Sie können die Citrix Workspace-App mit dem folgenden Befehl über die Befehlszeile deinstallieren:

CitrixWorkspaceApp.exe /uninstall
<!--NeedCopy-->

Führen Sie für die unbeaufsichtigte Deinstallation der Citrix Workspace-App den folgenden Befehl aus:

CitrixWorkspaceApp.exe /silent /uninstall
<!--NeedCopy-->

Hinweis:

GPO-bezogene Registrierungsschlüssel werden nicht vom Citrix Workspace-App-Installationsprogramm gesteuert und verbleiben daher nach der Deinstallation. Wenn Sie Einträge gefunden haben, aktualisieren Sie diese mit gpedit oder löschen Sie sie manuell.

Problembehandlung

Fehlercodes

• Fehlercodes im Zusammenhang mit dem Installationsprogramm finden Sie unter MsiExec.exe und InstMsi.exe Fehlermeldungen.
• Informationen zu systembezogenen Fehlercodes finden Sie unter Systemfehlercodes.

Speicherort des Installationsprotokolls

Standardmäßig sind die Installationsprotokolle am folgenden Speicherort:

Hinweis:

Ab der Version 2311.1 der Citrix Workspace-App für Windows wird TrolleyExpress durch CWAInstaller-<date and timestamp> ersetzt. Das Protokoll wird beispielsweise unter C:\Program Files (x86)\Citrix\Logs\CTXWorkspaceInstallLogs-20231225-093441 aufgezeichnet.

Zurücksetzen der Citrix Workspace-App

Durch das Zurücksetzen der Citrix Workspace-App werden die Standardeinstellungen wiederhergestellt.

Die folgenden Elemente werden zurückgesetzt, wenn Sie die Citrix Workspace-App zurücksetzen:

• Alle konfigurierten Konten und Stores.
• Apps, die vom Self-Service-Plug-In bereitgestellt werden, ihre Symbole und Registrierungsschlüssel.
• Vom Self-Service-Plug-In erstellte Dateitypzuordnungen.
• Zwischengespeicherte Dateien und gespeicherte Kennwörter.
• Benutzerspezifische Registrierungseinstellungen.
• Maschinenspezifische Installationen und Registrierungseinstellungen.
• Citrix Gateway-Registrierungseinstellungen für die Citrix Workspace-App.

Führen Sie den folgenden Befehl über die Befehlszeilenschnittstelle aus, um die Citrix Workspace-App zurückzusetzen:

"C:\Program Files (x86)\Citrix\ICA Client\SelfServicePlugin\CleanUp.exe" -cleanUser
<!--NeedCopy-->

Verwenden Sie für eine unbeaufsichtigte Zurücksetzung folgenden Befehl:

"C:\Program Files (x86)\Citrix\ICA Client\SelfServicePlugin\CleanUp.exe" /silent -cleanUser
<!--NeedCopy-->

Hinweis:

Verwenden Sie den Großbuchstaben U im Parameter.

Das Zurücksetzen der Citrix Workspace-App hat keine Auswirkungen auf Folgendes:

• Installation der Citrix Workspace-App oder des Plug-Ins.
• Maschinenspezifische ICA-Sperreinstellungen.
• Administrative Gruppenrichtlinienobjektvorlage für die Citrix Workspace-App.