Citrix Workspace™-App für ChromeOS

Peripheriegeräte

April 21, 2026

Beitrag von:

C C

USB-Geräteumleitung

Die Citrix Workspace-App für ChromeOS unterstützt eine Vielzahl von USB-Peripheriegeräten. Mit dieser zusätzlichen Funktionalität können Sie eine Google-Richtlinie erstellen, um die PID/VID des Geräts zu identifizieren und dessen Verwendung in Citrix Workspace zu ermöglichen. Diese Unterstützung erstreckt sich auch auf neue USB-Geräte.

Wichtig:

YubiKey ist nach der Umleitung über USB in einer Citrix-Sitzung nicht verwendbar. Weitere Informationen finden Sie im Partner-Ticket. Da die FIDO2-Umleitung in der Citrix Workspace-App für ChromeOS nicht unterstützt wird, können Benutzer die USB-Umleitung als Alternative nutzen, um ihren YubiKey innerhalb einer Sitzung zu verwenden. Um dies zu ermöglichen, stellen Sie sicher, dass die Richtlinie FIDO2-Umleitung im DDC auf Verboten gesetzt ist. Hinweis: Es gibt ein bekanntes Problem ([HDX-92219]), das verhindern kann, dass YubiKey wie erwartet funktioniert, wenn es über USB auf einem Server-OS-VDA umgeleitet wird. [RFHTMCRM-16502]

Konfiguration

Informationen zur Konfiguration von USB-Geräten finden Sie im Knowledge Center-Artikel CTX200825.

Automatische Umleitung von USB-Geräten im Kiosk-Modus

Im Kiosk-Modus werden USB-Geräte automatisch und ohne manuelles Eingreifen in eine Sitzung umgeleitet. Im Benutzer- und öffentlichen Modus müssen Sie das USB-Gerät zum ersten Mal manuell über die Symbolleiste oder das Connection Center in die Sitzung umleiten. Diese manuelle USB-Umleitung erfolgt, um dem Chrome-Betriebssystem die Berechtigung zum Zugriff auf das USB-Gerät zu erteilen. Wenn ein USB-Gerät eingesteckt wird, wird es automatisch in die Sitzung umgeleitet.

Wichtig:

Wenn Sie ein USB-Gerät einstecken, während viele Sitzungen ausgeführt werden, wird das USB-Gerät in die Sitzung umgeleitet, die im Fokus steht.

Wenn keine Sitzungen im Fokus stehen, wird das USB-Gerät in keine Sitzung umgeleitet.

Wenn eine einzelne Sitzung ausgeführt wird und diese nicht im Fokus steht, wenn Sie das USB-Gerät einstecken, kann die USB-Geräteumleitung fehlschlagen.

So leiten Sie das USB-Gerät in eine neue Sitzung um

Hinweis:

Um das USB-Gerät in eine neue Sitzung umzuleiten, muss das USB-Gerät aus der vorherigen Sitzung entfernt werden.

Klicken Sie mit der rechten Maustaste auf das Citrix Workspace-Symbol und wählen Sie Connection Center. Das Fenster Connection Center wird angezeigt.
Wählen Sie eine Sitzung oder eine Anwendung aus.
Klicken Sie auf Geräte.

1. Navigieren Sie zum Abschnitt USB.
1. Klicken Sie auf Alle freigeben.

Double-Hop

Ab Version 2301 unterstützt die Citrix Workspace-App Double-Hop-Szenarien. Diese Funktion ist eine Erweiterung der USB-Umleitung.

Weitere Informationen finden Sie unter Double-Hop in der Citrix Virtual Apps and Desktops-Dokumentation.
Composite-USB-Umleitung

Bisher konnte ein zusammengesetztes USB-Gerät, wenn es an das lokale Gerät angeschlossen war, nur als einzelnes Gerät über die USB-Umleitung verwendet werden. Der Nachteil war, dass Schnittstellen wie Audio und Video ebenfalls über USB umgeleitet wurden, obwohl optimierte Kanäle vorhanden waren. Die Schnittstellen waren nicht getrennt, und aufgrund dieser Unfähigkeit konnten Administratoren nicht entscheiden, welche Komponenten über USB und welche über den optimierten virtuellen Kanal (wie die Audioschnittstelle) umgeleitet werden sollten, um die beste Leistung zu erzielen.

Ab Release 2211 können Administratoren konfigurieren, ob bestimmte Schnittstellen des Geräts über die USB-Umleitung in die Sitzung umgeleitet werden oder nicht. Der Endbenutzer kann nun eine bestimmte Teilschnittstelle eines zusammengesetzten USB-Geräts auswählen und über die USB-Umleitung an die Citrix Workspace-App-Sitzung umleiten.

Über die Composite-USB-Umleitung

