Storebrowse

Hinweis:

Dieser Artikel gilt nur für lokale Bereitstellungen von Citrix Workspace. Informationen zu Cloud-Bereitstellungen finden Sie in der Dokumentation zu Storebrowse für Workspace.

• Storebrowse ist ein Befehlszeilendienstprogramm, das zwischen Client und Server interagiert. Es wird verwendet, um alle Vorgänge innerhalb von StoreFront und mit Citrix Gateway zu authentifizieren.

• Mithilfe des Dienstprogramms Storebrowse können Administratoren die folgenden Vorgänge automatisieren:

• Einen Store hinzufügen.
• Die veröffentlichten Apps und Desktops aus einem konfigurierten Store auflisten.
• Eine ICA®-Datei manuell durch Auswahl beliebiger veröffentlichter virtueller Apps und Desktops generieren.
• Eine ICA-Datei über die Storebrowse-Befehlszeile generieren.
• Die veröffentlichte Anwendung starten.

Das Dienstprogramm Storebrowse ist Teil der Komponente Authmanager. Nach Abschluss der Installation der Citrix Workspace-App befindet sich das Dienstprogramm Storebrowse im Installationsordner von AuthManager.

Um zu bestätigen, dass das Dienstprogramm Storebrowse zusammen mit der Komponente Authmanager installiert ist, überprüfen Sie den folgenden Registrierungspfad:

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:

Anforderungen

• Citrix Workspace-App Version 1808 für Windows oder höher.
• Mindestens 530 MB freier Speicherplatz.

• 2 GB RAM.

• Kompatibilitätsmatrix

Das Dienstprogramm Storebrowse ist mit den folgenden Betriebssystemen kompatibel:

• Windows Server 2022

• Windows Server 2016

• Windows Server 2008 R2, 64-Bit-Edition

  Windows Server 2008 R2, 64-Bit-Edition

• Verbindungen

Das Dienstprogramm Storebrowse unterstützt die folgenden Verbindungstypen:

• HTTP-Store
• HTTPS-Store
• Citrix Gateway 11.0 und höher

Hinweis:

Bei einem HTTP-Store akzeptiert das Dienstprogramm Storebrowse keine Anmeldeinformationen über die Befehlszeile.

Authentifizierungsmethoden

StoreFront-Server

StoreFront unterstützt verschiedene Authentifizierungsmethoden für den Zugriff auf Stores, jedoch werden nicht alle empfohlen. Aus Sicherheitsgründen sind einige der Authentifizierungsmethoden standardmäßig deaktiviert, wenn Sie einen Store erstellen.

• Benutzername und Kennwort: Geben Sie die Anmeldeinformationen ein, die zur Authentifizierung für den Zugriff auf Stores verwendet werden sollen. Standardmäßig ist die explizite Authentifizierung aktiviert, wenn Sie Ihren ersten Store erstellen.
• Domänen-Passthrough: Nach der Authentifizierung an den in die Domäne eingebundenen Windows-Computern werden Sie automatisch bei Stores angemeldet. Um diese Option zu verwenden, aktivieren Sie die Passthrough-Authentifizierung bei der Installation der Citrix Workspace-App. Weitere Informationen zur Domänen-Passthrough-Authentifizierung finden Sie unter Konfigurieren der Passthrough-Authentifizierung.
• HTTP Basic: Diese Methode wird von Clientintegrationen und Webportalen von Drittanbietern verwendet, bei denen eine externe Benutzeroberfläche zur Erfassung eines domänenqualifizierten Benutzernamens und Kennworts verwendet wurde. StoreFront verwendet die Basic Authentication-Funktion in IIS, um die Anmeldeinformationen an den StoreFront-Server zu übertragen. StoreFront verwendet dann entweder die Domain Services oder die Broker XML Service authentication, um die Anmeldeinformationen zu validieren und die Gruppeninformationen abzurufen. Informationen zum Aktivieren der HTTP Basic-Authentifizierung finden Sie unter HTTP Basic in der Dokumentation Authentifizierungsmethoden verwalten.

