Configurar e instalar mediante parámetros de línea de comandos

Puede personalizar el instalador de Citrix Receiver para Windows mediante opciones en la línea de comandos. El paquete de instalación se descomprime automáticamente en el directorio temporal del usuario antes de iniciar el instalador. El requisito de espacio incluye espacio para archivos de programa, datos de usuarios y directorios temporales después de iniciar varias aplicaciones.

Para obtener información sobre los requisitos del sistema, consulte Requisitos del sistema.

Para instalar Citrix Receiver para Windows desde la interfaz de comandos, use la siguiente sintaxis:

CitrixReceiver.exe [Opciones]

Actualizaciones de Receiver

Opción /AutoUpdateCheck = auto/manual/disabled
Descripción Indica que Citrix Receiver para Windows detecta si hay una actualización disponible. Auto (Automático): Se le notifica cuando hay una actualización disponible (predeterminado). Manual: No se le notifica cuando hay actualizaciones disponibles. Compruebe manualmente si hay actualizaciones. Disabled (Inhabilitado): Se inhabilita la actualización automática.
Ejemplo de uso CitrixReceiver.exe /AutoUpdateCheck = auto ; CitrixReceiver.exe /AutoUpdateCheck = manual ; CitrixReceiver.exe /AutoUpdateCheck = disabled
Opción /AutoUpdateStream= LTSR/Current
Descripción Indica la versión de Citrix Receiver para Windows. LTSR: Indica que la versión es un una versión Long Term Service Release. Current (Reciente): Indica que la versión es la versión más reciente de Citrix Receiver para Windows.
Ejemplo de uso CitrixReceiver.exe /AutoUpdateStream= LTSR ; CitrixReceiver.exe /AutoUpdateStream= Current
Opción /DeferUpdateCount
Descripción Indica la versión de Citrix Receiver para Windows. -1: Indica que puede aplazar las notificaciones cualquier cantidad de veces (el valor predeterminado es -1). 0: Indica que no se muestra la opción “Recordármelo más tarde”. Cualquier otro número: La opción “Recordármelo más tarde” se muestra esa cantidad de veces. Por ejemplo, si establece el valor en 10, la opción Recordármelo más tarde aparecerá 10 veces.
Ejemplo de uso CitrixReceiver.exe /DeferUpdateCount=-1 ; CitrixReceiver.exe /DeferUpdateCount=-0; CitrixReceiver.exe /DeferUpdateCount= cualquier otro número
Opción /AURolloutPriority
Descripción Indica el período en que se puede organizar el despliegue de la actualización. Fast (Rápido): La implantación de la actualización tiene lugar al comienzo del período de entrega. Medium (Medio): La implantación de la actualización tiene lugar hacia la mitad del periodo de entrega. Slow (Lento): La implantación de la actualización tiene lugar al final del período de entrega.
Ejemplo de uso CitrixReceiver.exe /AURolloutPriority=Fast; CitrixReceiver.exe /AURolloutPriority=Medium; CitrixReceiver.exe /AURolloutPriority=Slow

Habilitar la redirección de contenido bidireccional

Nota

De forma predeterminada, Citrix Receiver para Windows no instala los componentes de la redirección de contenido bidireccional si ya están instalados en el servidor. Si está usando XenDesktop como una máquina cliente, debe instalar Citrix Receiver para Windows utilizando el conmutador /FORCE_LAA para instalar los componentes de la redirección de contenido bidireccional. La función, sin embargo, debe configurarse tanto en el cliente como en el servidor.

Opción ALLOW_BIDIRCONTENTREDIRECTION=1
Descripción Indica que la redirección de contenido bidireccional del cliente al host y del host al cliente está Habilitada.
Ejemplo de uso CitrixReceiver.exe /ALLOW_BIDIRCONTENTREDIRECTION=1

Ocultar opción de parámetros

   
Opción /DisableSetting
Descripción Impide que Opción de parámetros aparezca en el diálogo Preferencias avanzadas.
Ejemplo de uso CitrixReceiver.exe /DisableSetting=3
   