USB 2.1 und höher unterstützen das Konzept von zusammengesetzten USB-Geräten, bei denen viele untergeordnete Geräte eine einzige Verbindung mit demselben USB-Bus teilen. Solche Geräte verwenden einen einzigen Konfigurationsbereich und eine gemeinsame Busverbindung, wobei eine eindeutige Schnittstellennummer 00-ff zur Identifizierung jedes untergeordneten Geräts verwendet wird. Solche Geräte sind auch nicht dasselbe wie ein USB-Hub, der einen neuen USB-Bus-Ursprung für andere unabhängig adressierte USB-Geräte zur Verbindung bereitstellt.

Zusammengesetzte Geräte, die am Client-Endpunkt gefunden werden, können an den virtuellen Host weitergeleitet werden als entweder:

ein einzelnes zusammengesetztes USB-Gerät, oder
ein Satz unabhängiger untergeordneter Geräte (geteilte Geräte)

Wenn ein zusammengesetztes USB-Gerät weitergeleitet wird, wird das gesamte Gerät für das lokale Gerät unbrauchbar. Die Weiterleitung blockiert auch die lokale Nutzung des Geräts für alle Anwendungen auf dem lokalen Gerät, einschließlich der Citrix Workspace-App.

Betrachten Sie ein USB-Headset-Gerät mit einem Audiogerät und der HID-Taste für Stummschaltung und Lautstärkeregelung. Wenn das gesamte Gerät über einen generischen USB-Kanal weitergeleitet wird, steht das Gerät für die Umleitung über den optimierten HDX™-Audiokanal nicht mehr zur Verfügung. Eine bessere Leistung kann jedoch erzielt werden, wenn der Ton über einen optimierten HDX-Audiokanal gesendet wird, verglichen mit einem generischen Kanal.

Um diese Probleme zu lösen, empfiehlt Citrix, das zusammengesetzte Gerät aufzuteilen und nur die untergeordneten Schnittstellen weiterzuleiten, die einen generischen USB-Kanal verwenden. Ein solcher Mechanismus stellt sicher, dass die anderen untergeordneten Geräte für die Verwendung durch Anwendungen auf dem lokalen Gerät verfügbar sind, einschließlich der Citrix Workspace-App, die optimierte HDX-Erlebnisse bietet. Diese Methode ermöglicht es, die erforderlichen Geräte weiterzuleiten und für die Remotesitzung verfügbar zu machen.

So aktivieren Sie diese Funktion

Sie können diese Funktion auf folgende Weisen aktivieren:

Configuration.js
Global App Configuration Service
Google Admin Policy

Configuration.js

Um die Composite-USB-Umleitung mithilfe der Datei configuration.js zu konfigurieren, gehen Sie wie folgt vor:

Suchen Sie die Datei configuration.js im Stammordner der ChromeApp.
Bearbeiten Sie die Datei configuration.js, um die Funktion zur Composite-USB-Umleitung zu konfigurieren.
Hinweise:
- Citrix empfiehlt, die Datei configuration.js zu sichern, bevor Sie Änderungen vornehmen.
- Citrix empfiehlt, die Datei configuration.js nur zu bearbeiten, wenn die Citrix Workspace-App für ChromeOS für Benutzer neu verpackt wird.
- Administratorberechtigungen sind erforderlich, um die Datei configuration.js zu bearbeiten.
Setzen Sie enableCompositeDeviceSplit auf true.

Das Folgende ist ein Beispiel für JSON-Daten:

```
{
    "features": {
        "usb": {
            "enableCompositeDeviceSplit": true
        }
    }
}
<!--NeedCopy--> ```

Speichern Sie die Änderungen.

Hinweis:

Um die Funktion zu deaktivieren, setzen Sie das Attribut enableCompositeDeviceSplit auf false.

Global App Configuration Service

In der Cloud-Einrichtung können Administratoren die Funktion zur Composite-USB-Umleitung aktivieren, indem sie das Attribut enableCompositeDeviceSplit im Global App Configuration Service auf True setzen.

Weitere Informationen finden Sie in der Dokumentation zum Global App Configuration Service.

Google Admin Policy

Bei der lokalen Bereitstellung können Administratoren die Funktion zur Composite-USB-Umleitung mithilfe der Google Admin Policy wie folgt aktivieren:

Melden Sie sich bei der Google Admin Policy an.
Gehen Sie zu Geräteverwaltung > Chrome-Verwaltung > Benutzereinstellungen.
Fügen Sie die folgenden Zeichenfolgen zur Datei policy.txt unter dem Schlüssel engine_settings hinzu. Das Folgende ist ein Beispiel für JSON-Daten:
```
{
    "features": {
        "usb": {
            "enableCompositeDeviceSplit": true
        }
    }
}

```
Speichern Sie die Änderungen.

Konfiguration

Voraussetzungen:

Zulassungsliste von USB-Geräten mit VID:PID-Werten und Aktivierung der Richtlinie für die USB-Geräteumleitung auf dem Delivery Controller. Weitere Informationen finden Sie im Knowledge Center-Artikel CTX200825.
Diese Funktion funktioniert auf verwalteten Geräten und nicht auf BYOD-Geräten.

So aktivieren Sie die automatische Erkennung des USB-Geräts:

Gehen Sie zu den Google Admin-Richtlinieneinstellungen.
Wählen Sie die Option WebUSB API allowed devices aus.
Geben Sie die Erweiterungs-ID der Citrix Workspace-App für ChromeOS ein. Beispiel: chrome-extension://haiffjcadagjlijoggckpgfnoeiflnem.
Fügen Sie die VID und PID des Geräts wie folgt hinzu:
- Nach dem Hinzufügen der VID- und PID-Werte kann die Citrix Workspace-App die Geräte in der Sitzung nun automatisch erkennen.
Wenden Sie die Google Admin-Richtlinie an. Weitere Informationen zu Geräteregeln und JSON-Beispieldaten finden Sie im folgenden Abschnitt.
Speichern Sie die Änderungen.

Geräteregeln

Die Citrix Workspace-App verwendet die Geräteregeln, um zu entscheiden, welche USB-Geräte an die Remotesitzung weitergeleitet werden dürfen oder nicht.

Im Folgenden werden die Schlüsselwörter erläutert:

-  **allow:** Dieser Abschnitt enthält die Liste der Geräte und ihrer untergeordneten Schnittstellen, die an die Sitzung umgeleitet werden können.
-  **deny:** Dieser Abschnitt enthält die Liste der Geräte und ihrer untergeordneten Schnittstellen, die nicht an die Sitzung umgeleitet werden können.

autoRedirect: Dieser Abschnitt enthält die Liste der Geräte und ihrer untergeordneten Schnittstellen, die über die USB-Umleitung automatisch an die Sitzung umgeleitet werden können.
Hinweis:
- Jedes Objekt stellt ein Gerät mit den obligatorischen vid- und pid-Werten des USB-Geräts dar. Die Werte „split“ und „interfaceClass“ sind optional.
vid, pid (obligatorisch): Steht für Vendor ID (VID) und Product ID (PID) des USB-Geräts. Geben Sie die Werte im Hexadezimalformat ein.
split (optional): Erwartet einen booleschen Wert, der angibt, ob das Gerät in untergeordnete Schnittstellen aufgeteilt werden soll oder nicht.
interfaceClass (optional): Stellt die USB-Schnittstellenklasse dar. Zulässige Werte sind Audio, Video, HID, Drucker, Speicher usw.

Im Folgenden finden Sie ein Beispiel für JSON-Daten:

{
"settings": {
"value": {
-  "settings_version": "1.0",
-  "device_settings": {
"deviceRules": {

    "allow": [
        {"vid": "11","pid": "22",  "split":true, "interfaceClass":["audio","video"]} //split device and allow redirection of 'audio' & 'video' interfaces.
    ],

    "deny": [
        {"vid": "33","pid": "44"},  //deny redirection of this whole device with vid= 33 & pid = 44, including all of its interfaces.
        {"vid": "77","pid": "88","split":true,"interfaceClass":["audio"]}    //split device and deny the redirection of 'audio' interface only; remaining interfaces(if any) are redirected through USB.
    ],

    "autoRedirect": [
    {"vid": "55","pid": "66"}, //auto redirect the device when it's connected.
    {"vid": "55","pid": "66","split":true,"interfaceClass":["hid"]} //split device and auto redirect only the 'hid' interface when the device is connected.
    ]
                }
           }
       }
    }
}
<!--NeedCopy-->

So verwenden Sie diese Funktion

So verwenden Sie die Funktion für die zusammengesetzte USB-Umleitung:

Klicken Sie in der Symbolleiste auf das USB-Symbol.

Wenn keine USB-Geräte angeschlossen sind, wird das folgende Pop-up angezeigt:
Schließen Sie ein USB-Gerät an Ihren lokalen Computer an. Das folgende Pop-up wird möglicherweise angezeigt:

1. Klicken Sie auf USB-Geräte, um die USB-Komponente anzuzeigen und umzuleiten. Nach einer erfolgreichen Verbindung erkennt die Citrix Workspace-App das USB-Gerät. Für jede USB-Komponentenschnittstelle wird ein Dropdown-Menü angezeigt. Die beiden Optionen sind:
- In-session and local machine access (Optimized): Wählen Sie diese Option, wenn Sie das USB-Gerät auf Ihrem Gerät und in einer Sitzung verwenden möchten.
- In-session access (Generic): Wählen Sie diese Option, wenn Sie das USB-Gerät nur in der Sitzung verwenden möchten. Wählen Sie für eine bessere Leistung die Option In-session and local machine access (Optimized).
1. Wählen Sie Verbinden, um die Schnittstelle umzuleiten.
Nach erfolgreicher Umleitung ändert sich der Status in Verbunden.

Hinweise:

Um ein USB-Gerät manuell hinzuzufügen, klicken Sie auf Gerät hinzufügen. Das Chrome-Auswahldialogfeld wird angezeigt, das die USB-Geräte auflistet. Sie können das Gerät aus der Liste auswählen.

Wenn eine USB-Geräteverbindung verweigert wird, wird die folgende Fehlermeldung angezeigt:

„Ihr Administrator hat das neu eingefügte Gerät blockiert. Wenden Sie sich an den Administrator Ihrer Organisation, um Unterstützung zu erhalten.

So übertragen Sie die USB-Schnittstelle zwischen den Sitzungen

Wenn Sie in der Symbolleiste auf das USB-Symbol klicken, wird eine Liste der USB-Geräte angezeigt, die mit Ihren Sitzungen verbunden sind. Wenn das USB-Gerät bereits in einer anderen Sitzung verwendet wird, sehen Sie, dass die USB-Komponente den Status Mit einer anderen Sitzung verbunden anzeigt.

Um zur aktuellen Sitzung umzuleiten, wählen Sie Verbinden, das sich gegenüber der USB-Komponente befindet. Der Status ändert sich entsprechend.

Einstellungen für die automatische Umleitung von Composite-USB-Geräten

Zuvor gab es keine Option für die Einstellungen zur automatischen USB-Umleitung, um die Präferenzen des Endbenutzers festzulegen. Da Administratoren diese Richtlinien steuern, musste der Endbenutzer die erforderlichen USB-Geräte bei jedem Sitzungsstart manuell umleiten.

Ab Version 2301 kann der Endbenutzer eine Präferenz für die automatische Umleitung für jedes USB-Gerät innerhalb einer Virtual Desktop-Sitzung auswählen. Die Citrix Workspace-App bietet jetzt Einstellungen auf App-Ebene, mit denen der Endbenutzer die automatische USB-Umleitung steuern kann. Der Endbenutzer kann Präferenzen festlegen und die Einstellungen über Sitzungsstarts hinweg speichern.

Es gibt zwei Optionen: eine beim Sitzungsstart und die andere während der laufenden Sitzung.

Automatische Umleitung

Hinweis:

Diese Funktion unterstützt On-Premises- und Cloud-Bereitstellungen und ist nur für verwaltete Chrome-Benutzer verfügbar.

Konfigurieren der zusammengesetzten USB-Umleitung über DDC-Richtlinien

Zuvor verwendeten Administratoren Google Admin-Richtlinien, um die clientseitige USB-Umleitung zu konfigurieren.

Ab der Version 2306 können Sie die USB-Umleitung auch über die DDC-Richtlinien konfigurieren. Konfigurationen über DDC-Richtlinien ermöglichen Administratoren eine einheitliche und zentrale Möglichkeit zur Definition von Richtlinien und Verhaltensweisen. Diese Richtlinien gelten für lokale und Cloud-Bereitstellungen auf verwalteten Geräten und für Benutzer. Diese Funktion wird ab VDA-Version 2212 unterstützt.

So konfigurieren Sie

Sie können diese Funktion auf eine der folgenden Arten konfigurieren:

Configuration.js
Google Admin Policy

Hinweis:

Die Richtlinie enableDDCUSBPolicy ist standardmäßig auf true gesetzt.

Configuration.js

Um diese Funktion mithilfe der Datei configuration.js zu deaktivieren, gehen Sie wie folgt vor:

Suchen Sie die Datei configuration.js im Ordner ChromeApp root.
Bearbeiten Sie die Datei.
Hinweise:
- Citrix empfiehlt, die Datei configuration.js vor dem Vornehmen von Änderungen zu sichern.
- Citrix empfiehlt, die Datei configuration.js nur zu bearbeiten, wenn die Citrix Workspace-App für ChromeOS für Benutzer neu verpackt wird.
- Zum Bearbeiten der Datei configuration.js sind Administratorberechtigungen erforderlich.
Setzen Sie den Wert von enableDDCUSBPolicy auf false. Es folgt ein Beispiel für JSON-Daten:
```
"features" : {
"usb" : {
   "enableDDCUSBPolicy": false
    }
}

```

1. Speichern Sie die Änderungen.

Google Admin-Richtlinie

Für verwaltete Geräte und Benutzer können Administratoren diese Funktion mithilfe der Google Admin-Richtlinie wie folgt deaktivieren:

Melden Sie sich bei der Google Admin-Richtlinie an.
Gehen Sie zu Geräteverwaltung > Chrome-Verwaltung > Benutzereinstellungen.
Fügen Sie die folgenden Zeichenfolgen zur Datei policy.txt unter dem Schlüssel engine_settings hinzu. Es folgt ein Beispiel für JSON-Daten:
```
    "features" : {
    "usb" : {
       "enableDDCUSBPolicy": false
    }
}

```
Speichern Sie die Änderungen.

DDC-Richtlinie

Der folgende Screenshot zeigt die DDC-Richtlinien, die sich auf die USB-Umleitung beziehen. Diese Funktion wird ab VDA-Version 2212 unterstützt.

DDC

Weitere Informationen zu den DDC-Richtlinien, die sich auf die USB-Umleitung beziehen, finden Sie in den folgenden Artikeln in der Citrix Virtual Apps and Desktops-Dokumentation:
Client-USB-Geräteumleitungsregeln
Vorhandene USB-Geräte automatisch verbinden lassen.
Neu angeschlossene USB-Geräte automatisch verbinden lassen.
Client-USB-Geräteumleitungsregeln (Version 2).

