Citrix Workspace app for Windows

Installieren und Deinstallieren

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

Sie können das Paket installieren, indem Sie:

  • Einen interaktiven, Windows-basierten Installationsassistenten ausführen.

    Oder

  • Den Namen der Installationsdatei, Installationsbefehle und Installationseigenschaften über die Befehlszeilenschnittstelle eingeben. Informationen zur Installation der Citrix Workspace-App über eine Befehlszeilenschnittstelle finden Sie unter Verwenden von Befehlszeilenparametern.

Hinweis:

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

  • Verwenden Sie den Befehl CitrixWorkspaceApp.exe /CleanInstall, wenn Sie auf eine neuere Version der Citrix Workspace-App aktualisieren. Für Downgrades wird empfohlen, die Citrix Workspace-App zuerst zu deinstallieren.

Installation mit Administrator- und Nicht-Administrator-Berechtigungen:

Sowohl Benutzer als auch Administratoren können die Citrix Workspace-App installieren. Administratorberechtigungen sind nur erforderlich, wenn Pass-Through-Authentifizierung, Single Sign-On, App Protection und das Microsoft Teams VDI-Plug-in mit der Citrix Workspace-App für Windows verwendet werden.

Die folgende Tabelle beschreibt die Unterschiede, wenn die Citrix Workspace-App als Administrator oder als Benutzer installiert wird:

  Installationsordner Installationstyp
Administrator Für 64-Bit: C:\Program Files (x86)\Citrix\ICA Client und für 32-Bit: C:\Program Files\Citrix\ICA Client Systemweite Installation
Benutzer %USERPROFILE%\AppData\Local\Citrix\ICA Client Benutzerbezogene Installation

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 verbleibenden Spuren wie Dateien und Registrierungswerte einer früheren Deinstallation zu bereinigen und dann die neue Version der Citrix Workspace-App neu zu installieren.

Zum Beispiel:

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

Hinweis:

Der Unterschied zwischen den Befehlen forceinstall und cleaninstall besteht darin, dass forceinstall bei einem nicht unterstützten Versions-Upgrade oder einem Fehler ausgeführt wird, während cleaninstall immer vor der Ausführung der erforderlichen Aktion (Installation oder Upgrade) bereinigt.

Verbesserter Installationsprozess für die Citrix Workspace™-App mit App Protection

Bisher wurde der Schalter /cleanInstall nicht unterstützt, wenn App Protection aktiviert war, und der Benutzer musste die Maschine manuell deinstallieren und neu starten, bevor er die Installation erneut versuchen konnte. Ab Version 2503 deinstalliert die Citrix Workspace-App, wenn App Protection aktiviert ist und der Befehl /CleanInstall ausgeführt wird, die App automatisch, startet die Maschine basierend auf der Benutzerauswahl neu und installiert die App während des Neustarts neu. Die folgende Meldung wird während des Prozesses angezeigt:

  -  ![Installation erfolgreich](/en-us/citrix-workspace-app-for-windows/media/installation-successful.png)
  • Wenn der Benutzer auf Neu starten klickt, wird die Citrix Workspace-App während des Neustarts neu installiert.
  • Wenn der Benutzer auf Abbrechen klickt, wird die Citrix Workspace-App beim nächsten Neustart installiert. Infolgedessen ist die Citrix Workspace-App nicht verfügbar, wenn in den Systemen nach der App gesucht wird.

Hinweis:

  -  Bei stillen Installationen ist die Citrix Workspace-App erst nach dem nächsten vom Benutzer initiierten Neustart verfügbar.
  -  Wenn der Benutzer die Installation vor dem Neustart erneut versucht, wird die folgende Aufforderung zum Neustart des Systems angezeigt:

Installation fehlgeschlagen

Benutzeroberflächenbasierte Installation

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

  1. Starten Sie die Datei CitrixWorkspaceApp.exe.

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

    • Voraussetzungen

    Nach der Installation der Voraussetzungen wird der Bildschirm Willkommen beim Citrix Workspace Installer angezeigt.

  2. Klicken Sie auf Weiter. Die Seite Citrix Lizenzvereinbarung wird angezeigt.

      1. 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.
    1. Bei der Installation mit Administratorberechtigungen 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
    • Zoom VDI-Plug-in installieren
    • Cisco WebEx VDI-Plug-in installieren

    Installer

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