Si quiere que Presentación de las aplicaciones y Opciones de reconexión aparezcan en Opción de parámetros Escriba CitrixReceiver.exe /DisableSetting=0
Si quiere que Opción de parámetros no aparezca en el diálogo Preferencias avanzadas Escriba CitrixReceiver.exe /DisableSetting=3
Si quiere que Opción de parámetros solo muestre Presentación de las aplicaciones Escriba CitrixReceiver.exe /DisableSetting=2
Si quiere que Opción de parámetros solo muestre Opciones de reconexión Escriba CitrixReceiver.exe /DisableSetting=1

Habilitar el acceso a aplicaciones locales

Opción FORCE_LAA=1
Descripción De manera predeterminada, Citrix Receiver para Windows no instala los componentes de cliente de Acceso a aplicaciones locales, si los componentes ya están instalados en el servidor. Para forzar los componentes de Acceso a aplicaciones locales del lado del cliente en Citrix Receiver, utilice el conmutador de línea de comandos FORCE_LAA. Se requieren privilegios de administrador para realizar estos pasos. Para obtener más información sobre el Acceso a aplicaciones locales, consulte Acceso a aplicaciones locales en la documentación de XenApp y XenDesktop.
Ejemplo de uso CitrixReceiver.exe /FORCE_LAA =1

Mostrar información de uso

Opción /? o /help
Descripción Indica información de uso
Ejemplo de uso CitrixReceiver.exe /?; CitrixReceiver.exe /help

Omitir el reinicio durante las instalaciones con interfaz de usuario

Opción /noreboot
Descripción Omite el reinicio durante las instalaciones con interfaz de usuario. Esta opción no es necesaria para instalaciones silenciosas. Si elimina las solicitudes de reinicio, Citrix Receiver para Windows no reconocerá aquellos dispositivos USB que estén en estado suspendido cuando Citrix Receiver para Windows se instale; permanecerán sin reconocimiento hasta que se reinicie el dispositivo del usuario.
Ejemplo de uso CitrixReceiver.exe /noreboot

Instalación silenciosa

Opción /silent
Descripción Inhabilita los cuadros de diálogo de error y progreso para ejecutar una instalación completamente silenciosa.
Ejemplo de uso CitrixReceiver.exe /silent

Habilitar autenticación Single Sign-on

Opción /includeSSON
Descripción Indica que Citrix Receiver para Windows se instalará con el componente de inicio de sesión único Single Sign-On. La opción relacionada, ENABLE_SSON, se habilita cuando /includeSSON figura en la línea de comandos. Si usa ADDLOCAL= para especificar características y quiere instalar Single Sign-On, también tiene que especificar el valor SSON. Para habilitar la autenticación PassThrough en un dispositivo de usuario, es necesario instalar Citrix Receiver para Windows con derechos de administrador local desde una línea de comandos que incluya la opción /includeSSON. Para obtener más información, consulte How to Manually Install and Configure Citrix Receiver for Pass-Through Authentication. Nota: Las directivas Tarjeta inteligente, Kerberos y Nombre de usuario y contraseña locales son interdependientes. El orden de configuración es importante. Le recomendamos que inhabilite primero las directivas que no desee usar y, a continuación, habilite las directivas que necesite. Compruebe los resultados con atención.
Ejemplo de uso CitrixReceiver.exe /includeSSON

Habilitar Single Sign-on cuando /includeSSON está especificado

Opción ENABLE_SSON={Yes, No}
Descripción Habilita el inicio de sesión único (Single Sign-on) cuando se especifica /includeSSON. El valor predeterminado es Yes. Esta propiedad es necesaria para los inicios de sesión Single Sign-on con tarjeta inteligente. Después de realizar una instalación con la autenticación Single Sign-On habilitada, los usuarios deberán cerrar y volver a iniciar sus sesiones en los dispositivos. Requiere derechos de administrador.
Ejemplo de uso CitrixReceiver.exe ENABLE_SSON=Yes

Seguimiento permanente

Opción /EnableTracing={true, false}
Descripción De manera predeterminada, esta función tiene el valor true. Use esta propiedad para habilitar o inhabilitar la función Seguimiento permanente (Always-on tracing). La función Seguimiento permanente ayuda a recopilar registros importantes en el momento de la conexión. Esos registros pueden resultar de utilidad en la resolución de problemas de conectividad intermitente. La directiva Seguimiento permanente sobrescribe este parámetro.
Ejemplo de uso CitrixReceiver.exe /EnableTracing=true

