Skip to main content

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 /S

    • AlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS

  • /NOAUTOLAUNCH:使用此标志以防止 Alteryx One App 在安装后自动启动。此选项仅支持静默安装 (/S)。

    示例:

    • AlteryxOne-1.0.352-US-setup.exe /S /NOAUTOLAUNCH

    • AlteryxOne-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

锁定的文件或进程处于活跃状态

其中一个关键应用程序进程当前处于活跃状态:AlteryxOne.exeupdate-helper.exe

请关闭 Alteryx One 并停止更新程序服务,然后重新运行安装程序。

6

需要提升权限

该安装模式需要管理员权限,且当前用户或 Shell 未提升权限。这通常适用于使用 /ALLUSERS 参数的针对所有用户的安装模式。

请以管理员身份运行命令提示符、PowerShell 或部署脚本。

注意

对于使用 /S 的静默部署,请监视退出代码 4、5 和 6。这些是常见的自动化部署失败场景(例如在仍存在“仅限当前用户”实例的情况下推送“针对所有用户”安装模式,或在 Alteryx One 处于活跃状态时运行安装程序)。