SSON

Wichtig:

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

  • Verwenden des Windows Store

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

Installation der Citrix Workspace-App über den Store

  1. Klicken Sie auf Abrufen. Die Citrix Workspace-App wird installiert.

Befehlszeilenbasierte Installation

Sie können das Installationsprogramm der Citrix Workspace-App anpassen, indem Sie verschiedene Befehlszeilenoptionen angeben. Das Installationspaket entpackt sich selbst in das temporäre Systemverzeichnis, bevor das Setup-Programm gestartet wird. Der Speicherplatzbedarf umfasst Programmdateien, Benutzerdaten und temporäre Verzeichnisse nach dem Start mehrerer Anwendungen.

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

  • Installationsdateiname,
  • Installationsbefehle und
  • Installationseigenschaften

Die verfügbaren Installationsbefehle und -eigenschaften sind die folgenden:

  • CitrixWorkspaceApp.exe [commands] [properties]

Liste der Befehlszeilenparameter

Die Parameter werden grob wie folgt klassifiziert:

Allgemeine Parameter

Befehl Beschreibung
? Oder help Listet alle Installationsbefehle und -eigenschaften auf.
/silent Deaktiviert Installationsdialoge und -aufforderungen während der Installation.
/forceinstall Dieser Schalter ist wirksam, wenn vorhandene Konfigurationen oder Einträge der Citrix Workspace-App im System bereinigt werden. Verwenden Sie diesen Schalter, wenn Sie von einer nicht unterstützten Version der Citrix Workspace-App aktualisieren und wenn die Installation oder das Upgrade nicht erfolgreich ist.

Hinweis:

  • Der Schalter forceinstall ersetzt den Schalter rcu. Der Schalter rcu ist ab Version 1909 veraltet. Weitere Informationen finden Sie unter Veraltet.

Der Unterschied zwischen den Befehlen forceinstall und cleaninstall besteht darin, dass forceinstall bei einem Upgrade einer nicht unterstützten Version oder einem Fehler ausgeführt wird, während cleaninstall immer vor der Ausführung der erforderlichen Aktion bereinigt, sei es eine Installation oder ein Upgrade.

Parameter für automatische Updates

Verfügbares Update erkennen

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

Die möglichen Werte sind die folgenden:

Werte des Befehls AutoUpdateCheck Beschreibung Beispiel
Auto (Standard) Sie werden benachrichtigt, wenn ein Update verfügbar ist. CitrixWorkspaceApp.exe AutoUpdateCheck=auto.
Manuell Sie werden nicht benachrichtigt, wenn ein Update verfügbar ist. Suchen Sie manuell nach Updates. CitrixWorkspaceApp.exe AutoUpdateCheck=manual
Deaktiviert Deaktiviert automatische Updates. CitrixWorkspaceApp.exe AutoUpdateCheck=disabled.

Hinweis:

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

Version für das Update auswählen

  • Befehl AutoUpdateStream
  • Beschreibung – Wenn Sie automatische Updates aktiviert haben, können Sie die Version auswählen, auf die Sie aktualisieren möchten. Weitere Informationen finden Sie unter Lifecycle Milestones.

Die möglichen Werte sind die folgenden:

Wert des Befehls AutoUpdateStream Beschreibung Beispiel
LTSR Automatische Updates nur auf kumulative Updates der Long Term Service Release. CitrixWorkspaceApp.exe AutoUpdateStream=LTSR.
Current Automatische Updates auf die neueste Version der Citrix Workspace-App. CitrixWorkspaceApp.exe AutoUpdateStream=Current

Benachrichtigungen für Updates zurückstellen

  • Befehl: DeferUpdateCount
  • Beschreibung: Gibt an, wie oft Sie Benachrichtigungen zurückstellen können, wenn ein Update verfügbar ist. Weitere Informationen finden Sie unter Citrix Workspace Updates.

Die möglichen Werte sind die folgenden:

