Instalar el agente de App Layering
El agente App Layering permite que el dispositivo o un equipo de empaquetado ejecuten comandos de PowerShell localmente. Si proporciona las credenciales adecuadas, el agente puede ejecutar comandos de PowerShell como un usuario específico.
Cuando se requiere el agente
El agente App Layering es necesario si tiene previsto:
- Inicie scripts mediante las configuraciones de conectores.
- Ejecute el dispositivo de App Layering en Microsoft Hyper-V.
- Publique imágenes en capas en Citrix Provisioning.
Instalar el agente en las siguientes ubicaciones:
- En todos los servidores Hyper-V que planea utilizar para la creación de capas o la publicación de imágenes.
- En todos los servidores de Citrix Provisioning en los que tenga previsto publicar imágenes en capas.
- En ubicaciones donde las configuraciones de conectores ejecutan scripts de PowerShell.
Registrar el agente con el dispositivo
El instalador del agente de App Layering le pide que registre el agente con un dispositivo de App Layering. Si no registra el agente durante la instalación, puede registrarlo manualmente más tarde. Sin embargo, los scripts de PowerShell no se ejecutan hasta que el agente se registra con el dispositivo.
Requisitos previos
Antes de instalar el agente App Layering, asegúrese de que el sistema en el que está instalando el agente cumple los siguientes requisitos:
- Una cuenta con privilegios de administrador
- .NET 4.5
- PowerShell 3.0 o una versión posterior
- Complemento PowerShell. Antes de utilizar el agente App Layering en un servidor de Citrix Provisioning Services, debe asegurarse de que el complemento PowerShell esté instalado. Consulte los pasos para registrar manualmente el agente en el dispositivo.
Si instaló anteriormente el agente App Layering, puede descargar versiones actualizadas desde la página de descargas de Citrix. El paquete de instalación del agente se incluye en la descarga ZIP de App Layering.
Para descargar el agente App Layering
- Vaya a la página principal de Citrix y, a continuación, haga clic en Iniciar sesión.
- Haga clic en Descargas y seleccione Citrix App Layering de la lista.
- En la página Citrix App Layering, en Citrix App Layering > Software de producto, haga clic en Citrix App Layering.
- En la parte inferior de la página, haga clic en Herramientas.
- Haga clic en el agente de Citrix App Layering Descargar archivo. El archivo citrix_app_layering_agent_installer.exe se descarga a su equipo.
Instalar el agente de App Layering
El instalador del agente de App Layering le pide que registre el agente con un dispositivo de App Layering. Si no registra el agente durante la instalación, puede registrarlo manualmente más tarde. Sin embargo, tenga en cuenta que el agente debe estar registrado en el dispositivo antes de que se puedan ejecutar los scripts de PowerShell.
-
Con una cuenta con privilegios de administrador, inicie sesión en el sistema donde está instalando el agente.
-
Copie el archivo Citrix_app_layering_agent_installer.exe en una ubicación conveniente del servidor.
-
Ejecute Citrix_app_layering_agent_installer.exe como administrador y, cuando se le solicite, escriba la ruta al directorio en el que quiere instalar el agente App Layering. La ubicación predeterminada es C:\Program Files (x86)\Citrix\Agent.
El instalador del agente comprueba que todos los requisitos previos están presentes. Si falta algún requisito previo, el instalador lo informa y sale sin necesidad de instalarlo.
-
El instalador le solicita un número de puerto del agente. Puede aceptar el número de puerto predeterminado (8016) o especificar uno diferente si el puerto predeterminado ya está en uso.
-
El instalador le solicita las credenciales (dirección, nombre de usuario y contraseña) del dispositivo de App Layering. Registre el agente App Layering con el dispositivo introduciendo la dirección IP y las credenciales de inicio de sesión de un usuario de la consola de administración en el dispositivo con privilegios de administrador (por ejemplo, las credenciales que utiliza para iniciar sesión en la consola de administración).
Nota:
Si el dispositivo de App Layering no está disponible o decide no registrarse con él ahora, puede registrarse manualmente más adelante mediante el procedimiento descrito en Registrar con el dispositivo de App Layering manualmente.
-
Haga clic en Finalizar para salir del asistente.
registrar manualmente el agente App Layering con el dispositivo
Registre el agente App Layering con el dispositivo.
Si el agente de App Layering no está registrado en un dispositivo de App Layering durante la instalación, puede registrarlo más adelante mediante el procedimiento siguiente.
-
Como administrador, inicie sesión en el servidor donde instaló el agente App Layering.
-
Abra una ventana de comandos (cmd.exe) como administrador y navegue hasta el directorio donde está instalado el Agente de App Layering. La ubicación predeterminada es C:\Program Files (x86)\Citrix\Agent.
-
Ejecute el siguiente comando de PowerShell:
Enable-PSRemoting -
Compruebe que el puerto 8016 está abierto ejecutando este comando:
netstat -a -
Abra una ventana de comandos (cmd.exe) como administrador y navegue hasta el directorio donde está instalado el Agente de App Layering. La ubicación predeterminada es:
C:\Program Files (x86)\Citrix\Agent -
Ejecute el siguiente comando, mediante la dirección IP del dispositivo donde se indique:
Citrix.AppLayering.Agent.Service.exe register /i /e:IP_address_of_appliance /u:Administrator <!--NeedCopy--> -
Cuando se le solicite, escriba la contraseña de un usuario que tenga privilegios de administrador en la consola de administración del dispositivo.
-
Cuando finaliza el proceso de registro, aparece un mensaje informándole del resultado correcto. El registro del agente de App Layering aparece en el registro de auditoría del servicio de administración.
Si el proceso no se realiza correctamente, examine el archivo de registro del agente en el directorio de instalación:
C:\Program Files (x86)\Citrix\agent\Logs\applayering.agent.log
También puede ver la Ayuda para las opciones de línea de comandos del agente App Layering ejecutando el siguiente comando:
Citrix.AppLayering.Agent.Service.exe /? -
Ejecute el comando PowerShell para cargar los archivos DLL correspondientes en Citrix Provisioning Server.
Para PVS 7.7 y versiones posteriores:
-
Desplácese hasta:
C:\program files\citrix\provisioning services console -
Ejecute el comando:
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe Citrix.PVS.snapin.dll
Para PVS 7.1—7.6:
-
Desplácese hasta:
C:\program files\citrix\provisioning services console -
Ejecute el comando:
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe McliPSSnapIn.dll
En caso de que algunos complementos de Citrix Provisioning y Broker no estén registrados, por ejemplo, después de una actualización importante de Windows, averigüe cuáles.
-
-
Ejecute el siguiente comando para enumerar los complementos registrados:
get-pssnapin -registered -
Consulte este artículo para obtener instrucciones sobre cómo volver a registrar todos los complementos.