App Layering-Agent installieren
Der App Layering-Agent ermöglicht es der Appliance oder einer Packaging Machine, PowerShell-Befehle lokal auszuführen. Wenn Sie die entsprechenden Anmeldeinformationen angeben, kann der Agent PowerShell-Befehle als bestimmter Benutzer ausführen.
Wann der Agent erforderlich ist
Der App Layering-Agent ist erforderlich, wenn Sie Folgendes planen:
- Skripte über Ihre Connector-Konfigurationen starten.
- Die App Layering-Appliance in Microsoft Hyper-V ausführen.
- Layered Images in Citrix Provisioning veröffentlichen.
Sie installieren den Agenten an den folgenden Speicherorten:
- Auf allen Hyper-V-Servern, die Sie für die Layer-Erstellung oder Image-Veröffentlichung verwenden möchten.
- Auf allen Citrix Provisioning-Servern, auf denen Sie Layered Images veröffentlichen möchten.
- An Speicherorten, an denen Ihre Connector-Konfigurationen PowerShell-Skripte ausführen.
Registrieren des Agenten bei der Appliance
Der Installationsassistent für den App Layering-Agent fordert Sie auf, den Agenten bei einer App Layering-Appliance zu registrieren. Wenn Sie den Agenten während der Installation nicht registrieren, können Sie ihn später manuell registrieren. Die PowerShell-Skripte werden jedoch erst ausgeführt, wenn der Agent bei der Appliance registriert ist.
Voraussetzungen
Bevor Sie den App Layering-Agent installieren, stellen Sie sicher, dass das System, auf dem Sie den Agenten installieren, die folgenden Anforderungen erfüllt:
- Ein Konto mit Administratorrechten
- .NET 4.5
- PowerShell 3.0 oder höher
- PowerShell-Snap-In. Bevor Sie den App Layering-Agent auf einem Citrix Provisioning Services-Server verwenden, müssen Sie sicherstellen, dass das PowerShell-Snap-In installiert ist. Die Schritte zur manuellen Registrierung des Agenten bei der Appliance finden Sie hier.
Wenn Sie den App Layering-Agent zuvor installiert haben, können Sie aktualisierte Versionen von der Citrix®-Downloadseite herunterladen. Das Agent-Installationspaket ist im App Layering ZIP-Download enthalten.
So laden Sie den App Layering-Agent herunter
- Gehen Sie zur Citrix-Homepage und klicken Sie dann auf Anmelden.
- Klicken Sie auf Downloads und wählen Sie Citrix App Layering™ aus der Liste aus.
- Klicken Sie auf der Citrix App Layering-Seite unter Citrix App Layering > Product Software auf Citrix App Layering.
- Klicken Sie unten auf der Seite auf Tools.
- Klicken Sie auf die Citrix App Layering-Agent Download File. Die Datei citrix_app_layering_agent_installer.exe wird auf Ihren Computer heruntergeladen.
App Layering-Agent installieren
Der Installationsassistent für den App Layering-Agent fordert Sie auf, den Agenten bei einer App Layering-Appliance zu registrieren. Wenn Sie den Agenten während der Installation nicht registrieren, können Sie ihn später manuell registrieren. Beachten Sie jedoch, dass der Agent bei der Appliance registriert sein muss, bevor die PowerShell-Skripte ausgeführt werden können.
-
Melden Sie sich mit einem Konto mit Administratorrechten bei dem System an, auf dem Sie den Agenten installieren.
-
Kopieren Sie die Datei Citrix_app_layering_agent_installer.exe an einen geeigneten Speicherort auf dem Server.
-
Führen Sie die Datei Citrix_app_layering_agent_installer.exe als Administrator aus, und geben Sie bei Aufforderung den Pfad zu dem Verzeichnis ein, in dem Sie den App Layering-Agent installieren möchten. Der Standardspeicherort ist C:\Program Files (x86)\Citrix\Agent.
Der Agent-Installationsassistent prüft, ob alle Voraussetzungen erfüllt sind. Wenn Voraussetzungen fehlen, meldet der Installationsassistent dies und beendet die Installation ohne Installation.
-
Der Installationsassistent fordert Sie zur Eingabe einer Agent-Portnummer auf. Sie können die Standardportnummer (8016) akzeptieren oder eine andere angeben, falls der Standardport bereits verwendet wird.
-
Der Installationsassistent fordert Sie zur Eingabe der Anmeldeinformationen (Adresse, Benutzername und Kennwort) für Ihre App Layering-Appliance auf. Registrieren Sie den App Layering-Agent bei der Appliance, indem Sie die IP-Adresse und die Anmeldeinformationen für einen Management Console-Benutzer auf der Appliance mit Administratorrechten eingeben (z. B. die Anmeldeinformationen, die Sie für die Anmeldung an der Management Console verwenden).
Hinweis:
Wenn die App Layering-Appliance nicht verfügbar ist oder Sie sich jetzt nicht registrieren möchten, können Sie die Registrierung später manuell gemäß dem Verfahren unter “Manuelles Registrieren des App Layering-Agenten bei der Appliance” durchführen.
-
Klicken Sie auf Fertig stellen, um den Assistenten zu beenden.
App Layering-Agent manuell bei der Appliance registrieren
Registrieren Sie den App Layering-Agent bei der Appliance.
Wenn der App Layering-Agent während der Installation nicht bei einer App Layering-Appliance registriert wird, können Sie ihn später mithilfe des folgenden Verfahrens registrieren.
-
Melden Sie sich als Administrator bei dem Server an, auf dem Sie den App Layering-Agent installiert haben.
-
Öffnen Sie ein Befehlsfenster (cmd.exe) als Administrator und navigieren Sie zu dem Verzeichnis, in dem der App Layering-Agent installiert ist. Der Standardspeicherort ist C:\Program Files (x86)\Citrix\Agent.
-
Führen Sie den folgenden PowerShell-Befehl aus:
Enable-PSRemoting <!--NeedCopy--> -
Überprüfen Sie, ob Port 8016 geöffnet ist, indem Sie diesen Befehl ausführen:
netstat -a <!--NeedCopy--> -
Öffnen Sie ein Befehlsfenster (cmd.exe) als Administrator und navigieren Sie zu dem Verzeichnis, in dem der App Layering-Agent installiert ist. Der Standardspeicherort ist:
C:\Program Files (x86)\Citrix\Agent <!--NeedCopy--> -
Führen Sie den folgenden Befehl aus, wobei Sie die IP-Adresse der Appliance an der angegebenen Stelle verwenden:
Citrix.AppLayering.Agent.Service.exe register /i /e:IP_address_of_appliance /u:Administrator <!--NeedCopy--> -
Geben Sie bei Aufforderung das Kennwort für einen Benutzer ein, der Administratorrechte in der Management Console auf der Appliance besitzt.
-
Wenn der Registrierungsprozess abgeschlossen ist, wird eine Meldung angezeigt, die Sie über den erfolgreichen Abschluss informiert. Die Registrierung des App Layering-Agenten wird im Überwachungsprotokoll für den Verwaltungsdienst angezeigt.
Wenn der Prozess nicht erfolgreich ist, überprüfen Sie die Agent-Protokolldatei im Installationsverzeichnis:
C:\Program Files (x86)\Citrix\agent\Logs\applayering.agent.log
Sie können auch die Hilfe für die Befehlszeilenoptionen des App Layering-Agenten anzeigen, indem Sie den folgenden Befehl ausführen:
Citrix.AppLayering.Agent.Service.exe /? <!--NeedCopy--> -
Führen Sie den PowerShell-Befehl aus, um die entsprechenden DLL-Dateien auf dem Citrix Provisioning Server zu laden.
Für PVS 7.7 und höher:
-
Navigieren Sie zu:
C:\program files\citrix\provisioning services console <!--NeedCopy--> -
Führen Sie den Befehl aus:
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe Citrix.PVS.snapin.dll <!--NeedCopy-->
Für PVS 7.1–7.6:
-
Navigieren Sie zu:
C:\program files\citrix\provisioning services console <!--NeedCopy--> -
Führen Sie den Befehl aus:
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe McliPSSnapIn.dll <!--NeedCopy-->
Falls einige Citrix Provisioning- und Broker-Snap-Ins nicht registriert sind, z. B. nach einem größeren Windows-Update, finden Sie heraus, welche dies sind.
-
-
Führen Sie den folgenden Befehl aus, um die registrierten Snap-Ins aufzulisten:
get-pssnapin -registered <!--NeedCopy--> -
Anweisungen zum erneuten Registrieren aller Snap-Ins finden Sie in diesem Artikel.