Wert des Befehls DeferUpdateCount Beschreibung Beispiel
-1 (Standard) Ermöglicht das Zurückstellen von Benachrichtigungen beliebig oft CitrixWorkspaceApp.exe DeferUpdateCount=-1
0 Zeigt an, dass Sie nur eine Benachrichtigung für jedes verfügbare Update erhalten. Erinnert Sie nicht erneut an das Update. CitrixWorkspaceApp.exe DeferUpdateCount=0
Jede andere Zahl ‘n’
  • Ermöglicht das Zurückstellen von Benachrichtigungen ‘n’ Mal. Die Option Später erinnern wird in der Anzahl ‘n’ angezeigt.
CitrixWorkspaceApp.exe DeferUpdateCount=<n>

Hinweis:

  • Ab Citrix Workspace-App für Windows Version 2207 wurde die Auto-Update-Funktion verbessert und der Parameter DeferUpdatCount ist nicht mehr anwendbar.

  • Rollout-Priorität festlegen

  • Befehl: AURolloutPriority
  • Beschreibung: Wenn eine neue Version der App verfügbar ist, rollt Citrix das Update für einen bestimmten Bereitstellungszeitraum aus. Mit diesem Parameter können Sie steuern, wann Sie das Update während des Bereitstellungszeitraums erhalten.

Die möglichen Werte sind die folgenden:

AURolloutPriority-Befehlswert Beschreibung Beispiel
Auto (Standard) Sie erhalten die Updates während des von Citrix konfigurierten Bereitstellungszeitraums. CitrixWorkspaceApp.exe AURolloutPriority=Auto
  • Schnell Sie erhalten die Updates zu Beginn des Bereitstellungszeitraums. CitrixWorkspaceApp.exe AURolloutPriority=Fast
    Mittel Sie erhalten die Updates in der Mitte des Bereitstellungszeitraums. CitrixWorkspaceApp.exe AURolloutPriority=Medium
  • Langsam Sie erhalten die Updates am Ende des Bereitstellungszeitraums. CitrixWorkspaceApp.exe AURolloutPriority=Slow

Store-Konfigurationsparameter

  • Store konfigurieren

  • Befehl: ALLOWADDSTORE
  • Beschreibung: Ermöglicht die Konfiguration der Stores (HTTP oder HTTPS) basierend auf dem angegebenen Parameter.

Die möglichen Werte sind die folgenden:

  • |ALLOWADDSTORE-Befehlswert|Beschreibung|Beispiel| |—|—|—|
  • S (Standard) Ermöglicht das Hinzufügen oder Entfernen nur sicherer Stores (mit HTTPS konfiguriert). CitrixWorkspaceApp.exe ALLOWADDSTORE=S
  • A Ermöglicht das Hinzufügen oder Entfernen sowohl sicherer Stores (HTTPS) als auch unsicherer Stores (HTTP). Nicht anwendbar, wenn die Citrix Workspace-App pro Benutzer installiert ist. CitrixWorkspaceApp.exe ALLOWADDSTORE=A
  • N Benutzern niemals erlauben, eigene Stores hinzuzufügen oder zu entfernen. CitrixWorkspaceApp.exe ALLOWADDSTORE=N

Store-Anmeldeinformationen lokal speichern

  • Befehl: ALLOWSAVEPWD
  • Beschreibung: Ermöglicht das lokale Speichern der Store-Anmeldeinformationen. Dieser Parameter gilt nur für Stores, die das Citrix Workspace-App-Protokoll verwenden.

Die möglichen Werte sind die folgenden:

ALLOWSAVEPWD-Befehlswert Beschreibung Beispiel
S (Standard) Ermöglicht das Speichern des Kennworts nur für sichere Stores (mit HTTPS konfiguriert). CitrixWorkspaceApp.exe ALLOWSAVEPWD=S
N Ermöglicht das Speichern des Kennworts nicht. CitrixWorkspaceApp.exe ALLOWSAVEPWD=N
A Ermöglicht das Speichern des Kennworts sowohl für sichere Stores (HTTPS) als auch für unsichere Stores (HTTP). CitrixWorkspaceApp.exe ALLOWSAVEPWD=A

Beispiele für die Store-Konfiguration mithilfe der Befehlszeileninstallation

So geben Sie die StoreFront-Store-URL an:

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

