Alteryx One App 命令行安装指南
Alteryx One 安装程序支持命令行选项,可实现静默安装、企业部署和自动软件分发。本指南介绍了可用的选项、部署注意事项和安装程序退出代码。
注意
所有安装程序命令行标志都区分大小写。系统将忽略无效标志、拼写错误或大小写错误,且不返回任何错误消息。
默认安装(仅限当前用户):如果未提供任何命令行标志,安装程序将在默认位置执行仅限当前用户的安装:
%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 处于活跃状态时运行安装程序)。