Uso del programa Customer Experience Improvement Program de Citrix (CEIP)

Opción EnableCEIP={true, false }
Descripción Cuando se participa en el programa CEIP de mejora de la experiencia del usuario (Customer Experience Improvement Program), se envían estadísticas e información de uso anónimos a Citrix para ayudar a Citrix a mejorar la calidad y el rendimiento de sus productos.
Ejemplo de uso CitrixReceiver.exe EnableCEIP=true

Especificar el directorio de instalación

Opción INSTALLDIR=Installation Directory
Descripción Especifica la ruta de instalación donde se instala la mayor parte del software de Citrix Receiver. El valor predeterminado es C:\Archivos de programa\Citrix\Receiver. Los siguientes componentes de Receiver se instalan en la ruta C:\Archivos de programa\Citrix: Authentication Manager, Citrix Receiver y Self-Service plug-in. Si usa esta opción y especifica un directorio de instalación, debe instalar RIInstaller.msi en el directorio \Receiver y los demás archivos .msi en el directorio de instalación.
Ejemplo de uso CitrixReceiver.exe INSTALLDIR=c:\Citrix\Test

Identificar un dispositivo de usuario

Opción CLIENT_NAME=ClientName
Descripción Especifica el nombre del cliente, donde ClientName identifica el dispositivo de usuario en el servidor. El valor predeterminado es %COMPUTERNAME%
Ejemplo de uso CitrixReceiver.exe CLIENT_NAME=%COMPUTERNAME%.

Nombre de cliente dinámico

Opción ENABLE_CLIENT_NAME=Yes, No
Descripción La función de nombre de cliente dinámico permite que el nombre del cliente sea el mismo que el nombre del equipo. Cuando los usuarios cambian el nombre de su equipo, el nombre de cliente también cambia. El valor predeterminado es Yes. Si quiere inhabilitar el respaldo para usar el nombre de cliente dinámico, defina esta propiedad con el valor “No” y especifique un valor para la propiedad CLIENT_NAME.
Ejemplo de uso CitrixReceiver.exe ENABLE_DYNAMIC_CLIENT_NAME =Yes

Instalar componentes especificados

Opción ADDLOCAL=<característica… ,>
Descripción alt_text
Ejemplo de uso CitrixReceiver.exe ADDLOCAL=ReceiverInside,ICA_Client,AM,SELFSERVICE,DesktopViewer,Flash,Vd3d,usb,WebHelper

Configurar Citrix Receiver para Windows para agregar tiendas manualmente

Opción ENABLE_CLIENT_NAME=Yes, No
Descripción La función de nombre de cliente dinámico permite que el nombre del cliente sea el mismo que el nombre del equipo. Cuando los usuarios cambian el nombre de su equipo, el nombre de cliente también cambia. El valor predeterminado es Yes. Si quiere inhabilitar el respaldo para usar el nombre de cliente dinámico, defina esta propiedad con el valor “No” y especifique un valor para la propiedad CLIENT_NAME.
Ejemplo de uso CitrixReceiver.exe ENABLE_DYNAMIC_CLIENT_NAME =Yes

Guardar las credenciales de las tiendas localmente usando el protocolo PNAgent