<!--NeedCopy-->

So geben Sie die Citrix Gateway-Store-URL an:

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-Store-URL unterstützt keine PNA Services Sites, die Citrix Gateway verwenden.
  • Der Parameter “Discovery” ist nicht erforderlich, wenn eine Citrix Gateway-Store-URL angegeben wird.

So konfigurieren Sie mehrere Stores:

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:

Es ist zwingend erforderlich, discovery in die Store-URL aufzunehmen, um eine erfolgreiche Pass-Through-Authentifizierung zu gewährleisten.

Die folgende Tabelle enthält Beschreibungen für die Parameter der Store-URL:

  • Parameter Beschreibung
    Store-Name Der Name, den der Benutzer für den Store sieht.
  • Store-URL Die URL für den Store.
  • Store-Aktivierungsstatus Der Status kann „Ein“ oder „Aus“ sein.
    Store-Beschreibung Die Beschreibung, die der Benutzer für den Store sieht.

Beispiel für StoreFront™:

SalesStore;https://sales.mycompany.com/Citrix/Store/discovery;On;Store für Vertriebsmitarbeiter.

Installationsparameter

App Protection starten

  • Befehl: startAppProtection
  • Beschreibung: Startet die App Protection-Komponente und bietet verbesserte Sicherheit, indem die Möglichkeit von Clients, durch Keylogging- und Screen-Capturing-Malware kompromittiert zu werden, eingeschränkt wird.
  • Beispiel: CitrixWorkspaceApp.exe startAppProtection

Weitere Informationen finden Sie in der Dokumentation zu App Protection.

Hinweis:

  • Der Schalter startAppProtection ersetzt den Schalter includeAppProtection. Der Schalter includeAppProtection ist ab Version 2212 veraltet. Weitere Informationen finden Sie unter Veraltet.

Ausschluss von Citrix Enterprise Browser-Binärdateien

  • Befehl: Führen Sie den folgenden Befehl aus, um Citrix Enterprise Browser™ auszuschließen
CitrixWorkspaceapp.exe ADDLOCAL=ReceiverInside,ICA_Client,BCR_Client,USB,DesktopViewer,AM,SSON,SelfService,WebHelper
<!--NeedCopy-->
  • Beschreibung: Schließt die Binärdateien des Citrix Enterprise Browsers aus.

Sie können die Binärdateien des Citrix Enterprise Browsers nur in den folgenden Fällen ausschließen:

  • Neuinstallation
  • Upgrade von einer Version, die die Binärdateien des Citrix Enterprise Browsers nicht enthält.

  • Ausschluss des EPA-Clients von der automatischen Installation

  • Befehl: CitrixWorkspaceApp.exe InstallEPAClient=N
  • Beschreibung: Stoppt die automatische Installation des EPA-Clients.
  • Beispiel: Verwenden Sie den folgenden Befehl
CitrixWorkspaceapp.exe ADDLOCAL=ReceiverInside,ICA_Client,BCR_Client,USB,DesktopViewer,AM,SSON,SelfService,WebHelper InstallEPAClient=N
<!--NeedCopy-->

Sie können den EPA-Client in den folgenden Fällen ausschließen:

  • Neuinstallation
  • Upgrade von einer Version, die den EPA-Client nicht enthält.

Benutzerdefiniertes 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 Programme ist durch das Betriebssystem geschützt. Wenn Sie einen anderen benutzerdefinierten Ordner als „Programme“ verwenden möchten, stellen Sie sicher, dass der Ordner über die richtigen Berechtigungen verfügt und geschützt ist.

  • Installieren einer oder mehrerer spezifischer Komponenten

  • Befehl: ADDLOCAL
  • Beschreibung: Verwenden Sie den Schlüssel ADDLOCAL, um eine oder mehrere der spezifischen 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:

  • Beim Upgrade der Citrix Workspace-App berücksichtigt das Installationsprogramm keine Ausschlussbefehle (z. B. BCR_Client) für Komponenten, die bereits in der Basisversion vorhanden sind. Um eine Komponente während eines Upgrade-Vorgangs zu entfernen, deinstallieren Sie die vorhandene Citrix Workspace-App vollständig, bevor Sie die neue Version mit den erforderlichen Ausschluss-Parametern installieren.

