App Layering

Installieren des App Layering-Agents

Der App Layering-Agent ermöglicht es der Appliance oder einem Verpackungscomputer, PowerShell-Befehle lokal auszuführen. Wenn Sie die richtigen Anmeldeinformationen angeben, kann der Agent PowerShell-Befehle als bestimmter Benutzer ausführen.

Wenn der Agent benötigt wird

Der App Layering-Agent ist erforderlich, wenn Sie Folgendes vorhaben:

  • 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 Layered-Images 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-Skripts werden jedoch erst ausgeführt, wenn der Agent bei der Appliance registriert ist.

Voraussetzungen

Stellen Sie vor der Installation des App Layering-Agents 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 zuden Agenten manuell registrierenmit 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 ZIP-Download von App Layering enthalten.

So laden Sie den App Layering-Agent herunter

  1. Wechseln Sie zur Citrix Homepage und klicken Sie dann auf Anmelden.
  2. Klicken Sie auf Downloads, und wählen Sie Citrix App Layering aus der Liste aus.
  3. Klicken Sie auf der Seite Citrix App Layering unter Citrix App Layering > Produktsoftwareauf Citrix App Layering.
  4. Klicken Sie unten auf der Seite auf Extras.
  5. Klicken Sie auf den Citrix App Layering Agent Download-Datei. 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 werden muss, bevor die PowerShell -Skripts ausgeführt werden können.

  1. Melden Sie sich mit einem Konto mit Administratorrechten bei dem System an, auf dem Sie den Agenten installieren.

  2. Kopieren Sie die Datei Citrix_app_layering_agent_installer.exe an einen geeigneten Speicherort auf dem Server.

  3. 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 keine Voraussetzungen vorhanden sind, meldet das Installationsprogramm dies und beendet sich ohne Installation.

  4. Das Installationsprogramm fordert Sie zur Eingabe einer Agent-Port-Nummer auf. Sie können die Standardportnummer (8016) akzeptieren oder eine andere angeben, wenn der Standardport bereits verwendet wird.

  5. 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 Anmeldeinformationen für einen Verwaltungskonsolenbenutzer auf der Appliance mit Administratorrechten eingeben (z. B. die Anmeldeinformationen, mit denen Sie sich an der Verwaltungskonsole anmelden).

    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.

  6. Klicken Sie auf Fertig stellen, um den Assistenten zu beenden.

Manuelles Registrieren des App Layering-Agents 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.

  1. Melden Sie sich als Administrator bei dem Server an, auf dem Sie den App Layering-Agent installiert haben.

  2. Ö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.

  3. Führen Sie den folgenden PowerShell-Befehl aus:

    Enable-PSRemoting

  4. Überprüfen Sie, ob Port 8016 geöffnet ist, indem Sie diesen Befehl ausführen:

    netstat -a

  5. Ö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

  6. 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-->
    
  7. Wenn Sie dazu aufgefordert werden, geben Sie das Kennwort für einen Benutzer ein, der über Administratorrechte in der Verwaltungskonsole der Appliance verfügt.

  8. Wenn der Registrierungsvorgang abgeschlossen ist, wird eine Meldung angezeigt, in der Sie über das erfolgreiche Ergebnis informiert werden. 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 /?

  9. 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:

    1. Navigieren Sie zu:

      C:\program files\citrix\provisioning services console

    2. 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:

    1. Navigieren Sie zu:

      C:\program files\citrix\provisioning services console

    2. 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.

  10. Führen Sie den folgenden Befehl aus, um die registrierten Snap-Ins aufzulisten:

    get-pssnapin -registered

  11. Hier finden Sie Anweisungendiesem Artikelzum erneuten Registrieren aller Snap-Ins.

Installieren des App Layering-Agents