Alteryx One App 命令行安装指南
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.
注意
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.
注意
所有安装程序命令行标志都区分大小写。系统将忽略无效标志、拼写错误或大小写错误，且不返回任何错误消息。
默认安装（仅限当前用户）：如果未提供任何命令行标志，安装程序将在默认位置执行仅限当前用户的安装：
%LOCALAPPDATA%\Alteryx\AlteryxOne例如：
AlteryxOne-1.0.352-US-setup.exe/ALLUSERS：使用此标志为计算机上的所有用户安装 Alteryx One App（针对所有用户的安装模式）。默认安装位置：
C:\Program Files\Alteryx\AlteryxOne例如：
AlteryxOne-1.0.352-US-setup.exe /ALLUSERS
/S：使用此标志以静默模式运行安装程序。使用该标志时，安装程序不会显示交互式安装界面，并将接受所有默认设置，除非通过其他受支持的标志进行修改。示例：AlteryxOne-1.0.352-US-setup.exe /SAlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS
/NOAUTOLAUNCH：使用此标志以防止 Alteryx One App 在安装后自动启动。此选项仅支持静默安装 (/S)。示例：
AlteryxOne-1.0.352-US-setup.exe /S /NOAUTOLAUNCHAlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS /NOAUTOLAUNCH
/D=<path>：使用此标志指定自定义安装目录。要求和限制：
仅支持针对所有用户安装模式的静默安装。
仅支持针对所有用户的安装；不支持针对仅限当前用户安装的自定义位置。
安装程序会自动将“AlteryxOne”子文件夹附加到指定的位置。
/D=C:\temp\Alteryx安装到C:\temp\Alteryx\AlteryxOne。/D=C:\temp\AlteryxOne安装到C:\temp\AlteryxOne\AlteryxOne。示例：
AlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS /D=C:\path\to\installLocation安装到：
C:\InstallLocation\AlteryxOne包含空格的路径示例：
AlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS /D=C:\Program Files\CustomLocation安装到：
C:\Program Files\CustomLocation\AlteryxOne
/D=标志的重要注意事项：/D=<path>参数必须是命令中的最后一个参数。出现在/D=之后的任何文本都将被解析为安装路径的一部分，而不是作为附加的安装程序标志。例如，以下命令：
AlteryxOne-1.0.359-US-setup.exe /ALLUSERS /D=C:\temp\Alteryx /S /NOAUTOLAUNCH将安装到C:\temp\Alteryx S NOAUTOLAUNCH。为了避免出现异常的安装路径，请始终将
/D=作为最后一个参数：AlteryxOne-1.0.359-US-setup.exe /S /ALLUSERS /NOAUTOLAUNCH /D=C:\temp\Alteryx。请勿使用双引号将使用
/D=指定的路径括起来。如果使用了双引号，安装程序将忽略/D=参数，并安装到所选安装类型的默认位置。例如：
AlteryxOne-1.0.359-US-setup.exe /ALLUSERS /D="C:\temp\Alteryx"结果：系统会忽略
/D=参数，且应用程序会安装到：C:\Program Files\Alteryx\AlteryxOne
注意
不支持或组合错误的标志不会返回错误消息。根据标志，安装程序可能会忽略不受支持的选项，或以与预期不同的方式解析命令。对于自定义安装路径，请始终确保 /D= 是最后一个参数。此外，请勿使用双引号将使用 /D= 指定的路径括起来。
在使用静默安装部署 Alteryx One 时捕获错误代码
静默安装会返回退出代码，IT 管理员可利用这些代码来确定安装是否已成功完成或失败。
这适用于仅限当前用户和针对所有用户安装模式的静默安装。对于交互式安装，这些错误将以屏幕弹出的对话框消息形式呈现。
方法 A：使用 Windows 命令提示符
在 Windows 命令提示符中，可使用 start /wait 保持终端窗口处于打开状态，直至安装程序运行结束。然后，使用 %ERRORLEVEL% 查看安装程序的退出代码。
Example: start /wait "" "AlteryxOne-1.0.359-US-setup.exe" /S /ALLUSERS echo Installer Exit Code: %ERRORLEVEL%
方法 B：使用 PowerShell
在 PowerShell 中，使用带有 -Wait 和 -PassThru 参数的 Start-Process，以等待安装程序完成并捕获退出代码。
示例：
$process = Start-Process -FilePath "AlteryxOne-1.0.359-US-setup.exe" ` -ArgumentList "/S", "/ALLUSERS" ` -Wait ` -PassThru
$exitCode = $process.ExitCode
Write-Host "Installer Exit Code: $exitCode"
if ($exitCode -ne 0) { throw "Installation failed with exit code $exitCode" }
Alteryx One 安装程序退出代码
退出代码 | 分类 | 含义与原因 | 需要采取行动 |
|---|---|---|---|
0 | 成功 | 安装或卸载已成功完成。 | 无 |
1 | 用户中止 | 用户在 UI 中单击了取消，手动取消了该安装。 | 重新触发安装。 |
2 | 已在运行 | Alteryx One 安装程序的另一个实例已在运行。 | 请在重试之前，关闭任何其他处于开启状态的安装程序。 |
3 | 系统架构不匹配 | 操作系统并非 64 位 Windows。 | 请在受支持的 64 位 Windows 操作系统上进行安装。 |
4 | 安装冲突 | 系统检测到不同的安装模式之间存在冲突。例如，在已存在“仅限当前用户”实例的情况下安装“针对所有用户”模式，或者在已存在“针对所有用户”实例的情况下安装“仅限当前用户”模式。 | 请先完全卸载冲突的安装模式，然后再继续操作。 |
5 | 锁定的文件或进程处于活跃状态 | 其中一个关键应用程序进程当前处于活跃状态： | 请关闭 Alteryx One 并停止更新程序服务，然后重新运行安装程序。 |
6 | 需要提升权限 | 该安装模式需要管理员权限，且当前用户或 Shell 未提升权限。这通常适用于使用 | 请以管理员身份运行命令提示符、PowerShell 或部署脚本。 |
注意
对于使用 /S 的静默部署，请监视退出代码 4、5 和 6。这些是常见的自动化部署失败场景（例如在仍存在“仅限当前用户”实例的情况下推送“针对所有用户”安装模式，或在 Alteryx One 处于活跃状态时运行安装程序）。