Wir empfehlen Ihnen, den Schlüssel ADDLOCAL nur zu verwenden, wenn Sie bestimmte Komponenten der Citrix Workspace-App installieren möchten. Standardmäßig werden, wenn kein ADDLOCAL-Parameter angegeben ist, alle unterstützten Komponenten bei der Installation der Citrix Workspace-App installiert.

Die folgende Tabelle listet die Komponenten auf, die der Schlüssel ADDLOCAL unterstützt:

ADDLOCAL-Schlüssel Komponentenname Beschreibung
ReceiverInside Receiver Stellt Workspace-SDK-Dienste für das Self-Service-Plug-In bereit.
ICA_Client HDX™ Engine Diese Komponente verarbeitet die ICA-Datei oder den Sitzungsstartvorgang.
  • BCR_Client BCR-Client Plug-In zur Handhabung der Browserinhaltsumleitung.
  • USB USB-Client Plug-In zur Handhabung der USB-Umleitung.
    DesktopViewer Desktop Viewer-Client UI-Framework für virtuelle Desktops.
    AM AuthManager Authentifizierungsmanager – Autorisiert Benutzer für die Citrix Workspace-App.
    SSON SSON Single Sign-On-Komponente – Unterstützt Single Sign-On.
    SELFSERVICE Self-Service Plug-In für Citrix Workspace für den nativen Start.
    WebHelper Web Helper Hilfsprogramm zur Verbindung des Browsers mit der nativen Workspace-App.
    CitrixEnterpriseBrowser Browser Nativer Browser, der Benutzern ermöglicht, Web- oder SaaS-Apps sicher über die Citrix Workspace-App zu öffnen.
  • Beispiel: Mit dem folgenden Befehl können Sie 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 die App Protection-Funktion standardmäßig installiert. Daher ist AppProtection keine gültige Option mehr für den Befehl ADDLOCAL.

  • Einschränkung:

  • Wenn Sie die Citrix Workspace-App mit ADDLOCAL-Parametern installieren, reagieren die Fenster Geräte und Einstellungen möglicherweise nicht über das Verbindungszentrum. Dieses Problem tritt nur auf, wenn Sie die Citrix Workspace-App ohne den Parameter DesktopViewer installieren. Fügen Sie als Problemumgehung auch den Parameter DesktopViewer hinzu. [HDX-67173]

Plug-Ins installieren

  • Befehl: ADDONS
  • Beschreibung: Verwenden Sie den Schlüssel ADDONS, um eine oder mehrere der spezifischen Plug-Ins der Citrix Workspace-App zu installieren.

Die folgende Tabelle listet die Komponenten auf, die der Schlüssel ADDONS unterstützt:

  • ADDONS-Schlüssel Komponentenname Beschreibung
  • |—|–|–|
  • ZoomVDIPlugin Zoom VDI Plug-In Installiert den Zoom VDI Plug-In Manager als Teil der Installation der Citrix Workspace-App
    WebexVDIPlugin WebEx VDI Plug-In Installiert den WebEx VDI Plug-In Manager als Teil der Installation der Citrix Workspace-App

Beispiel: Mit dem folgenden Befehl können Sie die im Befehl genannten Plug-Ins installieren:

CitrixWorkspaceapp.exe ADDONS=ZoomVDIPlugin,WebexVDIPlugin
<!--NeedCopy-->
  • Citrix Casting™ installieren

Wichtig:

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

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

Weitere Informationen zu Citrix Casting finden Sie unter Citrix Casting.

UberAgent-Parameter

  • Befehl: InstallUberAgent
  • Beschreibung: Das UberAgent-Add-on bietet erweiterte Überwachungs- und Diagnosefunktionen für die Citrix Workspace-App und liefert detaillierte Einblicke in die Benutzererfahrung und Anwendungsleistung. Diese Integration ist ausschließlich auf verwalteten Geräten verfügbar, was die Bereitstellung optimiert und den Verwaltungsaufwand reduziert.

Verwenden Sie die folgende Befehlszeileninstallation:

Verwenden Sie den Befehl /InstallUberAgent, um das UberAgent-Plug-in zu installieren oder zu aktualisieren. Verwenden Sie den Befehl /InstallUberAgent /SkipUberAgentUpgrade, um das Plug-in zu installieren, ohne es zu aktualisieren, wenn UberAgent bereits vorhanden ist. Diese Option ist ideal für VDAs oder Geräte, bei denen die UberAgent-Bereitstellung separat von der Citrix Workspace-App verwaltet wird.

Hinweis:

Diese Komponente kann nur über die Befehlszeile installiert werden.

  • UberAgent 7.5.1 und höhere Versionen unterstützen nur x64 (64-Bit)-Plattformen. Sie können UberAgent nicht auf x86 (32-Bit)-Maschinen installieren oder verwenden.

HDX-Funktionsparameter

Bidirektionale Inhaltsumleitung festlegen

Die möglichen Werte sind die folgenden:

Befehlswert für ALLOW_BIDIRCONTENTREDIRECTION Beschreibung Beispiel
0 (Standard) Gibt an, dass die bidirektionale Inhaltsumleitung deaktiviert ist. CitrixWorkspaceApp.exe ALLOW_BIDIRCONTENTREDIRECTION=0
  • 1 Gibt an, dass die bidirektionale Inhaltsumleitung aktiviert ist. CitrixWorkspaceApp.exe ALLOW_BIDIRCONTENTREDIRECTION=1
  • Lokalen App-Zugriff festlegen

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

Die möglichen Werte sind die folgenden:

Befehlswert für FORCE_LAA Beschreibung Beispiel
0 (Standard) Gibt an, dass die Komponente für den lokalen App-Zugriff nicht installiert ist. CitrixWorkspaceApp.exe FORCE_LAA =0
1 Gibt an, dass die clientseitige Komponente für den lokalen App-Zugriff installiert ist. CitrixWorkspaceApp.exe FORCE_LAA =1

URL-Umleitungsfunktion auf dem Benutzergerät festlegen

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

  • Die möglichen Werte sind die folgenden:

  • Befehlswert für ALLOW_CLIENTHOSTEDAPPSURL Beschreibung Beispiel
    0 (Standard) Deaktiviert die URL-Umleitungsfunktion auf dem Benutzergerät. CitrixWorkspaceApp.exe ALLOW_CLIENTHOSTEDAPPSURL=0
    1 Aktiviert die URL-Umleitungsfunktion auf den Benutzergeräten. CitrixWorkspaceApp.exe ALLOW_CLIENTHOSTEDAPPSURL=1

Symbole für Dokumente oder Dateien anzeigen

  • Befehl: LEGACYFTAICONS
  • Beschreibung: Gibt an, ob Symbole für Dokumente oder Dateien angezeigt werden sollen, die eine Dateitypzuordnung zu abonnierten Anwendungen haben.

Die möglichen Werte sind die folgenden:

Befehlswert für LEGACYFTAICONS Beschreibung Beispiel
False (Standard) Zeigt Symbole für Dokumente oder Dateien an, die Dateitypzuordnungen zu abonnierten Anwendungen haben. Wenn auf False gesetzt, generiert das Betriebssystem ein Symbol für das Dokument, dem kein spezifisches Symbol zugewiesen ist. Das vom Betriebssystem generierte Symbol ist ein generisches Symbol, das mit einer kleineren Version des Anwendungssymbols überlagert ist. CitrixWorkspaceApp.exe LEGACYFTAICONS=False
True Zeigt keine Symbole für Dokumente oder Dateien an, die Dateitypzuordnungen zu abonnierten Anwendungen haben. CitrixWorkspaceApp.exe LEGACYFTAICONS=True

Parameter für Einstellungen und Benutzeroberfläche

Verzeichnis für Verknüpfungen im Startmenü und auf dem Desktop angeben

Befehlswert Beschreibung Verzeichnisname Beispiel
CitrixWorkspaceApp.exe STARTMENUDIR Gibt das Verzeichnis für die Verknüpfungen im Startmenü an. Standardmäßig werden Anwendungen unter Start > Alle Programme angezeigt. Sie können den relativen Pfad der Verknüpfungen im Ordner Programme angeben. Um Verknüpfungen unter Start > Alle Programme > Workspace zu platzieren, geben Sie STARTMENUDIR=Workspace an.
CitrixWorkspaceApp.exe DESKTOPDIR Gibt das Verzeichnis für Verknüpfungen auf dem Desktop an. Sie können den relativen Pfad der Verknüpfungen angeben. Um Verknüpfungen unter Start > Alle Programme > Workspace zu platzieren, geben Sie DESKTOPDIR=Workspace an.