Automatische Umleitung von USB-Geräten

Um USB-Geräte automatisch umzuleiten, müssen Sie die USB-Geräteregeln befolgen. Sie können USB-Geräteregeln konfigurieren über:

Verbesserungen an der Benutzeroberfläche für zusammengesetzte USB-Geräte

Ab der Version 2306, wenn die Konfiguration eines zusammengesetzten USB-Geräts auf “split”: true gesetzt ist, zeigt die Benutzeroberfläche für USB-Geräte die Komponenten basierend auf Schnittstellennummern anstelle von Schnittstellenklassen an.

Weitere Informationen finden Sie im Artikel Umleitung zusammengesetzter USB-Geräte.

Benutzeroberfläche

Es folgt ein Beispiel:

Verbesserungen bei der Umleitung zusammengesetzter USB-Geräte über DDC-Richtlinien

Ab der Version 2307 können Sie festlegen, ob eine bestimmte zusammengesetzte USB-Schnittstelle oder -Klasse standardmäßig an den VDA umgeleitet werden kann oder nicht. Wenn ein zusammengesetztes USB-Gerät an das ChromeOS-Gerät angeschlossen ist, hilft Ihnen die Konfiguration enableDefaultAllowPolicy zu entscheiden, ob Sie die USB-Umleitung standardmäßig über DDC-Richtlinien zulassen können. VDA-Versionen 2212 und höher unterstützen diese Funktion.

Verwendung

Wenn Sie das Attribut enableDefaultAllowPolicy auf true setzen und eine bestimmte Schnittstellenklasse oder Schnittstellennummer an den VDA umleiten, müssen Sie eine Richtlinienregel hinzufügen, um die Umleitung der anderen Schnittstellenklassen oder -nummern zu verweigern. Sie können diese Funktion über die DDC-Richtlinie Client-USB-Geräteumleitungsregeln (Version 2) konfigurieren.

Weitere Informationen finden Sie unter USB-Geräteumleitungsregeln (Version 2). Darüber hinaus können Sie den verweigerten Teil über die Google Admin-Richtlinie konfigurieren, jedoch nur auf Ebene der Schnittstellenklasse.

Weitere Informationen finden Sie unter Verbesserungen an der Benutzeroberfläche für zusammengesetzte USB-Geräte.

Hier ist ein Beispiel für eine Konfiguration über die DDC-Richtlinie Client-USB-Geräteumleitungsregeln (Version 2), bei der Sie die Umleitung der Schnittstellennummer 03 zulassen.

```
"DENY: vid=1188 pid=A301 split=01 intf=00,01,02"
<!--NeedCopy--> ```

Hier ist eine Beispielkonfiguration über die Google Admin Policy-Regel, bei der Sie der HID-Schnittstelle erlauben, die Audio-Schnittstellenklasse umzuleiten und zu verweigern.

```
"deny": [
    {"vid":"05e9", "pid":"0428", "split":true, "interfaceClass":["audio"]
    }
]
<!--NeedCopy--> ```

Konfiguration

Sie können diese Funktion auf eine der folgenden Arten konfigurieren:

Configuration.js
Google Admin Policy

Hinweis:

Standardmäßig ist die Richtlinie enableDefaultAllowPolicy auf true gesetzt.

Configuration.js

Um diese Funktion mithilfe der Datei configuration.js zu deaktivieren, gehen Sie wie folgt vor:

Suchen Sie die Datei configuration.js im Ordner ChromeApp root.
Bearbeiten Sie die Datei.
Hinweise:
- Citrix empfiehlt, die Datei configuration.js zu sichern, bevor Sie Änderungen vornehmen.
- Citrix empfiehlt, die Datei configuration.js nur zu bearbeiten, wenn die Citrix Workspace-App für ChromeOS für Benutzer neu verpackt wird.
  - > - Zum Bearbeiten der Datei **configuration.js** sind Administratoranmeldeinformationen erforderlich.

1. Setzen Sie den Wert von enableDefaultAllowPolicy auf false.
Das Folgende ist ein Beispiel für JSON-Daten:
```
 "features" : {
 -  "usb" : {
     "enableDefaultAllowPolicy": false
 -  }
 -  }

 
```
- 1. Speichern Sie die Änderungen.

Google Admin Policy

Für verwaltete Geräte und Benutzer können Administratoren diese Funktion mithilfe der Google Admin Policy wie folgt deaktivieren:

Melden Sie sich bei der Google Admin Policy an.
Gehen Sie zu Geräteverwaltung > Chrome-Verwaltung > Benutzereinstellungen.
Fügen Sie die folgenden Zeichenfolgen zur Datei policy.txt unter dem Schlüssel engine_settings hinzu.

Das Folgende ist ein Beispiel für JSON-Daten:
```
'features' : {
    'usb' : {  
    'enableDefaultAllowPolicy': {"type": "false"}
    }
  }

```
Speichern Sie die Änderungen.