Opción ALLOWSAVEPWD={N, S, A}
Descripción El valor predeterminado es el valor especificado desde el servidor PNAgent durante la ejecución. Especifica si los usuarios pueden guardar las credenciales para las tiendas localmente en sus equipos y se aplica solamente a tiendas que usan el protocolo PNAgent. El valor predeterminado es “S”. A continuación, dispone de las demás opciones disponibles. N: Nunca se permite que los usuarios guarden sus contraseñas. S: Se permite que los usuarios guarden contraseñas tanto para tiendas seguras (HTTPS), tienda no seguras (HTTPS) como tiendas no seguras (HTTP). También puede controlar esta característica actualizando la clave de Registro HKLM\Software[Wow6432Node]\Citrix\Dazzle\AllowSavePwd. Nota: Si AllowSavePwd no funciona, debe agregarse manualmente la siguiente clave de Registro: 1 Clave para SO cliente de 32 bits: HKLM\Software\Citrix\AuthManager 2 Clave para SO cliente de 64 bits: HKLM\Software\wow6432node\Citrix\AuthManager 3 Tipo: REG_SZ 4 Valor: never (no permitir nunca a los usuarios guardar sus contraseñas), secureonly (permitir a los usuarios guardar contraseñas solo para las tiendas seguras, es decir, configuradas con HTTPS) y always (permitir a los usuarios guardar sus contraseñas tanto para las tiendas seguras, es decir, HTTPS, como para las no seguras, es decir, HTTP).
Ejemplo de uso CitrixReceiver.exe ALLOWADDSTORE=N

Seleccionar el certificado

Opción AM_CERTIFICATESELECTIONMODE={Prompt, SmartCardDefault, LatestExpriry }    
Descripción Use esta opción para seleccionar un certificado. El valor predeterminado es “Prompt”, que pide al usuario que elija un certificado de la lista. Cambie esta propiedad para seleccionar la opción de certificado predeterminado (según lo indique el proveedor de la tarjeta inteligente) o la opción de certificado con la fecha de caducidad más lejana. Si no hay certificados de inicio de sesión válidos, se notifica de ello al usuario y se le da la opción de usar un método de inicio de sesión alternativo, si hay alguno disponible. También se puede controlar esta característica actualizando la clave de Registro HKCU o HKLM\Software[Wow6432Node]Citrix\AuthManager:CertificateSelectionMode={ Prompt SmartCardDefault LatestExpiry }. Los valores definidos en HKCU tienen preferencia sobre los valores definidos en HKLM para facilitar al usuario la selección de certificado.
Ejemplo de uso CitrixReceiver.exe AM_CERTIFICATESELECTIONMODE=Prompt    

Usar componentes del proveedor CSP para administrar la entrada del PIN de tarjeta inteligente

Opción AM_SMARTCARDPINENTRY=CSP
Descripción Usar los componentes del proveedor de servicios criptográficos (CSP) para administrar la entrada del PIN de la tarjeta inteligente. De manera predeterminada, los diálogos de PIN que se presentan a los usuarios provienen de Citrix Receiver en lugar de venir del proveedor CSP (Cryptographic Service Provider) de la tarjeta inteligente. Receiver pide a los usuarios que introduzcan un PIN cuando es necesario, y luego pasa el PIN al proveedor CSP de la tarjeta inteligente. Especifique esta propiedad para usar los componentes del proveedor CSP para gestionar la introducción del PIN, incluidas las solicitudes de PIN.
Ejemplo de uso CitrixReceiver.exe AM_SMARTCARDPINENTRY=CSP

Usar Kerberos

Opción ENABLE_KERBEROS={Yes, No}
Descripción El valor predeterminado es “No”. Esta opción especifica si el motor HDX debe usar la autenticación Kerberos y se aplica solo cuando la autenticación Single Sign-On (PassThrough) está habilitada. Para obtener más información, consulte Configurar autenticación PassThrough de dominio con Kerberos.
Ejemplo de uso CitrixReceiver.exe ENABLE_KERBEROS=No

Mostrar iconos de FTA antiguos

Opción LEGACYFTAICONS={False, True}
Descripción Use esta opción para mostrar los iconos de asociación de tipos de archivos (FTA) antiguos. El valor predeterminado es “False”. Especifique si se muestran los iconos de aplicación para aquellos documentos que tienen asociaciones de tipo de archivo con aplicaciones suscritas. Cuando el parámetro está configurado como False, Windows genera iconos para documentos que no tienen un icono específico asignado a ellos. Los iconos generados por Windows consisten en un icono de documento genérico superpuesto con un icono de la aplicación de tamaño más pequeño. Citrix recomienda habilitar esta opción si planea entregar aplicaciones de Microsoft Office a usuarios que ejecutan Windows 7.
Ejemplo de uso CitrixReceiver.exe LEGACYFTAICONS=False

Habilitar el preinicio de sesiones