Hinweis:

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

Zugriff auf den Self-Service steuern

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

Die möglichen Werte sind die folgenden:

SELFSERVICEMODE-Befehlswert Beschreibung Beispiel
True Gibt an, dass der Benutzer Zugriff auf die Self-Service-Benutzeroberfläche hat. CitrixWorkspaceApp.exe SELFSERVICEMODE=True
False Gibt an, dass der Benutzer keinen Zugriff auf die Self-Service-Benutzeroberfläche hat. CitrixWorkspaceApp.exe SELFSERVICEMODE=False

Sitzungsvorabstart steuern

  • Befehl: ENABLEPRELAUNCH
  • Beschreibung: Steuert den Sitzungsvorabstart. Weitere Informationen finden Sie unter Anwendungsstartzeit.

Die möglichen Werte sind die folgenden:

ENABLEPRELAUNCH-Befehlswert Beschreibung Beispiel
True Gibt an, dass der Sitzungsvorabstart aktiviert ist. CitrixWorkspaceApp.exe ENABLEPRELAUNCH=True
False Gibt an, dass der Sitzungsvorabstart deaktiviert ist. CitrixWorkspaceApp.exe ENABLEPRELAUNCH=False

Option „Verknüpfungen und Wiederverbindung“ ausblenden

Die möglichen Werte sind die folgenden:

DisableSetting-Befehlswert Beschreibung Beispiel
0 (Standard) Zeigt sowohl die Optionen Verknüpfungen als auch Wiederverbindung auf der Registerkarte „Erweiterte Einstellungen“ an. CitrixWorkspaceApp.exe DisableSetting=0
1 Zeigt nur die Option Wiederverbindung auf der Registerkarte „Erweiterte Einstellungen“ an. CitrixWorkspaceApp.exe DisableSetting=1
2 Zeigt nur die Option Verknüpfungen auf der Registerkarte „Erweiterte Einstellungen“ an. CitrixWorkspaceApp.exe DisableSetting=2
3 Sowohl die Optionen Verknüpfungen als auch Wiederverbindung sind auf der Registerkarte „Erweiterte Einstellungen“ ausgeblendet. CitrixWorkspaceApp.exe DisableSetting=3

Programm zur Verbesserung der Benutzerfreundlichkeit aktivieren

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

Die möglichen Werte sind die folgenden:

EnableCEIP-Befehlswert Beschreibung Beispiel
True (Standard) Teilnahme am Citrix Customer Improvement Program (CEIP) CitrixWorkspaceApp.exe EnableCEIP=True
False Abmeldung vom Citrix Customer Improvement Program CitrixWorkspaceApp.exe EnableCEIP=False

Immer aktive Ablaufverfolgung aktivieren

  • Befehl: EnableTracing
  • Beschreibung: Steuert die Funktion Immer aktive Ablaufverfolgung.

Die möglichen Werte sind die folgenden:

EnableTracing-Befehlswert Beschreibung Beispiel
True (Standard) Aktiviert die Funktion Immer aktive Ablaufverfolgung. CitrixWorkspaceApp.exe EnableTracing=true
False Deaktiviert die Funktion Immer aktive Ablaufverfolgung. CitrixWorkspaceApp.exe EnableTracing=false

Namen zur Identifizierung des Benutzergeräts angeben

  • Befehl: CLIENT_NAME
  • Beschreibung: Gibt den Namen an, der zur Identifizierung des Benutzergeräts gegenüber dem Server verwendet wird.
  • <ClientName> – Gibt den Namen an, der zur Identifizierung des Benutzergeräts auf dem Server verwendet wird. Der Standardname ist %COMPUTERNAME%.
  • Beispiel: CitrixReceiver.exe CLIENT_NAME=%COMPUTERNAME%.

