Skip to main content

6. Januar 2026

Festlegen der USB-Konfigurationseigenschaften

Sie können USB-Konfigurationseigenschaften in den Konfigurationsdateien festlegen.

Verwenden Sie die folgende Syntax, um diese USB-Konfigurationseigenschaften in den Konfigurationsdateien festzulegen.

viewusb.property1 = "value1"

Mit den USB-Konfigurationseigenschaften können Sie steuern, ob bestimmte Gerätetypen umgeleitet werden. Es stehen auch Filtereigenschaften zur Verfügung, sodass Sie bestimmte Gerätetypen ausschließen und einschließen können. Eigenschaften für das Splitten von Verbundgeräten werden ebenfalls bereitgestellt.

Manche Eigenschaftswerte erfordern für ein USB-Gerät die VID (Anbieter-ID) und die PID (Produkt-ID). Die korrekte VID und PID finden Sie, indem Sie im Internet nach dem Produktnamen plus vid und pid suchen.

Die folgende Tabelle beschreibt die verfügbaren USB-Konfigurationseigenschaften.

Konfigurationseigenschaften für die USB-Umleitung
Name und Eigenschaft der RichtlinieBeschreibung
Autom. Gerätesplitten zulassen Eigenschaft: viewusb.AllowAutoDeviceSplittingLässt das automatische Splitten von Composite USB-Geräten zu. Der Standardwert ist nicht definiert und entspricht false.
Vid/Pid-Gerät vom Splitten ausschließen Eigenschaft: viewusb.SplitExcludeVidPidSchließt ein Composite USB-Gerät vom Splitten aus, das durch Anbieter- und Produkt-IDs angegeben ist. Das Format der Einstellung lautet vid-xxx1_pid-yyy1[;vid-xxx2_pid-yyy2]... Sie müssen hexadezimale ID-Nummern angeben. Sie können das Platzhalterzeichen (*) anstelle einzelner Ziffern in einer ID verwenden. Zum Beispiel: vid-0781_pid-55** Der Standardwert ist nicht definiert.
Vid/Pid-Gerät splitten Eigenschaft: viewusb.SplitVidPidBehandelt die Komponenten eines Composite USB-Gerätes, die durch Anbieter- und Produkt-IDs angegeben sind, als separate Geräte. Das Format der Einstellung ist vid-xxxx_pid-yyyy([exintf:zz[;exintf:ww ]])[;...] Sie können das Stichwort exintf verwenden, um Komponenten durch Angabe ihrer Schnittstellennummer von der Umleitung auszuschließen. Sie müssen hexadezimale ID-Nummern und dezimale Schnittstellennummern einschließlich der 0 am Anfang angeben. Sie können das Platzhalterzeichen (*) anstelle einzelner Ziffern in einer ID verwenden. Zum Beispiel: vid-0781_pid-554c(exintf:01;exintf:02) Hinweis: Wenn das Verbundgerät Komponenten enthält, die automatisch ausgeschlossen werden, wie z. B. Maus- und Tastaturkomponenten, schließt Horizon Client die Komponenten, die Sie nicht ausdrücklich ausgeschlossen haben, nicht automatisch ein. Sie müssen eine Filterrichtlinie wie z. B. Vid/Pid-Gerät einbeziehen angeben, um diese Komponenten einzubeziehen. Der Standardwert ist nicht definiert.
Audioeingabegeräte zulassen Eigenschaft: viewusb.AllowAudioInLässt zu, dass Audioeingabegeräte umgeleitet werden. Der Standardwert ist nicht definiert, was false entspricht, da für Audioeingabe- und Videogeräte die Echtzeit-Audio/Video-Funktion verwendet wird, und die USB-Umleitung für diese Geräte standardmäßig nicht verwendet wird.
Audioausgabegeräte zulassen Eigenschaft: viewusb.AllowAudioOutLässt zu, dass Audioausgabegeräte umgeleitet werden. Der Standardwert ist nicht definiert und entspricht false.
HID zulassen Eigenschaft: viewusb.AllowHIDErmöglicht die Umleitung anderer Eingabegeräte außer Tastatur- und Mausgeräten. Der Standardwert ist nicht definiert und entspricht true.
Startfähige Eingabegeräte zulassen Eigenschaft: viewusb.AllowHIDBootableErmöglicht die Umleitung anderer Eingabegeräte als Tastaturen und Mäusen, die zur Startzeit verfügbar sind (auch „startfähige Human Interface Devices [HID]“ genannt). Der Standardwert ist nicht definiert und entspricht true.
Ausfallsicherung für die Gerätebeschreibung zulassen Eigenschaft: viewusb.AllowDevDescFailsafeLässt das Umleiten von Geräten auch dann zu, wenn Horizon Client die Konfigurations-/Gerätebeschreibungen nicht abrufen kann. Um ein Gerät trotz Fehler in der Konfiguration/Beschreibung zuzulassen, muss dieses in den Filter „Include“ eingeschlossen werden, zum Beispiel in IncludeVidPid oder IncludePath. Der Standardwert ist nicht definiert und entspricht false.
Tastatur- und Mausgeräte zulassen Eigenschaft: viewusb.AllowKeyboardMouseLässt zu, dass Tastaturen mit eingebauten Zeigegeräten (Maus, Trackball oder Touchpad) umgeleitet werden. Der Standardwert ist nicht definiert und entspricht false.
Smartcards zulassen Eigenschaft: viewusb.AllowSmartcardLässt zu, dass Smartcard-Geräte umgeleitet werden. Der Standardwert ist nicht definiert und entspricht false.
Videogeräte zulassen Eigenschaft: viewusb.AllowVideoLässt zu, dass Videogeräte umgeleitet werden. Der Standardwert ist nicht definiert, was false entspricht, da für Audioeingabe- und Videogeräte die Echtzeit-Audio/Video-Funktion verwendet wird, und die USB-Umleitung für diese Geräte standardmäßig nicht verwendet wird.
Remote-Konfigurations-Download deaktivieren Eigenschaft: viewusb.DisableRemoteConfigVerhindert die Verwendung der Horizon Agent-Einstellungen beim Durchführen der USB-Gerätefilterung. Der Standardwert ist nicht definiert und entspricht false.
Alle Geräte ausschließen Eigenschaft: viewusb.ExcludeAllDevicesSchließt alle USB-Geräte von der Umleitung aus. Wenn die Einstellung auf true festgelegt ist, können Sie andere Richtlinieneinstellungen verwenden, um zuzulassen, dass bestimmte Geräte oder Gerätefamilien umgeleitet werden. Wenn die Einstellung auf false festgelegt ist, können Sie andere Richtlinieneinstellungen verwenden, um zu verhindern, dass bestimmte Geräte oder Gerätefamilien umgeleitet werden. Wenn Sie auf dem Horizon Agent den Wert von „Alle Geräte ausschließen“ auf true festlegen und diese Einstellung an Horizon Client übergeben wird, hat die Horizon Agent-Einstellung Vorrang vor der Horizon Client-Einstellung. Der Standardwert ist nicht definiert und entspricht false.
Gerätefamilie ausschließen Eigenschaft: viewusb.ExcludeFamilySchließt Gerätefamilien von der Umleitung aus. Das Format der Einstellung lautet family_name_1[;family_name_2]... Zum Beispiel: bluetooth;smart-card Wenn Sie das automatische Gerätesplitten aktiviert haben, prüft Horizon Client die Gerätefamilie jeder Schnittstelle eines USB-Verbundgerätes, um zu entscheiden, welche Schnittstelle ausgeschlossen werden sollte. Wenn Sie das automatische Gerätesplitten deaktiviert haben, prüft Horizon Client die Gerätefamilie des gesamten USB-Verbundgeräts. Der Standardwert ist nicht definiert.
Vid/Pid-Gerät ausschließen Eigenschaft: viewusb.ExcludeVidPidSchließt Geräte mit spezifischen Anbieter- oder Produkt-IDs von der Umleitung aus. Das Format der Einstellung lautet vid-xxx1_pid-yyy2[;vid-xxx2_pid-yyy2]... Sie müssen hexadezimale ID-Nummern angeben. Sie können das Platzhalterzeichen (*) anstelle einzelner Ziffern in einer ID verwenden. Zum Beispiel: vid-0781_pid-****;vid-0561_pid-554c Der Standardwert ist nicht definiert.
Pfad ausschließen Eigenschaft: viewusb.ExcludePath Schließt Geräte an angegebenen Hub- oder Portpfaden von der Umleitung aus. Das Format der Einstellung lautet bus-x1[/y1]..._port-z1[;bus-x2[/y2]..._port-z2]... Bus- und Portnummern müssen im hexadezimalen Format angegeben werden. Sie können das Platzhalterzeichen nicht in Pfaden verwenden. Zum Beispiel: bus-1/2/3_port-02;bus-1/1/1/4_port-ff Der Standardwert ist nicht definiert.
Gerätefamilie einschließen Eigenschaft: viewusb.IncludeFamily Bestimmt Gerätefamilien, die umgeleitet werden können. Das Format der Einstellung lautet family_name_1[;family_name_2]... Zum Beispiel: storage Der Standardwert ist nicht definiert.
Pfad einschließen Eigenschaft: viewusb.IncludePath Schließt Geräte an angegebenen Hub- oder Portpfaden in die Umleitung ein. Das Format der Einstellung lautet bus-x1[/y1]..._port-z1[;bus-x2[/y2]..._port-z2]... Bus- und Portnummern müssen im hexadezimalen Format angegeben werden. Sie können das Platzhalterzeichen nicht in Pfaden verwenden. Zum Beispiel: bus-1/2_port-02;bus-1/7/1/4_port-0f Der Standardwert ist nicht definiert.
Vid/Pid-Gerät einschließen Eigenschaft: viewusb.IncludeVidPid Enthält Geräte mit bestimmten Anbieter- und Produkt-IDs, die umgeleitet werden können. Das Format der Einstellung lautet vid-xxx1_pid-yyy2[;vid-xxx2_pid-yyy2]... Sie müssen hexadezimale ID-Nummern angeben. Sie können das Platzhalterzeichen (*) anstelle einzelner Ziffern in einer ID verwenden. Zum Beispiel: vid-0561_pid-554c Der Standardwert ist nicht definiert.
Automatische Weiterleitung von Gerätefamilien ausschließen Eigenschaft: viewusb.ExAutoRedirectFamily Schließt Gerätefamilien von der automatischen Weiterleitung aus. Das Format der Einstellung lautet family_name_1[;family_name_2]... Zum Beispiel: storage Der Standardwert ist nicht definiert.
Automatische Weiterleitung des Vid/Pid-Geräts ausschließen Eigenschaft: viewusb.ExAutoRedirectVidPid Schließt Geräte mit bestimmten Anbieter- und Produkt-IDs von der automatischen Weiterleitung aus. Das Format der Einstellung lautet vid-xxx1_pid-yyy2[;vid-xxx2_pid-yyy2]... Sie müssen hexadezimale ID-Nummern angeben. Sie können das Platzhalterzeichen (*) anstelle einzelner Ziffern in einer ID verwenden. Zum Beispiel: vid-0561_pid-554c Der Standardwert ist nicht definiert.