Opción ENABLEPRELAUNCH={False, True}
Descripción El valor predeterminado es “False”. Para obtener información acerca del preinicio de sesiones, consulte Reducir el tiempo de inicio de las aplicaciones.
Ejemplo de uso CitrixReceiver.exe ENABLEPRELAUNCH=False

Especificar el directorio para los accesos directos del menú Inicio

Opción STARTMENUDIR={Nombre del directorio}
Descripción De forma predeterminada, las aplicaciones aparecen en Inicio > Todos los programas. Puede especificar la ruta relativa de los accesos directos en la carpeta de programas. Por ejemplo, para colocar accesos directos en Inicio > Todos los programas > Receiver, especifique STARTMENUDIR=\Receiver. Puede cambiar o mover la carpeta en cualquier momento. También puede controlar esta característica con una clave de Registro. Cree la entrada REG_SZ para StartMenuDir y establézcala en el valor “\RelativePath” Location: HKEY_LOCAL_MACHINE\Software[Wow6432Node]Citrix\Dazzle, HKEY_CURRENT_USER\Software\Citrix\Dazzle. Para aplicaciones publicadas a través de XenApp con el elemento Carpeta de aplicaciones del cliente (también llamado Carpeta de Program Neighborhood) especificado, se puede configurar para que esa carpeta se agregue a la ruta de accesos directos. Para ello, cree la entrada REG_SZ para UseCategoryAsStartMenuPath y otórguele el valor “true”. Use las mismas ubicaciones de Registro señaladas anteriormente.Nota: Windows 8 u 8.1 no permite crear carpetas anidadas dentro del menú Inicio. Las aplicaciones se mostrarán de forma individual o dentro de la carpeta raíz, no en las subcarpetas de categorías definidas. Ejemplos: 1 Si la carpeta de aplicaciones del cliente es \office, UseCategoryAsStartMenuPath tiene el valor “true”, y no se especifica un directorio StartMenuDir, los accesos directos se colocan en Inicio > Todos los programas > Office. 2 Si la carpeta de aplicaciones del cliente es \office, UseCategoryAsStartMenuPath tiene el valor “true” y el directorio StartMenuDir es \Receiver, los accesos directos se colocan en Inicio > Todos los programas > Receiver > Office. Los cambios que se hagan a estos parámetros no tienen impacto alguno en los accesos directos ya creados. Para mover accesos directos, es necesario desinstalar y volver a instalar las aplicaciones.
Ejemplo de uso CitrixReceiver.exe STARTMENUDIR=\Office

Especificar el nombre de la tienda

Opción STOREx=”storename;http[s]://servername.domain/IISLocation/discovery;[On, Off]; [storedescription] “[STOREy=”–”]
Descripción Use esta opción para especificar el nombre de la tienda. Especifica hasta 10 tiendas para usar con Citrix Receiver. Valores: x e y (números enteros de 0 a 9); storename (el valor predeterminado es la tienda). Este valor debe coincidir con el nombre configurado en el servidor StoreFront. servername.domain: El nombre de dominio completo del servidor que aloja la tienda. IISLocation: La ruta a la tienda en IIS. La URL de la tienda debe coincidir con la URL en los archivos de aprovisionamiento de StoreFront. Las direcciones URL de tienda tienen el formato “/Citrix/store/discovery”. Para obtener la dirección URL, exporte un archivo de aprovisionamiento desde StoreFront, ábralo en el bloc de notas y copie la dirección URL desde el elemento <Address>. On, Off: El parámetro de configuración “Off” opcional permite entregar tiendas inhabilitadas, lo que ofrece a los usuarios la opción de acceso. Cuando el estado de la tienda no se especifica, el parámetro predeterminado es “On” (habilitado). storedescription: Una descripción optativa de la tienda, por ejemplo “Tienda de aplicaciones de RRHH”.Nota: En esta versión, es importante incluir “/discovery” en la URL de la tienda para que la autenticación PassThrough se realice correctamente.
Ejemplo de uso CitrixReceiver.exe STORE0=”Store;https://test.xx.com/Citrix/Store/Discovery

Habilitar la redirección de URL en los dispositivos de los usuarios