Clientnamen wie Computernamen festlegen

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

Die möglichen Werte sind die folgenden:

ENABLE_DYNAMIC_CLIENT_NAME-Befehlswert Beschreibung Beispiel
Yes (Standard) Ermöglicht, dass der Clientname dem Computernamen entspricht. CitrixWorkspaceApp.exe ENABLE_DYNAMIC_CLIENT_NAME=Yes
No Ermöglicht nicht, dass der Clientname dem Computernamen entspricht. Geben Sie einen Wert für die Eigenschaft CLIENT_NAME an. CitrixWorkspaceApp.exe ENABLE_DYNAMIC_CLIENT_NAME=No

Authentifizierungsparameter

Single Sign-On einschließen

  • 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-Pass-Through-Authentifizierung.
  • Beispiel: CitrixWorkspaceApp.exe /includeSSON

Ab Citrix Workspace-App für Windows Version 2503 installiert das System SSON standardmäßig im Ruhemodus. Sie können SSON nach der Installation mithilfe der Gruppenrichtlinienobjekt-Richtlinie (GPO) aktivieren. Navigieren Sie zum Aktivieren zu Benutzerauthentifizierung > Lokaler Benutzername und Kennwort und aktivieren Sie das Kontrollkästchen Pass-Through-Authentifizierung aktivieren.

Hinweis:

Sie müssen das System nach dem Aktualisieren der GPO-Richtlinie neu starten, damit die SSON-Einstellung wirksam wird.

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-Pass-Through-Authentifizierung.

Die möglichen Werte sind die folgenden:

ENABLE_SSON-Befehlswert Beschreibung Beispiel
Yes (Standard) Gibt an, dass Single Sign-On aktiviert ist. CitrixWorkspaceApp.exe ENABLE_SSON=Yes
No Gibt an, dass Single Sign-On deaktiviert ist. CitrixWorkspaceApp.exe ENABLE_SSON=No

Deinstallieren der Citrix Workspace-App

Deinstallation über das Windows-Deinstallationsprogramm

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

Hinweis:

Während der Installation der Citrix Workspace-App werden Sie aufgefordert, das Citrix HDX RTME-Paket zu deinstallieren. Klicken Sie auf OK, um die Deinstallation fortzusetzen.

Deinstallation über die Befehlszeilenschnittstelle

Sie können die Citrix Workspace-App über eine Befehlszeile deinstallieren, indem Sie den folgenden Befehl eingeben:

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

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

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

Hinweis:

Das Installationsprogramm der Citrix Workspace-App steuert keine GPO-bezogenen Registrierungsschlüssel, daher bleiben diese nach der Deinstallation erhalten. Wenn Sie Einträge finden, aktualisieren Sie diese mit gpedit oder löschen Sie sie manuell.

Fehlerbehebung

Fehlercodes

Speicherort der Installationsprotokolle

Standardmäßig befinden sich die Installationsprotokolle am folgenden Speicherort:

  Installationsprotokollordner Installationstyp
Administrator Für 64-Bit: C:\Program Files (x86)\Citrix\Logs und für 32-Bit: C:\Program Files\Citrix\ICA Client Systemweite Installation
Benutzer %USERPROFILE%\AppData\Local\Citrix\Logs Benutzerspezifische Installation

Hinweis:

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

Citrix Workspace-App zurücksetzen

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.
  • Vom Self-Service-Plug-In bereitgestellte Apps, deren Symbole und Registrierungsschlüssel.
  • Vom Self-Service-Plug-In erstellte Dateitypzuordnungen.
  • Zwischengespeicherte Dateien und gespeicherte Kennwörter.
  • Benutzerspezifische Registrierungseinstellungen.
  • Systemweite Installationen und deren 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-->

Für ein unbeaufsichtigtes Zurücksetzen verwenden Sie den folgenden Befehl:

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

Hinweis:

Verwenden Sie ein großes U im Parameter.

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

  • Installation der Citrix Workspace-App oder des Plug-Ins.
  • Systemweite ICA®-Sperreinstellungen.
  • Konfigurationen der administrativen Vorlage für Gruppenrichtlinienobjekte (GPO) für die Citrix Workspace-App.
Installieren und Deinstallieren