Installation über die Befehlszeile
Wichtig:
-
Wenn Sie ein Upgrade durchführen und Ihre aktuelle Version die Personal vDisk- oder AppDisks-Software verwendet oder installiert hat, lesen Sie Entfernen von PvD, AppDisks und nicht unterstützten Hosts.
-
Citrix erfasst grundlegende Lizenzierungsdaten, soweit dies für seine berechtigten Interessen, einschließlich der Einhaltung von Lizenzbestimmungen, erforderlich ist. Weitere Informationen finden Sie unter Citrix-Lizenzierungsdaten.
Einführung
Dieser Artikel gilt für die Installation von Komponenten auf Maschinen mit Windows-Betriebssystemen. Informationen zu VDAs für Linux-Betriebssysteme finden Sie unter Linux Virtual Delivery Agents.
Dieser Artikel beschreibt, wie Produktinstallationsbefehle ausgeführt werden. Bevor Sie mit einer Installation beginnen, lesen Sie Vorbereiten der Installation. Dieser Artikel enthält Beschreibungen der verfügbaren Installationsprogramme.
Um den Fortschritt der Befehlsausführung und die Rückgabewerte anzuzeigen, müssen Sie der ursprüngliche Administrator sein oder Als Administrator ausführen verwenden. Weitere Informationen finden Sie in der Microsoft-Befehlsdokumentation.
Als Ergänzung zur direkten Verwendung der Installationsbefehle werden auf der Produkt-ISO Beispielskripts bereitgestellt, die VDAs auf Maschinen in Active Directory installieren, aktualisieren oder entfernen. Weitere Informationen finden Sie unter Installieren von VDAs mit Skripts.
Wenn Sie versuchen, auf einer Windows-Betriebssystemversion zu installieren oder ein Upgrade durchzuführen, die für diese Version von Citrix Virtual Apps and Desktops nicht unterstützt wird, werden Sie in einer Meldung auf Informationen zu Ihren Optionen hingewiesen. Siehe Ältere Betriebssysteme.
Informationen dazu, wie Citrix die Ergebnisse von Komponenteninstallationen meldet, finden Sie unter Citrix-Installationsrückgabecodes.
Verwenden des vollständigen Produktinstallationsprogramms
So greifen Sie auf die Befehlszeilenschnittstelle des vollständigen Produktinstallationsprogramms zu:
-
Laden Sie das Produktpaket von Citrix herunter. Für den Zugriff auf die Download-Site sind Citrix-Kontoanmeldeinformationen erforderlich.
-
Entpacken Sie die Datei. Optional können Sie eine DVD aus der ISO-Datei brennen.
-
Melden Sie sich mit einem lokalen Administratorkonto am Server an, auf dem Sie die Komponenten installieren.
-
Legen Sie die DVD in das Laufwerk ein oder binden Sie die ISO-Datei ein.
-
Führen Sie aus dem Verzeichnis
\x64\XenDesktop Setupauf dem Medium den entsprechenden Befehl aus.So installieren Sie Kernkomponenten: Führen SieXenDesktopServerSetup.exemit den Optionen aus, die unter Befehlszeilenoptionen zum Installieren von Kernkomponenten aufgeführt sind.So installieren Sie einen VDA: Führen SieXenDesktopVDASetup.exemit den Optionen aus, die unter Befehlszeilenoptionen zum Installieren eines VDA aufgeführt sind.So installieren Sie StoreFront: Führen SieCitrixStoreFront-x64.exeim Ordnerx64 > StoreFrontauf dem Installationsmedium aus.So installieren Sie den Universal Print Server: Befolgen Sie die Anweisungen unter Befehlszeilenoptionen zum Installieren eines Universal Print Servers.So installieren Sie den Federated Authentication Service: Citrix empfiehlt die Verwendung der grafischen Benutzeroberfläche.So installieren Sie Session Recording: Befolgen Sie die Anweisungen unter Session Recording.So installieren Sie Workspace Environment Management: Befolgen Sie die Anweisungen unter Workspace Environment Management.So installieren Sie Secure Private Access: Führen SieXenDesktopSPASetup.exeim Setup-Ordnerx64 > XenDesktopauf dem Installationsmedium aus. Befolgen Sie die Anweisungen unter Befehlszeilenoptionen für die Installation von Secure Private Access.
Befehlszeilenoptionen zum Installieren von Kernkomponenten
Die folgenden Parameteroptionen sind gültig, wenn Kernkomponenten mit dem Befehl
XenDesktopServerSetup.exe installiert werden. Weitere Details zu den Optionen finden Sie unter Kernkomponenten installieren.
Hinweis:
-
Verwenden Sie
/excludenicht, wenn Sie Befehlszeilenoptionen zum Installieren von Kernkomponenten verwenden. -
Wenn Sie eine Komponente mit
/componentsaktualisieren, werden möglicherweise auch andere Komponenten aktualisiert. Dies dient dazu, potenzielle Kompatibilitätsprobleme zwischen verschiedenen Komponenten zu vermeiden. -
Wenn Sie nur eine Komponente aktualisieren möchten, verwenden Sie das individuelle Installationsprogramm dieser Komponente. Siehe Bereitstellung aktualisieren.
-
Ermöglicht die Erfassung von Call Home-Daten und Daten des Customer Experience Improvement Program (CEIP). Gültige Werte sind:
-
DIAGNOSTIC: Wählen Sie diesen Wert, um Citrix Licensing die Erfassung von Call Home-Daten zu ermöglichen. -
ANONYMOUS: Wählen Sie diesen Wert, um Citrix Licensing die Erfassung nicht identifizierter CEIP-Daten (die keine Benutzer identifizieren) zu ermöglichen. -
NONE: Wählen Sie diesen Wert, um die Erfassung von CEIP-Daten durch Citrix Licensing zu deaktivieren.
Weitere Informationen zur Call Home-Datenerfassung finden Sie unter Citrix Licensing Call Home.Weitere Details zur CEIP-Datenerfassung finden Sie unter Citrix Licensing Customer Experience Improvement Program.Weitere Details zu CEIP-Daten finden Sie unter Citrix Licensing CEIP-Datenelemente.Weitere Details zu Lizenzserver-Lizenzierungsdaten finden Sie unter Citrix Licensing Data. -
-
Durch Kommas getrennte Liste von Komponenten zum Installieren oder Entfernen. Gültige Werte sind:
-
CONTROLLER: Controller -
DESKTOPSTUDIO: Studio -
WEBSTUDIO: Web Studio -
DESKTOPDIRECTOR: Director -
LICENSESERVER: Citrix Lizenzserver -
SECUREPRIVATEACCESS: Secure Private Access
Wenn diese Option weggelassen wird, werden alle Komponenten installiert (oder entfernt, wenn die Option/removeebenfalls angegeben ist).(In Releases vor 2003 waren gültige WerteSTOREFRONTenthalten. Für Version 2003 und höher verwenden Sie den dedizierten StoreFront-Installationsbefehl, der unter Verwenden des vollständigen Produktinstallationsprogramms erwähnt wird). -
-
nur VoraussetzungenEs werden nur die Voraussetzungen für die ausgewählten Komponenten installiert. Es werden keine Citrix-Produktkomponenten installiert.
-
/configure_firewallÖffnet alle von den zu installierenden Komponenten verwendeten Ports in der Windows-Firewall, wenn der Windows-Firewall-Dienst ausgeführt wird, selbst wenn die Firewall nicht aktiviert ist. Wenn Sie eine Drittanbieter-Firewall oder keine Firewall verwenden, müssen Sie die Ports manuell öffnen.
-
ErfahrungsmetrikenDeaktivierenVerhindert den automatischen Upload von Analysedaten, die während der Installation, des Upgrades oder der Entfernung erfasst wurden, an Citrix.
-
/help oder /hZeigt die Befehlshilfe an.
-
/ignore\_hw\_check\_failureErmöglicht die Fortsetzung der Installation oder des Upgrades des Delivery Controllers, selbst wenn die Hardwareprüfungen fehlschlagen (z. B. aufgrund von unzureichendem RAM). Weitere Informationen finden Sie unter Hardwareprüfung.
-
/ignore\_site\_test\_failureNur während eines Controller-Upgrades gültig. Normalerweise werden alle Site-Testfehler ignoriert und das Upgrade wird fortgesetzt. Wenn diese Option weggelassen (oder auf „false“ gesetzt) wird, führt jeder Site-Testfehler dazu, dass das Installationsprogramm fehlschlägt, ohne das Upgrade durchzuführen. Standard = falseWährend eines Upgrades wird diese Option ignoriert, wenn eine nicht unterstützte SQL Server-Version erkannt wird. Einzelheiten finden Sie unter SQL Server-Versionsprüfung.
-
/installdir VerzeichnisVorhandenes leeres Verzeichnis, in dem Komponenten installiert werden. Standard =
c:\Program Files\Citrix. -
/logpath PfadSpeicherort der Protokolldatei. Der angegebene Ordner muss vorhanden sein. Das Installationsprogramm erstellt ihn nicht. Standard =
TEMP%\Citrix\XenDesktop Installer -
/no_remote_assistanceNur gültig bei der Installation des Directors. Deaktiviert die Benutzer-Shadowing-Funktion, die Windows-Remotedesktopunterstützung verwendet.
-
/keinNeustartVerhindert einen Neustart nach der Installation. (Bei den meisten Kernkomponenten ist ein Neustart standardmäßig nicht aktiviert.)
-
/keinFortsetzenStandardmäßig wird der Installer, wenn während einer Installation ein Maschinenneustart erforderlich ist, nach Abschluss des Neustarts automatisch fortgesetzt. Um die Standardeinstellung zu überschreiben, geben Sie
/noresumean. Dies kann hilfreich sein, wenn Sie die Medien erneut bereitstellen oder Informationen während einer automatisierten Installation erfassen möchten. -
/kein sqlVerhindert die Installation von Microsoft SQL Server Express auf dem Server, auf dem Sie den Controller installieren. Wird diese Option weggelassen, wird SQL Server Express als Sitedatenbank installiert.Diese Option hat keine Auswirkungen auf die Installation von SQL Server Express LocalDB, das für den lokalen Hostcache verwendet wird.
-
/quiet oder /passiveWährend der Installation wird keine Benutzeroberfläche angezeigt. Der einzige Hinweis auf den Installationsprozess ist der Windows Task-Manager. Wird diese Option weggelassen, wird die grafische Benutzeroberfläche gestartet.
-
/entfernenEntfernt die Kernkomponenten, die mit der Option
/componentsangegeben wurden. -
/alles entfernenEntfernt alle installierten Kernkomponenten.
-
/SKIPHDXDRIVERCHECKÜberspringt die Überprüfung der HDX™-Treiber für den VDA-Meta-Installer.
-
/Erfahrungsmetriken sendenSendet automatisch Analysedaten, die während der Installation, des Upgrades oder der Entfernung erfasst wurden, an Citrix. Wird diese Option weggelassen (oder
/disableexperiencemetricsangegeben), werden die Analysedaten lokal erfasst, aber nicht automatisch gesendet. -
/tempdir VerzeichnisVerzeichnis, das temporäre Dateien während der Installation enthält. Standard =
c:\Windows\Temp. -
/XenAppInstalliert Citrix Virtual Apps. Wird diese Option weggelassen, wird Citrix Virtual Apps and Desktops™ installiert.
Beispiele für die Installation von Kernkomponenten
Der folgende Befehl installiert einen Delivery Controller™, Studio, Citrix Licensing und SQL Server Express auf einem Server. Für die Komponentenkommunikation erforderliche Firewallports werden automatisch geöffnet.
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,desktopstudio,licenseserver /configure_firewall
Der folgende Befehl installiert einen Citrix Virtual Apps™ Controller, Studio und SQL Server Express auf dem Server. Für die Komponentenkommunikation erforderliche Firewallports werden automatisch geöffnet.
\x64\XenDesktop Setup\\XenDesktopServerSetup.exe /xenapp /components controller,desktopstudio /configure_firewall
Der folgende Befehl installiert einen Delivery Controller, Secure Private Access und SQL Server Express auf einem Server. Für die Komponentenkommunikation erforderliche Firewallports werden automatisch geöffnet.
\x64\XenDesktop Setup XenDesktopServerSetup.exe /xenapp /components controller,secureprivateaccess /configure_firewall
Verwenden eines eigenständigen VDA-Installers
Citrix-Anmeldeinformationen sind erforderlich, um auf die Downloadseite zuzugreifen. Sie müssen entweder über erhöhte Administratorrechte verfügen, bevor Sie die Installation starten, oder Als Administrator ausführen verwenden.
-
Laden Sie das entsprechende Paket von Citrix herunter:
-
Virtual Delivery Agent für Multisitzungs-OS:
VDAServerSetup_xxxx.exe -
Virtual Delivery Agent für Einzelsitzungs-OS:
VDAWorkstationSetup_xxxx.exe -
Virtual Delivery Agent für Einzelsitzungs-OS-Kerndienste:
VDAWorkstationCoreSetup_xxxx.exe
-
-
Extrahieren Sie die Dateien entweder zuerst aus dem Paket in ein vorhandenes Verzeichnis und führen Sie dann den Installationsbefehl aus, oder führen Sie einfach das Paket aus.Um die Dateien vor der Installation zu extrahieren, verwenden Sie
/extractmit dem absoluten Pfad, zum BeispielC:\YourExtractFolder\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia. Das Verzeichnis muss vorhanden sein. Andernfalls schlägt die Extraktion fehl. Führen Sie dann in einem separaten Befehl den entsprechenden Befehl mit den in diesem Artikel aufgeführten gültigen Optionen aus.-
Für
VDAServerSetup_XXXX.exeführen Sie<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exeaus -
Für
VDAWorkstationCoreSetup_XXXX.exeführen Sie<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopRemotePCSetup.exeaus -
Für
VDAWorkstationSetup_XXXX.exeführen Sie<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exeaus
Um das heruntergeladene Paket auszuführen, führen Sie seinen Namen aus:VDAServerSetup.exe,VDAWorkstationSetup.exeoderVDAWorkstationCoreSetup.exe. Verwenden Sie die in diesem Artikel aufgeführten gültigen Optionen. -
Wenn Sie mit dem vollständigen Produktinstallationsprogramm vertraut sind:
-
Führen Sie das eigenständige
VDAServerSetup.exe- oderVDAWorkstationSetup.exe-Installationsprogramm aus, als wäre es derXenDesktopVdaSetup.exe-Befehl, in allem außer seinem Namen. -
Das
VDAWorkstationCoreSetup.exe-Installationsprogramm ist anders, da es eine Untermenge der Optionen unterstützt, die den anderen Installationsprogrammen zur Verfügung stehen.
Befehlszeilenoptionen zum Installieren eines VDA
Die folgenden Optionen sind mit einem oder mehreren der folgenden Befehle (Installationsprogramme) gültig:
VDAServerSetup_xxxx.exe, VDAWorkstationSetup_xxxx.exe und VDAWorkstationCoreSetup_xxxx.exe.
Weitere Informationen zu den Optionen finden Sie unter VDAs installieren.
-
/Komponenten Komponente\[,Komponente\]Durch Kommas getrennte Liste von Komponenten zum Installieren oder Entfernen. Gültige Werte sind:
-
VDA: Virtual Delivery Agent -
PLUGINS: Citrix Workspace™ App für Windows
Um den VDA und die Citrix Workspace-App für Windows zu installieren, geben Sie/components vda,pluginsan oder geben Sie überhaupt keine Komponenten an. Wenn keine Komponenten angegeben werden, wird standardmäßig nur der VDA installiert.Um nur den VDA zu installieren und die Installation der Citrix Workspace-App auszuschließen, geben Sie/components vdaan.Diese Option ist nicht gültig, wenn dasVDAWorkstationCoreSetup_xxxx.exe-Installationsprogramm verwendet wird. Dieses Installationsprogramm kann die Citrix Workspace-App nicht installieren. -
-
/nurVoraussetzungenEs werden nur die Voraussetzungen für die ausgewählten Komponenten installiert. Es werden keine Citrix-Produktkomponenten installiert.
-
/controllers "Controller \[Controller\]"Durch Leerzeichen getrennte FQDNs von Controllern, mit denen der VDA kommunizieren kann, in geraden Anführungszeichen eingeschlossen. Geben Sie nicht sowohl die Option
/site_guidals auch die Option/controllersan. -
ErfahrungsmetrikenDeaktivierenVerhindert den automatischen Upload von Analysedaten, die während der Installation, des Upgrades oder der Entfernung gesammelt wurden, an Citrix.
-
/enable\_hdx\_portsÖffnet Ports in der Windows-Firewall, die vom VDA und aktivierten Funktionen (außer Windows-Remotedesktopunterstützung) benötigt werden, wenn der Windows-Firewalldienst erkannt wird, selbst wenn die Firewall nicht aktiviert ist. Wenn Sie eine andere Firewall oder keine Firewall verwenden, müssen Sie die Firewall manuell konfigurieren. Informationen zu Ports finden Sie unter Netzwerkports.Um die UDP-Ports zu öffnen, die der adaptive HDX-Transport verwendet, geben Sie die Option
/enable_hdx_udp_portszusätzlich zu dieser Option/enable_hdx_portsan. -
/enable\_hdx\_udp\_portsÖffnet UDP-Ports in der Windows-Firewall, die HDX Adaptive Transport verwendet, wenn der Windows-Firewall-Dienst erkannt wird, selbst wenn die Firewall nicht aktiviert ist. Wenn Sie eine andere Firewall oder keine Firewall verwenden, müssen Sie die Firewall manuell konfigurieren. Informationen zu Ports finden Sie unter Netzwerkports.Um zusätzliche Ports zu öffnen, die der VDA verwendet, geben Sie die Option
/enable_hdx_portszusätzlich zu dieser Option/enable_hdx_udp_portsan. -
/enable_hdx_tls_dtlsÖffnet TCP- und UDP-Port 443 für HDX Direct V1.
-
/enable\_real\_time\_transportAktiviert oder deaktiviert die Verwendung von UDP für Audiopakete (RealTime Audio Transport für Audio). Die Aktivierung dieser Funktion kann die Audioleistung verbessern. Fügen Sie die Option
/enable_hdx_portshinzu, wenn die UDP-Ports automatisch geöffnet werden sollen, wenn der Windows-Firewall-Dienst erkannt wird. -
/enable_remote_assistanceAktiviert die Shadowing-Funktion in der Windows-Remoteunterstützung zur Verwendung mit Director. Wenn Sie diese Option angeben, öffnet die Windows-Remoteunterstützung die dynamischen Ports in der Firewall.
-
/enablerestore oder /enablerestorecleanup(Nur gültig für Single-Session-VDAs) Ermöglicht die automatische Rückkehr zum Wiederherstellungspunkt, wenn die VDA-Installation oder das Upgrade fehlschlägt.Wenn die Installation/das Upgrade erfolgreich abgeschlossen wird:
-
/enablerestorecleanupweist den Installer an, den Wiederherstellungspunkt zu entfernen. -
/enablerestoreweist das Installationsprogramm an, den Wiederherstellungspunkt beizubehalten, obwohl er nicht verwendet wurde.
Weitere Informationen finden Sie unter Wiederherstellung bei Installations- oder Upgradefehler. -
-
/ENABLE_SECURE_DEFAULTSÄndert die Standardeinstellung für verschiedene Funktionen von aktiviert zu deaktiviert für eine sicherere Out-of-Box-Konfiguration. Die relevanten Funktionen sind: Clientlaufwerkumleitung, Umleitung spezieller Ordner, Drag & Drop, Client-TWAIN-Geräteumleitung, Client-USB-Plug-and-Play-Geräteumleitung, Client-Druckerumleitung, Client-Zwischenablageumleitung und Client-Mikrofonumleitung.
-
/enable\_ss\_portsÖffnet Ports in der Windows-Firewall, die für die Bildschirmfreigabe erforderlich sind, wenn der Windows-Firewall-Dienst erkannt wird, selbst wenn die Firewall nicht aktiviert ist. Wenn Sie eine andere Firewall oder keine Firewall verwenden, müssen Sie die Firewall manuell konfigurieren.
-
/exclude "Komponente"\[,"Komponente"\]Verhindert die Installation einer oder mehrerer durch Kommas getrennter optionaler Komponenten, die jeweils in geraden Anführungszeichen eingeschlossen sind. Zum Beispiel erfordert die Installation oder das Upgrade eines VDA auf einem Image, das nicht von MCS verwaltet wird, die Komponente Machine Identity Service nicht. Gültige Werte sind die folgenden:
Multi-Session-Betriebssystem Einzel-Sitzungs-Betriebssystem Kernservices für Einzelsitzungs-Betriebssysteme Citrix Authentication Identity Assertion VDA Plug-inCitrix Authentication Identity Assertion VDA Plug-inCitrix Authentication Identity Assertion VDA Plug-inCitrix Backup and RestoreCitrix Backup and RestoreCitrix Browser Content RedirectionCitrix Browser Content RedirectionCitrix Browser Content RedirectionCitrix Personalization for App-V - VDACitrix MCS IODriverCitrix MCS IODriverCitrix Telemetry ServiceCitrix Personalization for App-V - VDACitrix Personalization for App-V - VDACitrix Universal Print ClientCitrix Profile ManagementCitrix Profile ManagementCitrix Vda Log Capture ServiceCitrix Profile Management WMI Plug-inCitrix Profile Management WMI Plug-inCSE ComponentCitrix Rendezvous V2Citrix Rendezvous V2Director VDA Plug-inCitrix Telemetry ServiceCitrix Telemetry ServiceMachine Management ProviderCitrix Universal Print ClientCitrix Universal Print ClientVDA Monitor Plug-inCitrix Vda Log Capture ServiceCitrix Vda Log Capture ServiceVDA WMI Proxy Plug-inCitrix VDA Upgrade AgentCitrix VDA Upgrade AgentCSE ComponentCSE ComponentDirector VDA Plug-inDirector VDA Plug-inMachine Identity ServiceMachine Identity ServiceMachine Management ProviderMachine Management ProviderVDA Monitor Plug-inUser Personalization LayerVDA WMI Proxy Plug-inVDA Monitor Plug-inVDA WMI Proxy Plug-inCitrix App Protection ComponentCitrix App Protection ComponentCitrix App Protection ComponentCitrix HyperV Filter DriverCitrix HyperV Filter DriverCitrix Personalization for App-V - VDACitrix Personalization for App-V - VDACitrix Personalization for App-V - VDADas Ausschließen von Citrix Profile Management von der Installation (/exclude "Citrix Profile Management") beeinträchtigt die Überwachung und Fehlerbehebung von VDAs mit Citrix Director. Auf den Seiten Benutzerdetails und EndPoint schlagen das Personalisierungsfeld und das Anmeldedauerfeld fehl. Auf den Seiten Dashboard und Trends zeigt das Feld "Durchschnittliche Anmeldedauer" nur Daten für Maschinen an, auf denen Profile Management installiert ist.Auch wenn Sie eine Drittanbieterlösung für die Benutzerprofilverwaltung verwenden, empfiehlt Citrix, den Citrix Profile Management Service zu installieren und auszuführen. Das Aktivieren des Citrix Profile Management Service ist nicht erforderlich.Wenn Sie sowohl/excludeals auch/includeadditionalmit demselben Komponentennamen angeben, wird diese Komponente nicht installiert.Diese Option ist bei Verwendung desVDAWorkstationCoreSetup.exe-Installationsprogramms nicht gültig. Dieses Installationsprogramm schließt viele dieser Elemente automatisch aus. -
/h oder /helpZeigt die Befehlshilfe an.
-
/includeadditional "Komponente"\[,"Komponente"\]Schließt die Installation einer oder mehrerer durch Kommas getrennter optionaler Komponenten ein, die jeweils in geraden Anführungszeichen eingeschlossen sind. Diese Option kann hilfreich sein, wenn Sie eine Remote PC Access-Bereitstellung erstellen und andere Komponenten installieren möchten, die standardmäßig nicht enthalten sind. Gültige Werte sind:
Multi-Session-Betriebssystem Einzel-Sitzungs-Betriebssystem Citrix Backup and RestoreCitrix Backup and RestoreCitrix MCS IODriverCitrix MCS IODriverCitrix Personalization for App-V - VDACitrix Personalization for App-V - VDACitrix Profile ManagementCitrix Profile ManagementCitrix Profile Management WMI Plug-inCitrix Profile Management WMI Plug-inCitrix Rendezvous V2Citrix Rendezvous V2Citrix VDA Upgrade AgentCitrix VDA Upgrade AgentCitrix Web Socket Vda Registration ToolCitrix Web Socket Vda Registration ToolMachine Identity ServiceMachine Identity ServiceUser Personalization LayerWenn Sie sowohl/excludeals auch/includeadditionalmit demselben Komponentennamen angeben, wird diese Komponente nicht installiert. -
/installdir VerzeichnisVorhandenes leeres Verzeichnis, in dem Komponenten installiert werden. Standard =
c:\Program Files\Citrix. -
/install_mcsio_driverNicht verwenden. Verwenden Sie stattdessen
/includeadditional "Citrix MCS IODriver"oder/exclude "Citrix MCS IODriver". -
/logpath PfadSpeicherort der Protokolldatei. Der angegebene Ordner muss vorhanden sein. Das Installationsprogramm erstellt ihn nicht. Standard = „
%TEMP%\Citrix\XenDesktop Installer“Diese Option ist in der grafischen Benutzeroberfläche nicht verfügbar. -
/MasterimageGültig nur bei der Installation eines VDA auf einer VM. Richtet den VDA als Image ein, das zum Erstellen anderer Maschinen verwendet werden soll. Diese Option entspricht
/mastermcsimage.Diese Option ist bei Verwendung desVDAWorkstationCoreSetup_xxxx.exe-Installationsprogramms nicht gültig. -
/Master-MCS-ImageGibt an, dass dieser Computer als Image mit Machine Creation Services verwendet wird. Diese Option entspricht
/masterimage. -
/Master-PVS-ImageGibt an, dass diese Maschine als Image mit Citrix Provisioning™ oder einem Drittanbieter-Bereitstellungstool (z. B. Microsoft System Center Configuration Manager) zur Bereitstellung von VMs verwendet wird.
-
/websockettoken WebSocket-TokenErstellt einen Web Socket VDA. Der WebSocketToken ist für das erforderliche Token.
-
/websockettokenfile DateiMitWebSockTokenErstellt einen Web Socket VDA. Das FileContainingWebSockToken steht für die Datei, die das erforderliche Token enthält.
-
/websockettokenstdin <WebSocket-TokenErstellt einen Web Socket VDA. Das <WebSocketToken steht für das erforderliche Token, das über STDIN übergeben wird.
-
/no\_mediafoundation\_ackBestätigt, dass Microsoft Media Foundation nicht installiert ist und mehrere HDX-Multimediafunktionen nicht installiert werden und nicht funktionieren. Wenn diese Option weggelassen wird und Media Foundation nicht installiert ist, wird die VDA-Installation beendet, da die Voraussetzungen nicht erfüllt sind. Die meisten unterstützten Windows-Editionen werden mit bereits installierter Media Foundation geliefert, mit Ausnahme der N-Editionen. Wenn Sie Windows-Features > Medienfunktionen manuell aktivieren, hat der vom Citrix Meta Installer gesuchte Registrierungsschlüssel möglicherweise keinen festgelegten Wert. Überprüfen Sie den Registrierungsschlüssel
SOFTWARE\Microsoft\Windows\CurrentVersion\Setup\Windows-Features\WindowsMediaVersion, bevor Sie den Installationsvorgang starten, um zu bestätigen, dass der Wert vorhanden und nicht leer ist. -
/keineDesktopErfahrungDie Funktion „Enhanced Desktop Experience“ ist nicht mehr verfügbar. Diese Option (und Richtlinieneinstellung) wird ignoriert, falls angegeben.Gültig nur bei der Installation eines VDA für Multi-Session-OS. Verhindert die Aktivierung der Funktion „Enhanced Desktop Experience“. Diese Funktion wird auch über die Citrix-Richtlinieneinstellung „Enhanced Desktop Experience“ gesteuert.
-
/keinNeustartVerhindert einen Neustart nach der Installation. Der VDA kann erst nach einem Neustart verwendet werden.
-
/keinFortsetzenStandardmäßig wird der Installer, wenn während einer Installation ein Maschinenneustart erforderlich ist, nach Abschluss des Neustarts automatisch fortgesetzt. Um die Standardeinstellung zu überschreiben, geben Sie
/noresumean. Dies kann hilfreich sein, wenn Sie die Medien erneut bereitstellen oder Informationen während einer automatisierten Installation erfassen möchten. -
/physicalMachineVerwenden Sie dieses Argument zusammen mit
/remotepcfür die RemotePC-Installation. Andernfalls verhält sich der VDA in bestimmten Benutzerszenarien möglicherweise nicht wie erwartet. -
/Portnummer PortNur gültig, wenn die Option
/reconfigangegeben ist. Portnummer, die für die Kommunikation zwischen dem VDA und dem Controller aktiviert werden soll. Der zuvor konfigurierte Port wird deaktiviert, es sei denn, es ist Port 80. -
/proxyconfig „Adresse oder PAC-Dateipfad“Wenn Sie das Rendezvous-Protokoll mit Diensten wie dem Gateway Service in Ihrer Umgebung verwenden und einen nicht-transparenten Proxy in Ihrem Netzwerk für ausgehende Verbindungen haben, geben Sie den Proxy hier an. Nur HTTP-Proxys werden unterstützt. Die Adresse oder der PAC-Dateipfad des Proxys zur Verwendung mit dem Rendezvous-Protokoll. Diese Befehlszeile installiert automatisch Citrix Rendezvous V2, als ob /includeadditional "Citrix Rendezvous V2" verwendet worden wäre. Weitere Funktionsdetails finden Sie unter Rendezvous-Protokoll.
-
Proxyadressformat:
http://<url-or-ip>:<port> -
PAC-Dateiformat:
http://<url-or-ip>:<port>/<path>/<filename>.pac
-
-
/quiet oder /passiveWährend der Installation wird keine Benutzeroberfläche angezeigt. Der einzige Hinweis auf den Installations- und Konfigurationsprozess ist der Windows Task-Manager. Wird diese Option weggelassen, wird die grafische Benutzeroberfläche gestartet.
-
neukonfigurierenPasst zuvor konfigurierte VDA-Einstellungen an, wenn sie mit den Optionen
/portnumber,/controllersoder/enable_hdx_portsverwendet wird. Wenn Sie diese Option angeben, ohne auch die Option/quietanzugeben, wird die grafische Benutzeroberfläche zum Anpassen des VDA gestartet. -
/Remote-PCGültig nur für Remote PC Access-Bereitstellungen (Single-Session-OS) oder vermittelte Verbindungen (Multi-Session-OS). Schließt die Installation zusätzlicher Komponenten aus (siehe Komponentenlisten mit den Optionen
/excludeund/includeadditional).Diese Option ist bei Verwendung desVDAWorkstationCoreSetup.exe-Installers nicht gültig. Dieser Installer schließt die Installation dieser Komponenten automatisch aus./remotepcist nicht mit der Option/servervdikompatibel. -
/entfernenEntfernt die mit der Option
/componentsangegebenen Komponenten. -
/remove_appdisk_ackAutorisiert den VDA-Installer, das AppDisks™ VDA-Plug-In zu deinstallieren, falls es installiert ist.
-
/remove_pvd_ackAutorisiert den VDA-Installer, Personal vDisk zu deinstallieren, falls es installiert ist.
-
/alles entfernenEntfernt den VDA. Es entfernt die Citrix Workspace-App nicht (falls installiert).
-
/REMOVEALLWITHCWAEntfernt CWA zusammen mit dem VDA.
-
/Erfahrungsmetriken sendenSendet automatisch Analysedaten, die während der Installation, des Upgrades oder der Entfernung erfasst wurden, an Citrix. Wenn diese Option weggelassen wird (oder die Option
/disableexperiencemetricsangegeben wird), werden Analysedaten lokal erfasst, aber nicht automatisch gesendet. -
/Server-VDIInstalliert einen VDA für Single-Session-OS auf einer unterstützten Windows-Multi-Session-Maschine. Lassen Sie diese Option weg, wenn Sie einen VDA für Multi-Session-OS auf einer Windows-Multi-Session-Maschine installieren.Bevor Sie diese Option verwenden, lesen Sie Server VDI.Verwenden Sie diese Option nur mit dem vollständigen VDA-Installationsprogramm.
-
/Site-GUID guidGlobal eindeutiger Bezeichner (GUID) der Active Directory Organisationseinheit (OU) des Standorts. Dies ordnet einen virtuellen Desktop einem Standort zu, wenn Sie Active Directory für die Erkennung verwenden (automatische Aktualisierung ist die empfohlene und standardmäßige Erkennungsmethode). Die Standort-GUID ist eine Standorteigenschaft, die in Studio angezeigt wird. Geben Sie nicht sowohl die Optionen
/site_guidals auch/controllersan. -
/tempdir VerzeichnisVerzeichnis zum Speichern temporärer Dateien während der Installation. Standard =
c:\Windows\Temp.Diese Option ist in der grafischen Benutzeroberfläche nicht verfügbar. -
/virtuelleMaschineNur gültig bei der Installation eines VDA auf einer VM. Überschreibt die Erkennung einer physischen Maschine durch das Installationsprogramm, wenn BIOS-Informationen, die an VMs übergeben werden, diese als physische Maschinen erscheinen lassen.Diese Option ist in der grafischen Benutzeroberfläche nicht verfügbar.
-
/xendesktopCloudZeigt an, dass der VDA in einer Citrix DaaS (Citrix Cloud™)-Bereitstellung installiert ist.
Beispiele für die Installation eines VDA
VDA mit dem vollständigen Produktinstallationsprogramm installieren:
Der folgende Befehl installiert einen VDA für EinzelSitzungs-Betriebssysteme und die Citrix Workspace-App am Standardspeicherort auf einer VM. Dieser VDA wird als Image verwendet und nutzt MCS zur Bereitstellung von VMs. Der VDA registriert sich zunächst beim Controller auf dem Server mit dem Namen
Contr-Main in der Domäne mydomain. Der VDA verwendet die Benutzerpersonalisierungsebene und die Windows-Remoteunterstützung.
\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /components vda,plugins /controllers "Contr-Main.mydomain.local" /enable_hdx_ports /includeadditional "user personalization layer" /mastermcsimage /enable_remote_assistance
Installieren Sie einen VDA für EinzelSitzungs-Betriebssysteme mit dem eigenständigen Installationsprogramm VDAWorkstationCoreSetup:
Der folgende Befehl installiert einen Core Services VDA auf einem EinzelSitzungs-Betriebssystem zur Verwendung in einer Remote-PC-Zugriff- oder VDI-Bereitstellung. Die Citrix Workspace-App und andere Nicht-Core-Dienste werden nicht installiert. Die Adresse eines Controllers wird angegeben, und Ports im Windows-Firewall-Dienst werden automatisch geöffnet. Der Administrator übernimmt die Neustarts.
VDAWorkstationCoreSetup .exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot
VDA anpassen
Nach der Installation eines VDA können Sie verschiedene Einstellungen anpassen. Führen Sie aus dem Verzeichnis
\x64\XenDesktop Setup auf dem Produktmedium XenDesktopVdaSetup.exe aus, wobei Sie eine oder mehrere der folgenden Optionen verwenden, die unter Befehlszeilenoptionen zum Installieren eines VDA beschrieben sind.
-
/reconfigure(erforderlich bei der Anpassung eines VDA) -
/hoder/help -
/quiet -
/noreboot -
/controllers -
/portnumber port -
/enable_hdx_ports
Problembehandlung für VDAs
-
In der Studio-Anzeige für eine Bereitstellungsgruppe entspricht der Eintrag Installierte VDA-Version im Bereich Details möglicherweise nicht der auf den Maschinen installierten Version. Die Anzeige der Windows-Programme und -Funktionen der Maschine zeigt die tatsächliche VDA-Version an.
-
Nach der Installation eines VDA kann dieser erst dann Apps oder einen Desktop für Benutzer bereitstellen, wenn er sich bei einem Delivery Controller registriert hat.Informationen zu VDA-Registrierungsmethoden und zur Behebung von Registrierungsproblemen finden Sie unter VDA-Registrierung.
Befehlszeilenoptionen zum Installieren eines Universal Print Servers
Die folgende Option ist mit dem Befehl
XenDesktopPrintServerSetup.exe gültig.
-
/enable_upsserver_port
Wenn diese Option nicht angegeben ist, zeigt das Installationsprogramm die Seite Firewall der grafischen Benutzeroberfläche an. Wählen Sie Automatisch, damit das Installationsprogramm die Windows-Firewallregeln automatisch hinzufügt, oder Manuell, damit der Administrator die Firewall manuell konfigurieren kann.
Nach der Installation der Software auf Ihren Druckservern konfigurieren Sie den Universal Print Server gemäß den Anweisungen unter Drucker bereitstellen.
Befehlszeilenoptionen für die Installation von Secure Private Access
Die folgenden Optionen sind für beide gültig:
-
CVAD-Installationsprogramm:
XenDesktopSPASetup.exe -
SPA On-Prem-Installationsprogramm:
SecurePrivateAccessSetup_XXXX.exe
-
/enable_spa_portsÖffnet Ports in der Windows-Firewall, die von Secure Private Access benötigt werden, wenn der Windows-Firewall-Dienst erkannt wird, auch wenn die Firewall nicht aktiviert ist. Wenn Sie eine andere Firewall oder keine Firewall verwenden, müssen Sie die Firewall manuell konfigurieren. Informationen zu Ports finden Sie unter Netzwerkports.
-
/kein-sqlVerhindert die Installation von Microsoft SQL Server Express auf dem Server, auf dem Sie Secure Private Access installieren. Wenn diese Option weggelassen wird, wird SQL Server Express als Sitedatenbank installiert.
-
/help oder /h oder /?Zeigt die Befehlshilfe an
-
/keinNeustartVerhindert einen Neustart nach der Installation. Secure Private Access kann erst nach einem Neustart verwendet werden.
-
/quiet oder /passiveWährend der Installation wird keine Benutzeroberfläche angezeigt. Der einzige Hinweis auf den Installations- und Konfigurationsprozess ist der Windows Task-Manager. Wird diese Option weggelassen, wird die grafische Benutzeroberfläche gestartet.
-
/entfernenEntfernt Secure Private Access.
Weitere Informationen zu den Optionen finden Sie unter Secure Private Access-Installationsprogramm.
Weitere Informationen
Informationen dazu, wie Citrix das Ergebnis von Komponenteninstallationen meldet, finden Sie unter Citrix Installationsrückgabecodes.