Umleitung des seriellen COM-Ports

Standardmäßig ordnet die Citrix Workspace-App für ChromeOS COM5 als bevorzugten seriellen COM-Port für die Umleitung zu.

Bekannte Einschränkungen

-  Serielle Eingabegeräte in Echtzeit, wie z. B. Unterschriftenpads, werden möglicherweise nicht innerhalb von Citrix Workspace-App für ChromeOS-Sitzungen umgeleitet. [CVADHELP-28555]

Konfiguration

Um die Umleitung des seriellen COM-Ports zu konfigurieren, aktivieren Sie die Funktion, indem Sie die Richtlinieneinstellungen für die Portumleitung von Citrix Virtual Apps and Desktops und Citrix DaaS anwenden. Weitere Informationen zur Portumleitung finden Sie unter Richtlinieneinstellungen für die Portumleitung.

Hinweis:

Standardmäßig ordnet die Citrix Workspace-App für ChromeOS COM5 als bevorzugten seriellen COM-Port für die Umleitung zu.

Nachdem Sie die Richtlinieneinstellungen für die Umleitung des seriellen COM-Ports auf dem VDA aktiviert haben, konfigurieren Sie die Citrix Workspace-App für ChromeOS mit einer der folgenden Methoden:

-  Google Admin Policy
-  Datei configuration.js
-  Ändern der Standardzuordnung durch Ausführen eines Befehls in einer aktiven ICA®-Sitzung.

Konfigurieren der COM-Port-Umleitung mithilfe der Google Admin Policy

Verwenden Sie diese Methode, um den seriellen COM-Port durch Bearbeiten der Richtliniendatei umzuleiten.

Tipp:

Citrix empfiehlt, den COM-Port nur dann über die Richtliniendatei zu konfigurieren, wenn die Citrix Workspace-App für ChromeOS neu verpackt wird.

Bearbeiten Sie die Google Admin Policy, indem Sie Folgendes hinzufügen:

    {
      "settings": {
               "Value": {
                "settings_version": "1.0",
                "store_settings": {
                "rf_web": {
                "url": "<http://YourStoreWebURL>"
                 }
                 },
                 "engine_settings":{
                 "features" : {
                 "com" : {
       "portname" : "<COM4>", where COM4 indicates the port number that is set by the administrator.                                                   }
                                      }
                                      }
                                      }
                                      }
                                     }

<!--NeedCopy-->

Liste der Optionen für serielle COM-Portnamen und deren Beschreibungen:

“portname”: Portnummer für den virtuellen COM (seriell)-Kanal. Standardmäßig ist der Wert COM5.

Konfigurieren der COM-Port-Umleitung mithilfe der Datei configuration.js

Verwenden Sie diese Methode, um den seriellen COM-Port durch Bearbeiten der Datei configuration.js umzuleiten. Suchen Sie das Feld portname in der Datei configuration.js und bearbeiten Sie den Wert, indem Sie die Portnummer ändern.

Zum Beispiel:

"com" :{

"portname" : "COM4"

}
<!--NeedCopy-->

Hinweis:

Citrix empfiehlt, die Methode der Datei configuration.js zur Konfiguration der seriellen Portumleitung nur zu verwenden, wenn die Citrix Workspace-App für ChromeOS neu verpackt und von StoreFront neu veröffentlicht wird.

Ausführen eines Befehls in einer ICA-Sitzung zur Konfiguration der COM-Port-Umleitung

Verwenden Sie diese Methode, um den seriellen COM-Port umzuleiten. Führen Sie den folgenden Befehl in einer aktiven ICA-Sitzung aus:

    net use COM4 : \\Client\COM5
<!--NeedCopy-->

Tipp:

Im obigen Beispiel ist COM4 der bevorzugte serielle Port, der für die Umleitung verwendet wird.

Persistente automatische USB-Umleitung

Ab Version 2505 werden USB-Geräte nun automatisch zu den bevorzugten virtuellen Apps oder Desktops umgeleitet, basierend auf den Richtlinieneinstellungen des Servers. Die Präferenz bleibt für nachfolgende Starts auf den bevorzugten Apps oder Desktops bestehen. Diese Verbesserung gewährleistet eine konsistente und nahtlose Erfahrung für Benutzer, die auf USB-Peripheriegeräte angewiesen sind.

Hinweis:

Diese Funktion ist standardmäßig deaktiviert.

Vorteile

Die folgenden Vorteile ergeben sich:

Sie verbessert die Produktivität, indem sie sicherstellt, dass Ihr USB-Gerät immer mit der richtigen Sitzung verbunden ist, selbst beim Multitasking oder beim Starten zusätzlicher Sitzungen.
Die USB-Umleitung bleibt bestehen, sodass Sie Ihr Gerät nicht jedes Mal neu konfigurieren müssen.

Konfiguration

Diese Funktion ist standardmäßig deaktiviert. Sie können die Funktion wie folgt aktivieren.