Opción ALLOW_CLIENTHOSTEDAPPSURL=1
Descripción Habilita la característica de redirección de URL en los dispositivos de los usuarios. Requiere derechos de administrador. Requiere que Citrix Receiver se instale para Todos los usuarios. Para obtener información sobre la redirección de URL, consulte “Acceso a aplicaciones locales” y sus temas secundarios en la documentación de XenDesktop 7.
Ejemplo de uso CitrixReceiver.exe ALLOW_CLIENTHOSTEDAPPSURL=1

Habilitar el modo de autoservicio

Opción SELFSERVICEMODE={False, True}
Descripción El valor predeterminado es True. Cuando el administrador establece la marca SelfServiceMode con el valor False, el usuario deja de tener acceso a la interfaz de usuario de autoservicio de Citrix Receiver. En vez de ello, el usuario puede acceder a las aplicaciones suscritas desde el menú Inicio y a través de accesos directos de escritorio, lo que se conoce como modo de acceso directo solamente.
Ejemplo de uso CitrixReceiver.exe SELFSERVICEMODE=False

Especificar el directorio para los accesos directos de escritorio

Opción DESKTOPDIR=Directory Name
Descripción Coloca todos los accesos directos en una misma carpeta. Se respalda el uso de CategoryPath para los accesos directos de escritorio. Nota: Cuando se usa la opción DESKTOPDIR, configure la clave PutShortcutsOnDesktop con el valor True.
Ejemplo de uso CitrixReceiver.exe DESKTOPDIR=\Office

Actualizar desde una versión de Citrix Receiver no respaldada

Nota

Cuando se actualiza Citrix Receiver 13.x Enterprise o 12.x a Citrix Receiver para Windows 4.4 y versiones posteriores desde la interfaz gráfica de usuario, el instalador ejecuta la utilidad de limpieza de Receiver de forma predeterminada.

Sin embargo, la utilidad no se ejecuta de forma predeterminada cuando se actualiza desde la línea de comandos. Para actualizar desde la línea de comandos, ejecute el siguiente comando:

CitrixReceiver.exe /rcu /silent

Cuando se actualiza Citrix Receiver para Windows desde 13.x (no Enterprise) o 4.1 a la versión 4.2 o una versión posterior, el modificador de línea de comandos /rcu no es necesario y se ignora.

Opción /rcu
Descripción Permite actualizar una versión no respaldada a la versión más reciente de Citrix Receiver.
Ejemplo de uso CitrixReceiver.exe /rcu

Solucionar problemas de la instalación

Si existe un problema con la instalación, busque en el directorio %TEMP%/CTXReceiverInstallLogs del usuario para consultar los registros que tengan el prefijo CtxInstall- o TrolleyExpress- . Por ejemplo:

CtxInstall-ICAWebWrapper-20141114-134516.log

TrolleyExpress-20090807-123456.log

Ejemplos de una instalación de línea de comandos

Para especificar la URL de tienda de NetScaler Gateway:

CitrixReceiver.exe STORE0=”<StoreFriendlyName>;testserver <StoreName>;<On/Off>;<StoreDescription>”]

Nota: La URL de tienda de NetScaler Gateway debe ser la primera entrada en la lista de direcciones URL configuradas de tienda.

Para instalar todos los componentes de manera silenciosa y especificar dos tiendas de aplicaciones:

alt_text

Para especificar la autenticación con Single Sign-On (autenticación PassThrough o paso de credenciales) y agregar una tienda que haga referencia a una URL de servicios XenApp:

alt_text

Para iniciar una aplicación o un escritorio virtual desde la línea de comandos

Citrix Receiver para Windows crea una aplicación de código auxiliar (stub) para cada aplicación o escritorio suscrito. Es posible usar una aplicación de código auxiliar para iniciar una aplicación o un escritorio virtual desde la línea de comandos. Las aplicaciones de código auxiliar se encuentran en %appdata%\Citrix\SelfService. El nombre de archivo de una aplicación de código auxiliar es el nombre simplificado de la aplicación con los espacios eliminados. Por ejemplo, el nombre de archivo de la aplicación de código auxiliar para Internet Explorer es InternetExplorer.exe.

Configurar e instalar mediante parámetros de línea de comandos