Installieren des App Layering Agents
Der App Layering Agent ermöglicht es der Appliance oder einer Verpackungsmaschine, PowerShell-Befehle lokal auszuführen. Wenn Sie die richtigen Anmeldeinformationen angeben, kann der Agent PowerShell-Befehle als ein bestimmter Benutzer ausführen.
Wenn der Agent benötigt wird
Der App Layering Agent ist erforderlich, wenn Sie Folgendes planen:
- Starten Sie Skripts mithilfe der Connectorkonfigurationen.
- Führen Sie die App Layering-Appliance in Microsoft Hyper-V aus.
- Veröffentlichen Sie Layerimages in Citrix Provisioning.
Sie installieren den Agenten an den folgenden Speicherorten:
- Auf allen Hyper-V-Servern, die Sie für die Layererstellung oder Imageveröffentlichung verwenden möchten.
- Auf allen Citrix Provisioning-Servern, auf denen Sie Layerimages veröffentlichen möchten.
- An Orten, an denen die Connectorkonfigurationen PowerShell-Skripts ausgeführt werden.
Registrieren des Agenten bei der Appliance
Das App Layering-Agent-Installationsprogramm fordert Sie auf, den Agent 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
Stellen Sie vor der Installation des App Layering Agent 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. Lesen Sie die Schritte zur manuellen Registrierung des Agenten bei der Appliance.
Wenn Sie den App Layering-Agent bereits installiert haben, können Sie aktualisierte Versionen von der Citrix Download-Seite herunterladen. Das Agenteninstallationspaket 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 Seite Citrix App Layering unter Citrix App Layering > Produktsoftware auf Citrix App Layering.
- Klicken Sie unten auf der Seite auf Tools.
- Klicken Sie auf den Citrix App Layering-Agent Datei herunterladen. Die Datei citrix_app_layering_agent_installer.exe wird auf Ihren Computer heruntergeladen.
Installieren des App Layering Agents
Das App Layering-Agent-Installationsprogramm fordert Sie auf, den Agent 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 Ort auf dem Server.
-
Führen Sie Citrix_app_layering_agent_installer.exe als Administrator aus, und geben Sie bei entsprechender 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.
Das Agent-Installationsprogramm überprüft, ob alle Voraussetzungen vorhanden sind. Wenn irgendwelche Voraussetzungen fehlen, meldet das Installationsprogramm dies und wird ohne Installation verlässt.
-
Das Installationsprogramm fordert Sie zur Eingabe einer Agent-Portnummer auf. Sie können die Standardportnummer (8016) akzeptieren oder eine andere angeben, wenn der Standardport bereits verwendet wird.
-
Das Installationsprogramm 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 Benutzer der Managementkonsole auf der Appliance mit Administratorrechten eingeben (z. B. die Anmeldeinformationen, die Sie für die Anmeldung an der Managementkonsole verwenden).
Hinweis:
Wenn die App Layering Appliance nicht verfügbar ist oder Sie sich jetzt nicht anmelden möchten, können Sie sich später manuell registrieren, indem Sie das unter Bei der App Layering-Appliance registrieren beschriebenen Verfahren manuell ausführen.
-
Klicken Sie auf Finish, um den Assistenten zu beenden
Registrieren Sie den App Layering Agent manuell bei der Appliance
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 ist, 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 als Administrator ein Befehlsfenster (cmd.exe) 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 -
Überprüfen Sie, ob Port 8016 geöffnet ist, indem Sie diesen Befehl ausführen:
netstat -a -
Öffnen Sie als Administrator ein Befehlsfenster (cmd.exe) 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 Befehl unter Angabe der IP-Adresse der Appliance aus:
Citrix.AppLayering.Agent.Service.exe register /i /e:IP_address_of_appliance /u:Administrator <!--NeedCopy--> -
Wenn Sie dazu aufgefordert werden, geben Sie das Kennwort für einen Benutzer ein, der über Administratorrechte in der Verwaltungskonsole der Appliance verfügt.
-
Wenn der Registrierungsvorgang abgeschlossen ist, wird eine Meldung angezeigt, die Sie über das erfolgreiche Ergebnis 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 die Hilfe für die Befehlszeilenoptionen des App Layering-Agenten auch anzeigen, indem Sie den folgenden Befehl ausführen:
Citrix.AppLayering.Agent.Service.exe /? -
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 -
Führen Sie folgenden Befehl aus:
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe Citrix.PVS.snapin.dll
Für PVS 7.1 — 7.6:
-
Navigieren Sie zu:
C:\program files\citrix\provisioning services console -
Führen Sie folgenden Befehl aus:
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe McliPSSnapIn.dll
Falls einige Citrix Provisioning - und Broker-Snap-Ins aufgehoben werden, z. B. nach einem großen Windows-Update, finden Sie heraus, welche.
-
-
Führen Sie den folgenden Befehl aus, um die registrierten Snap-Ins aufzulisten:
get-pssnapin -registered -
In diesem Artikel finden Sie Anweisungen zur erneuten Registrierung aller Snap-Ins.