IBConsole 命令行选项
命令行选项
下表介绍 IBConsole.exe 命令行选项：
| 选项 | 功能 | 备注 |
|---|---|---|
| @ | 指定包含 IBConsole 命令行的响应文件。 | 当运行 IBMConsole 的命令行太长而无法在脚本中明确指定时，可使用此选项。 |
| /Attach | 显示当前或最后一个构建的构建输出。 | 如果机器上当前正在运行一个构建，则显示到该点的构建输出，并继续显示进程输出，直到结束。如果未运行构建，则 IBConsole 显示从该机器启动的最后一个构建的整个构建输出。 |
| /AvoidLocal=[On/Off] | 覆盖 Agent Settings 对话框中的 Avoid task execution on local machine when possible 选项。 | 必须设定一个值（ON 或 OFF）。 |
| /Beep | 进程结束时播放声音。 | |
|
/buildcachelocal=[ON|OFF] |
覆盖定义是否在此 Initiator 上启用本地 Build Cache 的设置。 |
|
|
/buildcacheremoteserver=[ip address:port] |
使用与 Agent Settings 中定义的构建缓存端点不同的构建缓存端点。还必须指定端口。示例：/buildcacheremoteserver=192.5.8.1:50222 |
|
| /Disable | 禁用 Incredibuild Agent 作为 Helper 参与。 | |
| /Enable | 启用 Incredibuild Agent 作为 Helper 参与。 | |
| /Help | 显示使用帮助和版本信息。 | |
| /Log[=filename] | 将进程输出写入文件。 | 如果未指定文件名，则在当前目录创建一个名为 Ib_<target-name>.log 的文件。 |
| /LogLevel="<Level>" | 覆盖该构建的日志记录级别。 | “<Level>”可以是以下选项之一：Minimal、Basic、Intermediate、Extended、Detailed。 |
| /MaxCPUS=<n> | 在构建设置中覆盖全局最大 CPU/内核。 | |
| /MaxWinVer="<Version>" | 指定分配到此构建的远端 Agent 所需的最新操作系统。 | 具有较新操作系统的 Agent 将不会被分配给此构建。可用值包括：XP、2003、VISTA、2008、7、8 以及 10。 |
| /MinWinVer="<Version>" | 指定分配给此构建的远程 Agent 所需的最低操作系统。 | 具有较旧操作系统的 Agent 将不会被分配给此构建。可用值包括：XP、2003、VISTA、2008、7、8 以及 10。 |
| /Mon[=filename] | 将构建进程（.ib_mon）文件的副本写入指定位置。 |
- 如果只给出文件夹名称，Incredibuild 会为文件名生成一个 GUID。 - 进程输出的末尾将添加一条含有已保存的 .ib_mon 文件位置的消息。 |
| /NO_DOTNET_VIRT | 在 Helper 机器上禁用 .NET 环境虚拟化。 | 在命令行中指定此交换机时，该交换机将向 Incredibuild 发出指令，不允许将 Initiator 机器的 .NET 环境虚拟化为 Helper 机器。添加此交换机是为了解决混合 OS 环境中的 .NET 不兼容问题。 |
| /NoLogo | 抑制构建输出中所含“Incredibuild”标头。 | |
| /NoWait | 指定后，如果此 Agent 启动的另一个进程已在运行，IBConsole 将退出并显示“Another build already running”消息。 | |
| /OpenMonitor | 打开显示执行进程的 Build Monitor 窗口。 | |
| /out=filename | 将整个命令行输出重新定向到一个文件。 | |
| /QueryLicense | 显示有关有效许可证、已分配程序包和维护到期日的信息。 | |
| /Reset | 清除 Agent 的文件缓存内容。 | |
| /SetEnv="<name>=<value>" | 设置或覆盖命令执行上下文的环境变量。 | 可多次使用 /SetEnv 来设置/覆盖多个变量。 |
| /ShowAgent | 显示用于每个任务执行的 Agent。 | |
| /ShowCmd | 显示每个执行的任务，Incredibuild 执行任务使用的 command-line。 | 仅用于 XML Interface。 |
| /ShowTime | 显示每个任务的开始和结束时间。 | |
| /Silent | 不向标准输出写入任何内容。 | 默认行为是写入构建结果，如 Build Monitor's Output 显示器所示。 |
| /Stop[=<build-id>] | 停止当前在本地机器上运行的构建。如果多于一个构建正在运行，请提供 <build-id>。 | 构建被停止时，IBConsole 将返回代码 3。如果使用了 /stop 且当前无构建运行，则返回代码 2。 |
| /StopOnErrors | 进行指定后，只要发生错误就会停止执行。 | |
|
/StopAll |
停止所有当前正在运行的构建。 |
|
| /Title=<build title> | 指定将显示在 Execution 输出文本开头的自定义标题行。该标题还将用于 Execution History 和 Execution Monitor 显示。 | 可用引号将值括入。 |
|
/UseCloudHelpers |
启用 Cloud Helpers 时，此设置可以确定其是否用于协助当前构建。默认情况下，该值为 True。为防止 Cloud Helpers 协助构建，请设置 /UseCloudHelpers=false.。 |
|
| /UseIDEMonitor | 当使用此选项从 Visual Studio IDE 运行 IBConsole 时，集成的 IDE Execution Monitor 将显示执行进度。 | |
| /Wait | 如果当前正在运行此 Agent 启动的另一个进程，请等待该进程完成，然后启动新进程。此亦为默认行为。 | |
|
/rootTaskAware |
启用后，无论某些任务是否出错，都会将构建状态从构建系统继承到 Incredibuild。如果某些任务出现错误，但构建已成功完成，则构建状态在 Build Monitor 构建监视器中显示为橙色。 |
默认已禁用。设置 /rootTaskAware=1 以启用 |
Return Codes
IBConsole 返回下列返回码：
-
0 – 构建成功且没有出现错误
-
1 – 由于与 Incredibuild 无关的错误（例如编译错误），构建失败。
-
2 – 通过用户请求取消构建
-
3 – 由于 Incredibuild 系统错误构建失败
备注：
-
在给定时刻，一台机器上只能运行一次 IBConsole 执行。因此，在当前运行的构建完成和新构建开始运行之间会出现暂停。