Google Admin-Richtlinie

Für verwaltete Geräte und Benutzer können Administratoren die Funktion mithilfe der Google Admin-Richtlinie wie folgt aktivieren:

Melden Sie sich bei der Google Admin-Richtlinie an.
Gehen Sie zu Geräteverwaltung > Chrome-Verwaltung > Benutzereinstellungen.
Fügen Sie die folgenden JSON-Zeichenfolgen zur Datei policy.txt unter dem Schlüssel engine_settings hinzu.
Hinweis: Sie können diese Konfiguration auch auf Folgendes anwenden:
- Gerät > Chrome > Apps und Erweiterungen > Benutzer und Browser > Nach der Erweiterung suchen > Richtlinie für Erweiterungen.
- Gerät > Chrome > Apps und Erweiterungen > Verwaltete Gast-Sitzungen > Nach der Erweiterung suchen > Richtlinie für Erweiterungen.

Stellen Sie sicher, dass Sie das Attribut alwaysAutoRedirectOnFirstSessionLaunch auf true setzen. Das folgende Beispiel zeigt JSON-Daten:

{
    "settings": {
        "Value": `
            "settings_version": "1.0",
            "engine_settings": {
                "features": {
                    "usb": {
                        "alwaysAutoRedirectOnFirstSessionLaunch": true
                    }
                }
            }
        }
    }
<!--NeedCopy-->

Speichern Sie die Änderungen.

Unterstützung für Scanner-Umleitung

Ab Version 2411 können Sie ein Scan-Gerät an Ihren lokalen Computer anschließen und den Scanner zu einer virtuellen Sitzung umleiten. Diese Funktion ermöglicht Ihnen den Zugriff auf die gescannten Dateien innerhalb einer Citrix Workspace™-App-Sitzung und das einfache Hochladen der Dokumente in jede andere App, die über die Citrix Workspace-App zugänglich ist.

Mit Version 2411 ist die optimierte Scanner-Umleitung allgemein verfügbar. Diese Funktion verbessert Leistung und Effizienz. Weitere Informationen finden Sie unter Scanner-Umleitung in der Citrix Virtual Apps and Desktops-Dokumentation.

Hinweise:

Diese Funktion ist ab Citrix Virtual Apps and Desktops™ Version 2411 standardmäßig aktiviert.

Um die Funktion für Citrix Virtual Apps and Desktops Version 2407 zu aktivieren, befolgen Sie die Schritte im Abschnitt Voraussetzungen.

Diese Funktion unterstützt Citrix Virtual Apps and Desktops Version 2407 und höher.

Funktionsunterstützung

Derzeit können Sie nur zwei Scanner anschließen, nämlich Fujitsu (fi-7160) und Fujitsu (fi-8170).

Voraussetzungen für die Scanner-Umleitung

Um die SANE-Umleitungsrichtlinie in DDC für Citrix Virtual Apps and Desktops Version 2407 zu aktivieren, führen Sie die folgenden Schritte aus:

Melden Sie sich bei der Desktop Delivery Controller™ (DDC)-Maschine an und öffnen Sie Citrix Studio.
Klicken Sie auf Richtlinien > Richtlinie erstellen. Das Dialogfeld Richtlinie erstellen wird angezeigt.
Suchen Sie nach SANE-Scanner-Umleitung, wie abgebildet.
Wählen Sie die Option SANE-Scanner-Umleitung. Das Dialogfeld Einstellungen bearbeiten wird angezeigt. Wählen Sie die Option Zulässig.
Klicken Sie auf OK.

Bekannte Einschränkungen der Funktion

Wenn eine Sitzung den Scanner verwendet und ein Scanvorgang läuft, führt der Versuch, den Scanner von einer zweiten Sitzung aus zu verwenden, dazu, dass der Scanvorgang der ersten Sitzung abrupt fehlschlägt.
Die Option Stilles Scannen, die das Scannen von Dokumenten ohne Benutzergenehmigung ermöglicht, ist in den Kiosk-Einstellungen der Google Admin Console nicht verfügbar. Weitere Informationen finden Sie im Partner-Ticket.
Einige Scanner-Funktionen funktionieren möglicherweise nicht wie erwartet. Zum Beispiel Seitenbreite, Seitenhöhe, Papierformat, Helligkeit und Kontrast. Das Problem tritt aufgrund eines Fehlers in der Scanner-API eines Drittanbieters bezüglich der Optionsdeskriptoren auf. [RFHTMCRM-13829]
Wenn ein Scanner an das Chromebook angeschlossen ist, kann gelegentlich eine Fehlermeldung von ChromeOS “Scannersoftware kann nicht installiert werden” auftreten. Später kann der Scanvorgang fehlschlagen. Weitere Informationen finden Sie im Partner-Ticket. [RFHTMCRM-15966]

Behobene Probleme seit der technischen Vorschau

Beim Versuch, mit einem umgeleiteten Scanner auf einem Chromebook zu scannen, können Endbenutzer gelegentlich den folgenden Fehler erhalten, der den Scanvorgang behindert: “TWAIN session open error: failure”.

Das Problem tritt auch dann auf, wenn der Scanner ordnungsgemäß angeschlossen und die SANE-Umleitungsrichtlinie aktiviert ist. [HDX-70122]
Nach dem Upgrade des VDA auf Version 2407 werden bestimmte Scan-Apps, die innerhalb der Citrix-Sitzung ausgeführt werden, beim Öffnen zeitweise nicht mehr reagieren. [HDX-70280]
In bestimmten Scan-Apps schlagen Duplex-Scannen (Scannen beider Seiten) und Mehrseiten-Scannen nach dem Scannen der ersten Seite fehl. Zum Beispiel eine Front-Office-Scan-App.
In bestimmten Scan-Apps ist die Farbpalette beim Scannen einer Seite falsch. Weitere Informationen finden Sie im Google Partner-Ticket. Zum Beispiel eine Front-Office-Scan-App.
Gelegentlich schlägt das Scannen eines Dokuments fehl, nachdem versucht wurde, mit einem leeren Fach zu scannen. Weitere Informationen finden Sie im Google Partner-Ticket.
Behobenes Problem in der optimierten Scanner-Umleitungsfunktion:
- Duplex-Scannen schlägt fehl, da die Benutzeroberfläche der Scanner-Anwendung die ADF-Duplex-Quellenauswahl nicht korrekt auslöst.
- Die Mehrseiten-Scan-Option scannt nur eine Seite, da die Scanner-Anwendung mehrere Seiten im Fach nicht korrekt verarbeitet.
- Das Überspringen leerer Seiten schlägt beim Duplex-Scannen fehl, da die Scanner-Anwendung diese Option im Vergleich zu den nativen Einstellungen nicht automatisch auswählt.
- Die Farbpalette der gescannten Seite erscheint falsch, da die Scanner-Anwendung Farben nicht genau wiedergibt.
Beim Scannen mit der Citrix Workspace-App für ChromeOS auf Google Cloud Platform (GCP) VDA-Servern kommt es zu konsistenten Verzögerungen oder Lags aufgrund plattformspezifischer Konnektivitätsprobleme, die nur ChromeOS-Endpunkte betreffen, die sich mit GCP-gehosteten VDAs verbinden. Ein Fix ist ab Citrix Apps and Desktops 2507 CU1 und höher verfügbar. [CVADHELP-29259]

Konfigurationen

Für verwaltete Benutzer können Administratoren die Option Stilles Scannen in der Google Admin Console aktivieren, um das Scannen von Dokumenten ohne Benutzergenehmigung zu ermöglichen.

So aktivieren Sie das stille Scannen:

Navigieren Sie zu Geräte > Chrome > Apps und Erweiterungen.
Wählen Sie die Citrix Workspace-App-ID aus.
Aktivieren Sie die Option Stilles Scannen im rechten Bereich.
Speichern Sie die Änderungen.

Die offizielle Version dieses Inhalts ist auf Englisch. Für den einfachen Einstieg wird Teil des Inhalts der Cloud Software Group Dokumentation maschinell übersetzt. Cloud Software Group hat keine Kontrolle über maschinell übersetzte Inhalte, die Fehler, Ungenauigkeiten oder eine ungeeignete Sprache enthalten können. Es wird keine Garantie, weder ausdrücklich noch stillschweigend, für die Genauigkeit, Zuverlässigkeit, Eignung oder Richtigkeit von Übersetzungen aus dem englischen Original in eine andere Sprache oder für die Konformität Ihres Cloud Software Group Produkts oder Ihres Diensts mit maschinell übersetzten Inhalten gegeben, und jegliche Garantie, die im Rahmen der anwendbaren Endbenutzer-Lizenzvereinbarung oder der Vertragsbedingungen oder einer anderen Vereinbarung mit Cloud Software Group gegeben wird, dass das Produkt oder den Dienst mit der Dokumentation übereinstimmt, gilt nicht in dem Umfang, in dem diese Dokumentation maschinell übersetzt wurde. Cloud Software Group kann nicht für Schäden oder Probleme verantwortlich gemacht werden, die durch die Verwendung maschinell übersetzter Inhalte entstehen können.

War dieser Artikel hilfreich?

Peripheriegeräte

April 21, 2026

Beitrag von:

C C

April 21, 2026

Beitrag von:

C C

In diesem Artikel

USB-Geräteumleitung
Automatische Umleitung von USB-Geräten im Kiosk-Modus
Double-Hop
Composite-USB-Umleitung
Einstellungen für die automatische Umleitung von Composite-USB-Geräten
Konfigurieren der zusammengesetzten USB-Umleitung über DDC-Richtlinien
Verbesserungen an der Benutzeroberfläche für zusammengesetzte USB-Geräte
Verbesserungen bei der Umleitung zusammengesetzter USB-Geräte über DDC-Richtlinien
Umleitung des seriellen COM-Ports
Unterstützung für Scanner-Umleitung

War dieser Artikel hilfreich?