Das Dienstprogramm Storebrowse unterstützt Authentifizierungsmethoden in einer der folgenden Weisen:

• Verwenden des AuthManager, der zusammen mit dem Dienstprogramm Storebrowse integriert ist. Hinweis: Aktivieren Sie die HTTP Basic-Authentifizierungsmethode auf StoreFront, wenn Sie mit dem Dienstprogramm Storebrowse arbeiten. Diese Methode wird angewendet, wenn der Benutzer die Anmeldeinformationen über die Storebrowse-Befehle bereitstellt.
• Verwenden des Authmanager, der in der Citrix Workspace-App für Windows enthalten ist. Sie können diese Methode verwenden, wenn Sie die Domänen-Passthrough-Authentifizierung nutzen. Weitere Informationen finden Sie in der Dokumentation zur Domänen-Passthrough-Authentifizierung.

Veröffentlichten Desktop oder Anwendung starten

Sie können eine Ressource jetzt direkt aus dem Store starten, ohne eine ICA-Datei verwenden zu müssen.

Hinweis:

Sie können SaaS-Apps oder veröffentlichte Inhalte nicht mit Storebrowse-Befehlen öffnen.

Befehlsverwendung

Der folgende Abschnitt enthält detaillierte Informationen zu den Befehlen, die Sie mit dem Dienstprogramm Storebrowse verwenden können.

Store hinzufügen

-a, --addstore

Beschreibung:

Fügt einen neuen Store hinzu. Gibt die vollständige URL des Stores zurück. Wenn die Rückgabe fehlschlägt, wird ein Fehler gemeldet.

Hinweis:

Die Multi-Store-Konfiguration wird vom Dienstprogramm Storebrowse unterstützt.

Befehlsbeispiel für StoreFront:

Befehl:

storebrowse.exe –U *username* -P *password* -D *domain* -a *URL of StoreFront*

Beispiel:

.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –a [https://my.firstexamplestore.net](https://my.firstexamplestore.net)

Befehlsbeispiel für Citrix Gateway:

Befehl:

storebrowse.exe –U *username* -P *password* -D *domain* -a *URL of CitrixGateway*

Beispiel:

.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –a <https://mysecondexample.com>

Das Obige funktioniert, wenn der mit Gateway konfigurierte StoreFront einen einzelnen Store hat.

Wenn der mit Gateway konfigurierte StoreFront mehrere Stores hat, muss der folgende Befehl verwendet werden:

Befehl: storebrowse.exe –U *username* -P *password* -D *domain* -a *URL of CitrixGateway*?StoreName

• Beispiel: .\storebrowse.exe –U {Username} –P {Password} –D {Domain} –a https://mysecondexample.com?Store

• Hilfe

• /?

Beschreibung:

Bietet Details zur Verwendung des Dienstprogramms Storebrowse.

Store auflisten

(-l), --liststore

Beschreibung:

Listet die vom Benutzer hinzugefügten Stores auf.

Befehlsbeispiel auf StoreFront:

.\storebrowse.exe –l

Befehlsbeispiel auf Citrix Gateway:

.\storebrowse.exe –l

Auflisten

(-M 0x2000 -E)

Beschreibung:

Listet Ressourcen auf.

Befehlsbeispiel auf StoreFront:

.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –M 0x2000 –E <https://my.firstexamplestore.net/Citrix/Store/discovery>

Befehlsbeispiel auf Citrix Gateway:

.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –M 0x2000 –E <https://my.secondexample.net>

Schnellstart

-q, --quicklaunch

Beschreibung:

Generiert die ICA-Datei für veröffentlichte Anwendungen und Desktops mithilfe des Dienstprogramms Storebrowse. Die Option quicklaunch erfordert eine Start-URL als Eingabe zusammen mit der Store-URL. Die Start-URL kann entweder der StoreFront-Server oder die Citrix Gateway-URL sein. Die ICA-Datei wird im Verzeichnis %LocalAppData%\Citrix\Storebrowse\cache generiert.

Sie können die Start-URL für alle veröffentlichten Anwendungen 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/Q29udHJvbGxlci5DYWxjY3VsYXRvcg/launch/ica

Befehlsbeispiel auf StoreFront:

.\storebrowse.exe –U {Username} –P {Password}–D {Domain} –q {Launch_URL_of_published_ apps and 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 {Username} –P {Password} –D {Domain} –q {Launch_URL_of_published_ apps and desktops} <https://my.secondexmaplestore.com>

Starten

• -L, --launch

• Beschreibung:

• Generiert die erforderliche ICA-Datei für veröffentlichte Anwendungen und Desktops mithilfe des Dienstprogramms Storebrowse. Die Startoption erfordert den Namen der Ressource zusammen mit der Store-URL. Der Name kann entweder der StoreFront-Server oder die Citrix Gateway-URL sein. Die ICA-Datei wird im Verzeichnis %LocalAppData%\Citrix\Storebrowse\cache generiert.

• Führen Sie den folgenden Befehl aus, um den Anzeigenamen der veröffentlichten Anwendungen und Desktops abzurufen:

• .\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/Q29udHJvbGxlci5DYWxjY3VsYXRvcg/launch/ica

Befehlsbeispiel auf StoreFront:

.\storebrowse.exe -U {Username} –P {Password} –D {Domain} –L “{Resource_Name} <https://my.firstexamplestore.net/Citrix/Store/discovery>

Befehlsbeispiel auf Citrix Gateway:

<.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –L {Resource_Name} https://my.secondexamplestore.com>

Sitzungsstart

-S, --sessionlaunch

Beschreibung:

Mit diesem Befehl können Sie einen Store hinzufügen, die veröffentlichten Ressourcen überprüfen und starten. Diese Option akzeptiert die folgenden Parameter:

• Benutzername
• Passwort
• Domäne
• Name der zu startenden Ressource
• Store-URL

Wenn der Benutzer jedoch keine Anmeldeinformationen angibt, fordert der AuthManager zur Eingabe der Anmeldeinformationen auf, und die Ressource wird dann gestartet.

Sie können den Namen der Ressource für veröffentlichte Anwendungen 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/Q29udHJvbGxlci5DYWxjY3VsYXRvcg/launch/ica

Der Name, der in der vorherigen Ausgabe fett gedruckt ist, wird als Eingabeparameter für die Option -S verwendet.

Befehlsbeispiel auf StoreFront:

.\storebrowse.exe -U {Username} –P {Password} –D {Domain} –S “{Friendly_Resource_Name} <https://my.firstexamplestore.net/Citrix/Store/discovery >

Befehlsbeispiel auf Citrix Gateway:

.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –S {Friendly_Resource_Name} <https://my.secondexamplestore.com>

Dateiverzeichnis

-f, --filefolder

Beschreibung:

Generiert die ICA-Datei im benutzerdefinierten Pfad für die veröffentlichten Anwendungen und Desktops.

Die Startoption erfordert einen Ordnernamen und den Namen der Ressource als Eingabe zusammen mit der Store-URL. Die Store-URL kann entweder der StoreFront-Server oder die Citrix Gateway-URL sein.

Befehlsbeispiel auf StoreFront:

.\storebrowse.exe –f “C:\Temp\Launch.ica” –L “Resource_Name” {Store}

Befehlsbeispiel auf Citrix Gateway:

.\storebrowse.exe –f “C:\Temp\Launch.ica” –L “Resource_Name” {NSG_URL}

Authentifizierungs-Trace

-t, --traceauthentication

Beschreibung:

Generiert Protokolle für die AuthManager-Komponente. 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 auf StoreFront:

.\storebrowse.exe –t –U {UserName} –P {Password} –D {Domain} –a {StoreURL}

Befehlsbeispiel auf Citrix Gateway:

.\storebrowse.exe –t –U {UserName} –P {Password} –D {Domain} –a {NSG_URL}

Store löschen

-d, --deletestore

Beschreibung:

Löscht einen vorhandenen StoreFront- oder Citrix Gateway-Store.

Befehlsbeispiel auf StoreFront:

.\storebrowse.exe –d https://my.firstexamplestore.net/Citrix/Store/discovery

Befehlsbeispiel auf Citrix Gateway:

.\storebrowse.exe –d https://my.secondexmaplestore.com

Verfolgen des Storebrowse-Befehlsstatus

Ab Version 2305.1 können Sie den Ausführungsstatus eines Storebrowse-Befehls in einer Datei verfolgen. Um den Erfolgsstatus zu verfolgen, geben Sie einen eindeutigen Dateinamen mit dem Befehl -f launch an. Dieser Befehl generiert eine Datei mit dem von Ihnen angegebenen Namen. Der Fehlerstatus ist in der Datei ica.error enthalten, die automatisch erstellt wird.

Hinweis:

Stellen Sie sicher, dass Sie dem Dateinamen mit dem Befehl -f launch die Erweiterung .ica hinzufügen. Andernfalls wird die Datei nicht generiert.

Die Dateien zur Verfolgung von Erfolg und Misserfolg befinden sich unter %LOCALAPPDATA%\citrix\selfservice\cache und können bei Bedarf überwacht werden.

Diese Verbesserung ist standardmäßig aktiviert.

Im Folgenden finden Sie ein Beispiel für die Verwendung des Launch-Befehls mit der Option -f:

-launch -f <uniqueFileName.ica> "launchcommandline"
For example:
SelfService.exe storebrowse -launch -f uniqueFileName.ica -s store0-5c3ec017 -CitrixID store0-5c3ec017@@a9a8e3ac-099d-4577-b84e-e33d0695df39.Notepad -ica "https://cwawiniwstest.cloudburrito.com/Citrix/Store/resources/v2/YTlhOGUzYWMtMDk5ZC00NTc3LWI4NGUtZTMzZDA2OTVkZjM5Lk5vdGVwYWQ-/launch/ica" -cmdline

<!--NeedCopy-->

Single Sign-On-Unterstützung mit Citrix Gateway

Single Sign-On ermöglicht Ihnen die Authentifizierung bei einer Domäne und die Nutzung der von dieser Domäne bereitgestellten Citrix Virtual Apps and Desktops™ und Citrix DaaS (ehemals Citrix Virtual Apps and Desktops Service). Sie können sich anmelden, ohne sich bei jeder Anwendung oder jedem Desktop erneut authentifizieren zu müssen. Wenn Sie einen Store hinzufügen, werden Ihre Anmeldeinformationen zusammen mit den Citrix Virtual Apps and Desktops- und Citrix DaaS- sowie Startmenüeinstellungen über den Citrix Gateway-Server übermittelt.

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 Pass-Through-Authentifizierung für Domänen konfigurieren.

Die Single Sign-On-Funktion mit Citrix Gateway kann über die administrative Gruppenrichtlinienobjekt (GPO)-Vorlage aktiviert werden.

1. Öffnen Sie die administrative GPO-Vorlage der Citrix Workspace-App, indem Sie gpedit.msc ausführen.
2. Navigieren Sie unter dem Knoten Computerkonfiguration zu Administrative Vorlagen > Citrix Komponenten > Citrix Workspace > Benutzerauthentifizierung > Single Sign-On für Citrix Gateway.
3. Verwenden Sie die Umschaltoptionen, um die Single Sign-On-Option zu aktivieren oder zu deaktivieren.
4. Klicken Sie auf Übernehmen und OK.
5. Starten Sie die Citrix Workspace-App-Sitzung neu, damit die Änderungen wirksam werden.

Einschränkungen:

• Aktivieren Sie die Authentifizierungsmethode HTTP Basic Authentication auf dem StoreFront-Server für Anmeldeinformationsinjektionsvorgänge mit dem Storebrowse-Dienstprogramm.
• Wenn Sie einen HTTP-Store haben und versuchen, über das Dienstprogramm eine Verbindung zum Store herzustellen, um die veröffentlichten virtuellen Anwendungen und Desktops zu überprüfen oder zu starten, wird die Anmeldeinformationsinjektion über die Befehlszeilenoption nicht unterstützt. Als Workaround verwenden Sie das externe AuthManager-Modul, wenn Sie keine Anmeldeinformationen über die Befehlszeile bereitstellen.
• Das Storebrowse-Dienstprogramm unterstützt derzeit nur einen einzigen Store, der auf dem StoreFront-Server für Citrix Gateway konfiguriert ist.
• Die Anmeldeinformationsinjektion im Storebrowse-Dienstprogramm funktioniert nur, wenn Citrix Gateway mit Single-Factor Authentication konfiguriert ist.
• Die Befehlszeilenoptionen Username (-U), Password (-P) und Domain (-D) des Storebrowse-Dienstprogramms sind Groß-/Kleinschreibung-sensitiv und müssen ausschließlich in Großbuchstaben angegeben werden.

Um SSON für Drittanbieteranwendungen zu aktivieren, die ICOSDK verwenden, erstellen Sie den folgenden Registrierungseintrag:

• Registrierungsschlüssel: Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\ICA Client\NonIEAppsWithSson
• Registrierungswert: vollständiger Pfad der Drittanbieteranwendungen
• Registrierungstyp: reg_multi_sz

Beispiel:

• Registrierungsschlüssel: Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\ICA Client\NonIEAppsWithSson
• Registrierungswert: C:\temp1\abc.exe;C:\temp2\xyz.exe
• Registrierungstyp: reg_multi_sz

Hinweis:

• Sie können mehrere Drittanbieteranwendungen durch Semikolons getrennt angeben.
• Diese Funktion wird ab Version 2107 unterstützt.

Verbesserte Storebrowse-Sitzungsbehandlung

Ab dieser Version wurde die Sitzungsbehandlung von Storebrowse durch die folgenden Verbesserungen optimiert, um die Benutzererfahrung und das kritische Ressourcenmanagement in Hochverfügbarkeitsumgebungen zu verbessern und die Effizienz zu steigern:

• Storebrowse ignoriert intelligent vorhandene Sitzungen beim Starten virtueller Anwendungen – Diese Option verhindert Neuverbindungen zu Sitzungen, die derzeit vom System abgebaut werden, und verbessert so die Stabilität. Dies gewährleistet einen nahtlosen, fehlerfreien Zugriff auf kritische Geschäftsanwendungen, insbesondere bei Client-Updates, und vereinfacht die Verwaltung durch Reduzierung komplexer Konfigurationsanforderungen. Um die intelligente Sitzungsbehandlung zu aktivieren, müssen Administratoren den Parameter -I true zu bestehenden Storebrowse-Befehlen hinzufügen. Dieser Parameter lässt sich nahtlos in alle vorhandenen Starttypen integrieren, während die aktuelle Syntaxstruktur beibehalten wird.

  Befehlsbeispiel:

  Schnellstart:

  Vorherige Syntax:

   .\storebrowse.exe -U {Username} -P {Password} –D {Domain} -q {Launch_URL_of_published_ apps and desktops} <https://cwa-ddc2c.cwa.com/Citrix/Store/resources/v2/Q29udHJvbGxlci5DYWxjdWxhdG9yLVRTVkRBMTk-/launch/ica> < https://cwa-ddc2c.cwa.com/citrix/store/discovery>
   <!--NeedCopy-->
  

  Erweiterte Syntax mit intelligenter Sitzungsbehandlung:

   .\storebrowse.exe -U {Username} -P {Password} –D {Domain} -I true -q {Launch_URL_of_published_ apps and desktops} https://cwa-ddc2c.cwa.com/Citrix/Store/resources/v2/Q29udHJvbGxlci5DYWxjdWxhdG9yLVRTVkRBMTk-/launch/ica> < https://cwa-ddc2c.cwa.com/citrix/store/discovery>
   <!--NeedCopy-->
  

• Storebrowse API-Unterstützung für die Rückgabe von Sitzungslisten – Diese Option bietet wertvolle Einblicke in aktive Benutzersitzungen und ermöglicht so kontextbezogenere und effizientere Sitzungsstarts. Diese verbesserte Transparenz reduziert benutzerrelevante Fehler und Verzögerungen beim Anwendungszugriff und gewährleistet eine reibungslosere, zuverlässigere Erfahrung für alle Benutzer.