Guía de instalación de la aplicación Alteryx One mediante línea de comandos
Enterprise Deployment
For IT-managed deployments, a complete Alteryx One installation requires two separate installers:
Alteryx One app installer: Deploy first. The Alteryx One app is the required entry point for launching Designer 2026.1 and later. Use the command-line flags mentioned in this guide to deploy silently across machines.
Designer installer: Deploy second. Download the Designer installer from the Download & Activate page in the Alteryx One app (or browser version). Use the Designer installer to script the full Designer installation, including optional components like Predictive Tools. For more details, go to Download and Install Desktop Modules.
Nota
The command-line flags mentioned in this guide apply only to the Alteryx One app installer. The Designer installer has its own installation options.
Alteryx One App Installer
The Alteryx One installer supports command-line options that enable silent installations, enterprise deployments, and automated software distribution. This guide explains the available options, deployment considerations, and installer exit codes.
Nota
Todos los indicadores de la línea de comandos del instalador distinguen entre mayúsculas y minúsculas. Los indicadores no válidos, los errores ortográficos o las mayúsculas incorrectas se ignoran y no generan un mensaje de error.
Instalación predeterminada (por usuario): si no se proporcionan indicadores de línea de comandos, el instalador realiza una instalación por usuario en la ubicación predeterminada:
%LOCALAPPDATA%\Alteryx\AlteryxOneEjemplo:
AlteryxOne-1.0.352-US-setup.exe/ALLUSERS: utiliza este indicador para instalar la aplicación Alteryx One para todos los usuarios del equipo (instalación por máquina).Ubicación de instalación predeterminada:
C:\Program Files\Alteryx\AlteryxOne.Ejemplo:
AlteryxOne-1.0.352-US-setup.exe /ALLUSERS
/S: utiliza este indicador para ejecutar el instalador en modo silencioso. Cuando se utiliza, el instalador no muestra el instalador interactivo y acepta todas las configuraciones predeterminadas, a menos que se modifiquen con indicadores adicionales compatibles. Ejemplos:AlteryxOne-1.0.352-US-setup.exe /SAlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS
/NOAUTOLAUNCH: utiliza este indicador para evitar que la aplicación Alteryx One se inicie automáticamente después de la instalación. Esta opción solo es compatible con instalaciones silenciosas (/S).Ejemplos:
AlteryxOne-1.0.352-US-setup.exe /S /NOAUTOLAUNCHAlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS /NOAUTOLAUNCH
/D=<path>: utiliza este indicador para especificar un directorio de instalación personalizado.Requisitos y limitaciones:
Solo se admite para instalaciones silenciosas por máquina.
Solo se admite instalaciones por máquina; no se admiten ubicaciones personalizadas para instalaciones por usuario.
El instalador añade automáticamente una subcarpeta “AlteryxOne” a la ubicación especificada.
/D=C:\temp\Alteryxestá instalado enC:\temp\Alteryx\AlteryxOne./D=C:\temp\AlteryxOneestá instalado enC:\temp\AlteryxOne\AlteryxOne.Ejemplo:
AlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS /D=C:\path\to\installLocationSe instala en:
C:\InstallLocation\AlteryxOneEjemplo con espacios:
AlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS /D=C:\Program Files\CustomLocationSe instala en:
C:\Program Files\CustomLocation\AlteryxOne
Consideraciones importantes para el indicador
/D=:El parámetro
/D=<path>debe ser el argumento final del comando. Cualquier texto que aparezca después de/D=se interpreta como parte de la ruta de instalación, no como indicadores de instalación adicionales.Por ejemplo, el siguiente comando:
AlteryxOne-1.0.359-US-setup.exe /ALLUSERS /D=C:\temp\Alteryx /S /NOAUTOLAUNCHse instala enC:\temp\Alteryx S NOAUTOLAUNCH.Para evitar ubicaciones de instalación inesperadas, siempre coloca
/D=como el último argumento:AlteryxOne-1.0.359-US-setup.exe /S /ALLUSERS /NOAUTOLAUNCH /D=C:\temp\Alteryx.No incluyas entre comillas la ruta especificada con
/D=. Si se utilizan comillas, el instalador ignora el parámetro/D=y se instala en la ubicación predeterminada para el tipo de instalación seleccionado.Ejemplo:
AlteryxOne-1.0.359-US-setup.exe /ALLUSERS /D="C:\temp\Alteryx"Resultado: se ignora el parámetro
/D=y la aplicación se instala en:C:\Program Files\Alteryx\AlteryxOne
Nota
Los indicadores no compatibles o combinados incorrectamente no generan un mensaje de error. Según el indicador, el instalador puede ignorar la opción no compatible o interpretar el comando de manera diferente de lo esperado. Para rutas de instalación personalizadas, asegúrate siempre de que /D= sea el argumento final. Además, no incluya entre comillas la ruta especificada con /D=.
Capturar códigos de error al instalar Alteryx One mediante una instalación silenciosa
Las instalaciones silenciosas devuelven códigos de salida que los administradores de TI pueden utilizar para determinar si la instalación se completó correctamente o falló.
Esto se aplica tanto a las instalaciones silenciosas por usuario como por máquina. Para instalaciones interactivas, estos errores aparecen en los mensajes de diálogo en la pantalla.
Opción A: usar el símbolo del sistema de Windows
En el símbolo del sistema de Windows, utiliza start /wait para mantener el terminal abierto hasta que finalice la instalación. A continuación, utiliza %ERRORLEVEL% para ver el código de salida del instalador.
Ejemplo: start /wait "" "AlteryxOne-1.0.359-US-setup.exe" /S /ALLUSERS devuelve el código de salida del instalador: %ERRORLEVEL%
Opción B: usar PowerShell
En PowerShell, utiliza Start-Process con los parámetros -Wait y -PassThru para esperar a que finalice el instalador y capturar el código de salida.
Ejemplo:
$process = Start-Process -FilePath "AlteryxOne-1.0.359-US-setup.exe" ` -ArgumentList "/S", "/ALLUSERS" ` -Wait ` -PassThru
$exitCode = $process.ExitCode
Write-Host "Código de salida del instalador: $exitCode"
if ($exitCode -ne 0) { throw "Falló la instalación con el código de salida $exitCode" }
Códigos de salida del instalador de Alteryx One
Código de salida | Clasificación | Significado y causa | Acción requerida |
|---|---|---|---|
0 | Correcto | La instalación o desinstalación se completó correctamente. | Ninguno |
1 | Cancelado por el usuario | El usuario canceló manualmente la instalación al hacer clic en Cancelar en la interfaz de usuario. | Vuelve a activar la instalación. |
2 | Ya se está ejecutando | Otra instancia del instalador de Alteryx One ya se está ejecutando. | Cierra cualquier otra instancia de configuración antes de volver a intentarlo. |
3 | Error de coincidencia de arquitectura | El sistema operativo no es Windows de 64 bits. | Instala en un sistema operativo Windows de 64 bits compatible. |
4 | Conflicto de instalación | Se detectó un conflicto entre los modos de instalación. Por ejemplo, instalar por máquina cuando ya existe una instancia por usuario, o instalar por usuario cuando ya existe una instancia por máquina. | Desinstala por completo el modo de instalación conflictivo antes de continuar. |
5 | Archivos bloqueados/procesos activos | Uno de los procesos de aplicación cruciales está activo actualmente: | Cierra Alteryx One y detiene el servicio de actualización y, a continuación, vuelve a ejecutar el instalador. |
6 | Se requieren privilegios elevados | El modo de instalación requiere derechos de administrador, y el usuario o shell actual no cuenta con privilegios elevados. Esto se aplica comúnmente a las instalaciones por máquina de | Ejecuta el símbolo del sistema, PowerShell o el script de implementación como administrador. |
Nota
Para implementaciones silenciosas que utilizan /S, monitorea los códigos de salida 4, 5 y 6. Estas son situaciones comunes de falla de implementación automatizada, como la instalación por máquina mientras aún existe una instancia por usuario o la ejecución del instalador mientras Alteryx One está activo.