Storebrowse
Storebrowse ist ein leichtes Befehlszeilenprogramm, das zur Interaktion zwischen Client und Server verwendet wird. Es wird verwendet, um alle Vorgänge innerhalb von StoreFront und mit Citrix Gateway zu authentifizieren.
-
Dokumentation zu älteren Versionen des Storebrowse-Dienstprogramms für Citrix Receiver für Windows finden Sie in der Dokumentation zu Storebrowse für Citrix Receiver für Windows.
-
Mithilfe des Storebrowse-Dienstprogramms können Administratoren die folgenden täglichen Vorgänge automatisieren:
- Einen Store hinzufügen.
- Die veröffentlichten Citrix Virtual Apps and Desktops™ und Citrix DaaS (ehemals Citrix Virtual Apps and Desktops Service) aus einem konfigurierten Store auflisten.
- Eine ICA-Datei generieren, indem beliebige veröffentlichte Citrix Virtual Apps and Desktops und Citrix DaaS manuell ausgewählt werden.
- Eine ICA®-Datei über die Storebrowse-Befehlszeile generieren.
- Die veröffentlichte Anwendung starten.
Das Storebrowse-Dienstprogramm ist jetzt Teil der Authmanager-Komponente. Nach der Installation der Citrix Workspace-App befindet sich das Storebrowse-Dienstprogramm im Installationsordner von AuthManager.
Sie können überprüfen, ob das Storebrowse-Dienstprogramm zusammen mit der Authmanager-Komponente installiert ist, indem Sie den Registrierungspfad auf folgende Weisen überprüfen:
Wenn die Citrix Workspace-App von Administratoren installiert wird:
| Auf einem 32-Bit-Computer | [HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\AuthManager\Install] |
| Auf einem 64-Bit-Computer | [HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\AuthManager\Install] |
Wenn die Citrix Workspace-App von Benutzern (Nicht-Administratoren) installiert wird:
| Auf einem 32-Bit-Computer | [HKEY_CURRENT_USER\SOFTWARE\Citrix\AuthManager\Install] |
| Auf einem 64-Bit-Computer | [HKEY_CURRENT_USER\SOFTWARE\WOW6432Node\Citrix\AuthManager\Install] |
Anforderungen
Installieren Sie die Citrix Workspace-App Version 1808 für Windows oder höher, damit das Storebrowse-Dienstprogramm nahtlos zwischen StoreFront und Citrix Gateway funktioniert. Die Citrix Workspace-App Version 1809 erfordert mindestens 530 MB freien Festplattenspeicher und 2 GB RAM für die Installation.
Kompatibilitätsmatrix
-
Das Storebrowse-Dienstprogramm ist mit den folgenden Betriebssystemen kompatibel:
-
Betriebssystem Windows 10 32-Bit- und 64-Bit-Editionen Windows 8.1, 32-Bit- und 64-Bit-Editionen Windows 7 SP1, 32-Bit- und 64-Bit-Editionen Windows Thin PC Windows Server 2016 -
Windows Server 2012 R2, Standard- und Datacenter-Editionen -
Windows Server 2012, Standard- und Datacenter-Editionen -
Windows Server 2008 R2, 64-Bit-Edition Windows Server 2008 R2, 64-Bit-Edition -
Verbindungen
Das Storebrowse-Dienstprogramm unterstützt die folgenden Verbindungstypen:
- HTTP-Store
- HTTPS-Store
- Citrix Gateway 11.0 und höher
Hinweis:
Das Storebrowse-Dienstprogramm akzeptiert keine Anmeldeinformationen über die Befehlszeile in einem HTTP-Store.
Authentifizierungsmethoden
StoreFront-Server
StoreFront unterstützt verschiedene Authentifizierungsmethoden für den Zugriff auf Stores, jedoch sind nicht alle empfohlen. Aus Sicherheitsgründen sind einige der Authentifizierungsmethoden standardmäßig deaktiviert, wenn ein Store erstellt wird.
- Benutzername und Kennwort: Benutzer können ihre Anmeldeinformationen eingeben und werden authentifiziert, wenn sie auf ihre Stores zugreifen. Die explizite Authentifizierung ist standardmäßig aktiviert, wenn Sie Ihren ersten Store erstellen. Alle Benutzerzugriffsmethoden unterstützen die explizite Authentifizierung.
- Domain-Pass-Through: Benutzer authentifizieren sich an ihren in die Domäne eingebundenen Windows-Computern und werden automatisch angemeldet, wenn sie auf ihre Stores zugreifen. Um diese Option zu verwenden, muss die Pass-Through-Authentifizierung aktiviert sein, wenn die Citrix Workspace-App auf den Benutzergeräten installiert wird. Weitere Informationen zur Konfiguration von Domain-Pass-Through finden Sie unter Konfigurieren der Pass-Through-Authentifizierung.
- HTTP Basic: Das Storebrowse-Dienstprogramm erfordert, dass die HTTP Basic-Authentifizierung aktiviert ist, um mit StoreFront-Servern zu kommunizieren. Diese Option ist standardmäßig auf dem StoreFront-Server deaktiviert. Sie müssen die HTTP Basic-Authentifizierungsmethode aktivieren.
Das Storebrowse-Dienstprogramm unterstützt Authentifizierungsmethoden auf eine der folgenden Weisen:
- Verwendung des
AuthManager, der zusammen mit dem Storebrowse-Dienstprogramm integriert ist. Hinweis: Sie müssen die HTTP Basic-Authentifizierungsmethode auf dem StoreFront aktivieren, wenn Sie mit dem Storebrowse-Dienstprogramm arbeiten. Dies gilt, wenn der Benutzer die Anmeldeinformationen über die Storebrowse-Befehle bereitstellt. - Externer
Authmanager, der in der Citrix Workspace-App für Windows enthalten sein kann.
Citrix Gateway-Unterstützung
Mit der neuesten Version des Storebrowse-Dienstprogramms können Sie jetzt eine Citrix Gateway-URL hinzufügen. Es ist keine zusätzliche Konfiguration im Storebrowse-Dienstprogramm erforderlich, um mit Citrix Gateway zu kommunizieren.
Single Sign-On mit Citrix Gateway
Zusätzlich zur neu hinzugefügten Citrix Gateway-Unterstützung können Sie jetzt Single Sign-On damit verwenden. Sie können einen neuen Store hinzufügen und die veröffentlichten Ressourcen auflisten, ohne Ihre Benutzeranmeldeinformationen angeben zu müssen.
Weitere Informationen zur Single Sign-On-Unterstützung mit Citrix Gateway finden Sie unter Unterstützung für Single Sign-On mit Citrix Gateway.
Hinweis:
Diese Funktion wird nur auf in die Domäne eingebundenen Computern unterstützt, auf denen Citrix Gateway mit der Single Sign-On-Authentifizierung konfiguriert ist.
Veröffentlichten Desktop oder Anwendung starten
Sie können jetzt eine Ressource direkt aus dem Store starten, ohne eine ICA-Datei verwenden zu müssen.
Befehlsverwendung
Der folgende Abschnitt enthält detaillierte Informationen zu den Befehlen, die Sie mit dem Storebrowse-Dienstprogramm verwenden können.
-a, –addstore
Beschreibung:
Fügt einen neuen Store hinzu. Gibt die vollständige URL des Stores zurück. Schlägt dies fehl, wird ein Fehler gemeldet.
Hinweis:
Sie können mehrere Stores mit dem Storebrowse-Dienstprogramm hinzufügen.
Befehlsbeispiel für StoreFront:
Befehl:
storebrowse.exe –U *Benutzername* -P *Kennwort* -D *Domäne* -a *URL des StoreFront*
Beispiel:
.\storebrowse.exe –U {Benutzername} –P {Kennwort} –D {Domäne} –a [https://my.firstexamplestore.net](https://my.firstexamplestore.net)
Befehlsbeispiel auf Citrix Gateway:
Befehl:
storebrowse.exe –U *Benutzername* -P *Passwort* -D *Domäne* -a *URL des Citrix Gateway*
Beispiel:
.\storebrowse.exe –U {Benutzername} –P {Passwort} –D {Domäne} –a <https://mysecondexample.com>
/?
Beschreibung:
Bietet Details zur Verwendung des Storebrowse-Dienstprogramms.
(-l), –liststore
Beschreibung:
Listet die vom Benutzer hinzugefügten Stores auf.
Befehlsbeispiel auf StoreFront:
.\storebrowse.exe –l
Befehlsbeispiel auf Citrix Gateway:
.\storebrowse.exe –l
(-M 0x2000 -E)
Beschreibung:
Listet die verfügbaren Ressourcen auf.
Befehlsbeispiel auf StoreFront:
.\storebrowse.exe –U {Benutzername} –P {Passwort} –D {Domäne} –M 0x2000 –E <https://my.firstexamplestore.net/Citrix/Store/discovery>
Befehlsbeispiel auf Citrix Gateway:
.\storebrowse.exe –U {Benutzername} –P {Passwort} –D {Domäne} –M 0x2000 –E <https://my.secondexample.net>
-q, –quicklaunch
Beschreibung:
Generiert die erforderliche ICA-Datei für veröffentlichte Apps und Desktops mithilfe des Storebrowse-Dienstprogramms. Die Option quicklaunch erfordert eine Start-URL als Eingabe zusammen mit der Store-URL, die entweder der StoreFront-Server oder die Citrix Gateway-URL sein kann. Die ICA-Datei wird im Verzeichnis %LocalAppData%\Citrix\Storebrowse\cache generiert.
-
Sie können die Start-URL für alle veröffentlichten Apps und Desktops abrufen, indem Sie den folgenden Befehl ausführen:
-
.\storebrowse –M 0X2000 –E https://myfirstexamplestore.net/Citrix/Second/discovery -
Eine typische Start-URL sieht wie folgt aus:
'Controller.Calculator' 'Calculator' '\' '' http://abc-sf.xyz.com/Citrix/Stress/resources/v2/Q29udHJvbGxlci5DYWxjdWxhdG9y/launch/ica
Befehlsbeispiel auf StoreFront:
.\storebrowse.exe –U {Benutzername} –P {Passwort}–D {Domäne} –q {Start_URL_veröffentlichter_ Apps und Desktops }<https://my.firstexamplestore.net/Citrix/Store/resources/v2/Q2hJkOlmNoPQrSTV9y/launch/ica> <https://my.firstexamplestore.net/Citrix/Store/discovery>
Befehlsbeispiel auf Citrix Gateway:
.\storebrowse.exe –U {Benutzername} –P {Passwort} –D {Domäne} –q {Start_URL_veröffentlichter_ Apps und Desktops} <https://my.secondexmaplestore.com>
-L, –launch
Beschreibung:
Generiert die erforderliche ICA-Datei für veröffentlichte Apps und Desktops mithilfe des Storebrowse-Dienstprogramms. Die Option launch erfordert den Namen der Ressource zusammen mit der Store-URL, die entweder der StoreFront-Server oder die Citrix Gateway-URL sein kann. Die ICA-Datei wird im Verzeichnis %LocalAppData%\Citrix\Storebrowse\cache generiert.
Sie können den Anzeigenamen der veröffentlichten Apps und Desktops abrufen, indem Sie den folgenden Befehl ausführen:
.\storebrowse –M 0X2000 –E https://myfirstexamplestore.net/Citrix/Second/discovery
Dieser Befehl führt zu folgender Ausgabe:
'Controller.Calculator' 'Calculator' '\' '' http://abc-sf.xyz.com/Citrix/Stress/resources/v2/Q29udHJvbGxlci5DYWxjdWxhdG9y/launch/ica
Der Name, der in der obigen Ausgabe fett gedruckt ist, wird als Eingabeparameter für die Option launch verwendet.
Befehlsbeispiel auf StoreFront:
.\storebrowse.exe -U {Benutzername} –P {Passwort} –D {Domäne} –L “{Ressourcenname} <https://my.firstexamplestore.net/Citrix/Store/discovery>
Befehlsbeispiel auf Citrix Gateway:
<.\storebrowse.exe –U {Benutzername} –P {Passwort} –D {Domäne} –L {Ressourcenname} https://my.secondexamplestore.com>
-S, –sessionlaunch
Beschreibung:
Sie können den Store hinzufügen, die veröffentlichten Ressourcen (Apps und Desktops) aufzählen und die Ressource mit einem einzigen Befehl starten. Diese Option akzeptiert die folgenden Parameter: Benutzername, Kennwort, Domäne, Anzeigename der zu startenden Ressource und die Store-URL. Wenn der Benutzer jedoch die Anmeldeinformationen nicht angibt, wird eine AuthManager-Eingabeaufforderung zur Eingabe der Anmeldeinformationen angezeigt, und anschließend wird die Ressource gestartet.
Sie können den Namen der Ressource von veröffentlichten Apps und Desktops abrufen, indem Sie den folgenden Befehl ausführen:
.\storebrowse –M 0X2000 –E https://myfirstexamplestore.net/Citrix/Second/discovery
Dieser Befehl führt zu der folgenden Ausgabe:
'Controller.Calculator' 'Calculator' '\' '' http://abc-sf.xyz.com/Citrix/Stress/resources/v2/Q29udHJvbGxlci5DYWxjdWxhdG9y/launch/ica
Der in der obigen Ausgabe fettgedruckte Name wird als Eingabeparameter für die Option -S verwendet.
Befehlsbeispiel für StoreFront:
.\storebrowse.exe -U {Username} –P {Password} –D {Domain} –S “{Friendly_Resource_Name} <https://my.firstexamplestore.net/Citrix/Store/discovery >
Befehlsbeispiel für Citrix Gateway:
.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –S {Friendly_Resource_Name} <https://my.secondexamplestore.com>
-f, –filefolder
Beschreibung:
Generiert die erforderliche ICA-Datei im benutzerdefinierten Pfad, wie in der Option –f definiert, für alle veröffentlichten Apps und Desktops mithilfe des Storebrowse-Dienstprogramms.
Die Startoption erfordert einen Ordnernamen zusammen mit dem Namen der Ressource als Eingabe mit der Store-URL, die entweder ein StoreFront-Server oder eine Citrix Gateway-URL ist.
Befehlsbeispiel für StoreFront:
.\storebrowse.exe –f “C:\Temp\Launch.ica” –L “Resource_Name” {Store}
Befehlsbeispiel für Citrix Gateway:
.\storebrowse.exe –f “C:\Temp\Launch.ica” –L “Resource_Name” {NSG_URL}
-t, –traceauthentication
Beschreibung:
Generiert Protokolle für die integrierte AuthManager-Komponente des Storebrowse-Dienstprogramms. Protokolle werden nur generiert, wenn das Storebrowse-Dienstprogramm einen integrierten AuthManager verwendet. Protokolle werden im Verzeichnis localappdata%\Citrix\Storebrowse\logs generiert.
Hinweis: Diese Option darf nicht der letzte Parameter in der Befehlszeile des Benutzers sein.
Befehlsbeispiel für StoreFront:
.\storebrowse.exe –t –U {UserName} –P {Password} –D {Domain} –a {StoreURL}
Befehlsbeispiel für Citrix Gateway:
.\storebrowse.exe –t –U {UserName} –P {Password} –D {Domain} –a {NSG_URL}
-d, –deletestore
Beschreibung:
Löscht einen vorhandenen StoreFront- oder Citrix Gateway-Store.
Befehlsbeispiel für StoreFront:
.\storebrowse.exe –d https://my.firstexamplestore.net/Citrix/Store/discovery
Befehlsbeispiel für Citrix Gateway:
.\storebrowse.exe –d https://my.secondexmaplestore.com
Single Sign-On-Unterstützung mit Citrix Gateway
Single Sign-On ermöglicht Ihnen die Authentifizierung bei einer Domäne und die Nutzung von Citrix Virtual Apps and Desktops und Citrix DaaS™, die von dieser Domäne bereitgestellt werden, ohne sich bei jeder App oder jedem Desktop erneut authentifizieren zu müssen. Wenn Sie einen Store mit dem Storebrowse-Dienstprogramm hinzufügen, werden Ihre Anmeldeinformationen an den Citrix Gateway-Server übermittelt, zusammen mit den für Sie aufgezählten virtuellen Apps und Desktops, einschließlich Ihrer Startmenüeinstellungen. Nach der Konfiguration von Single Sign-On können Sie den Store hinzufügen, die virtuellen Apps und Desktops aufzählen und die erforderliche Ressource starten, ohne Ihre Anmeldeinformationen mehrmals eingeben zu müssen.
Diese Funktion wird ab Citrix Gateway Version 11 unterstützt.
Voraussetzungen:
Informationen zu den Voraussetzungen für die Konfiguration von Single Sign-On für Citrix Gateway finden Sie unter Configure domain pass-through authentication.
Die Single Sign-On-Funktion mit Citrix Gateway kann mithilfe der administrativen Gruppenrichtlinienobjekt (GPO)-Vorlage aktiviert werden.
Hinweis:
Wenn Sie von Citrix Receiver auf die Citrix Workspace-App aktualisieren oder die Citrix Workspace-App zum ersten Mal neu installieren, müssen Sie die neuesten Vorlagendateien zum lokalen GPO hinzufügen. Weitere Informationen zum Hinzufügen von Vorlagendateien zum lokalen GPO finden Sie unter Configuring Group Policy Object administrative template. Im Falle eines Upgrades bleiben die vorhandenen Einstellungen beim Import der neuesten Dateien erhalten.
- Öffnen Sie die administrative GPO-Vorlage der Citrix Workspace-App, indem Sie gpedit.msc ausführen.
- Navigieren Sie unter dem Knoten Computerkonfiguration zu Administrative Vorlagen > Citrix Komponenten > Citrix Workspace > Benutzerauthentifizierung > Single Sign-On für Citrix Gateway.
- Verwenden Sie die Umschaltoptionen, um die Single Sign-On-Option zu aktivieren oder zu deaktivieren.
- Klicken Sie auf Übernehmen und OK.
- Starten Sie die Citrix Workspace-App-Sitzung neu, damit die Änderungen wirksam werden.
Einschränkungen:
- Die HTTP Basic Authentication-Methode muss auf dem StoreFront-Server für Anmeldeinformationsinjektionsvorgänge mit dem Storebrowse-Dienstprogramm aktiviert sein.
- Wenn Sie einen HTTP-Store haben und versuchen, sich über das Dienstprogramm mit dem Store zu verbinden, um die veröffentlichten virtuellen Apps und Desktops aufzuzählen oder zu starten, wird die Anmeldeinformationsinjektion über die Befehlszeilenoption nicht unterstützt. Als Workaround verwenden Sie das externe
AuthManager-Modul, das ausgelöst wird, wenn Sie keine Anmeldeinformationen über die Befehlszeile angeben. - Das Storebrowse-Dienstprogramm unterstützt derzeit nur ein einzelnes, mit Citrix Gateway konfiguriertes StoreFront auf dem StoreFront-Server.
- Die Anmeldeinformationsinjektion im Storebrowse-Dienstprogramm funktioniert nur, wenn Citrix Gateway mit Single-Factor Authentication konfiguriert ist.
- Die Befehlszeilenoptionen
Username (-U),Password (-P)undDomain (-D)des Storebrowse-Dienstprogramms sind Groß- und Kleinschreibung-sensitiv und müssen nur in Großbuchstaben angegeben werden.