Beispiele für USB-Umleitung

Für jedes Beispiel wird eine Beschreibung der Auswirkung auf die USB-Umleitung gezeigt.

  • Beziehen Sie die meisten Geräte der Familie der Mausgeräte ein.

    viewusb.IncludeFamily = "mouse" 
    viewusb.ExcludeVidPid = "Vid-0461_Pid-0010;Vid-0461_Pid-4d20"
    

    Die erste Eigenschaft in diesem Beispiel weist Horizon Client an, die Umleitung von Mausgeräten zu einem Remote-Desktop zuzulassen. Die zweite Eigenschaft überschreibt die erste und weist Horizon Client an, zwei bestimmte Mausgeräte lokal zu halten und nicht umzuleiten.

  • Aktivieren Sie das automatische Gerätesplitten, aber schließen Sie ein bestimmtes Gerät aus dem Splitten aus. Für ein bestimmtes anderes Gerät behalten Sie eine seiner Komponenten lokal und leiten die anderen Komponenten auf den Remote-Desktop um:

    viewusb.AllowAutoDeviceSplitting = "True"
    viewusb.SplitExcludeVidPid = "Vid-03f0_Pid-2a12"
    viewusb.SplitVidPid = "Vid-0911_Pid-149a(exintf:03)"
    viewusb.IncludeVidPid = "Vid-0911_Pid-149a"
    

    Bei USB-Verbundgeräten handelt es sich um eine Kombination aus zwei oder mehr Geräten, zum Beispiel einem Videoeingabegerät und einem Speichergerät. Die erste Eigenschaft in diesem Beispiel aktiviert das automatische Splitten von Verbundgeräten. Die zweite Eigenschaft schließt das angegebene USB-Verbundgerät (Vid-03f0_Pid-2a12) vom Splitten aus.

    Die dritte Zeile weist Horizon Client dazu an, die Komponenten eines anderen Verbundgeräts (Vid-0911_Pid-149a) als separate Geräte zu behandeln, die Komponente mit der Schnittstellennummer „03“ jedoch von der Umleitung auszuschließen. Diese Komponente wird lokal beibehalten.

    Da dieses Verbundgerät eine Komponente enthält, die im Regelfall standardmäßig ausgeschlossen wird, zum Beispiel eine Maus oder eine Tastatur, ist die vierte Zeile notwendig, damit andere Komponenten des Verbundgeräts Vid-0911_Pid-149a an den Remote-Desktop umgeleitet werden können.

    Die ersten drei Eigenschaften sind Aufschlüsselungseigenschaften. Die letzte Eigenschaft ist eine Filtereigenschaft. Filtereigenschaften werden vor den Aufschlüsselungseigenschaften verarbeitet.

Wichtig: Diese Konfigurationseigenschaften des Clients können mit den entsprechenden für Horizon Agent auf dem Remote-Desktop festgelegten Richtlinien zusammengeführt oder von diesen überschrieben werden. Informationen darüber, wie die Eigenschaften der USB-Aufschlüsselung und -Filterung auf dem Client mit den USB-Richtlinien für Horizon Agent zusammenarbeiten, finden Sie im Dokument Horizon-Remote-Desktopfunktionen und GPOs.

War diese Seite hilfreich?

Feedback zu diesem Thema geben

War dieses Thema hilfreich?

Bitte geben Sie keine personenbezogenen oder vertraulichen Daten an.

Link wird erstellt…