管理作业

作业在 TeamCity 中表示构建配置。 teamcity job 命令组可让你列出和视图构建配置，暂停和恢复它们，并管理它们的参数。

列出作业

视图所有构建配置：

teamcity job list

根据项目筛选器筛选：

teamcity job list --project MyProject

限制结果数量：

teamcity job list --limit 20

以 JSON 格式输出：

teamcity job list --json
teamcity job list --json=id,name,projectName,webUrl

标志	描述
`-p`， `--项目`	根据项目 ID 筛选器筛选
`-n`， `--limit`	要显示的最大作业数量
`--json`	输出为 JSON。使用 `--json=` 可列出可用字段， `--json=f1,f2` 可查看指定字段。

视图构建配置详情：

teamcity job view MyProject_Build

在浏览器中打开作业页面：

teamcity job view MyProject_Build --web

以 JSON 格式输出：

teamcity job view MyProject_Build --json

可视化作业的快照依赖项链。默认情况下，树状图同时显示后续触发的作业（此作业执行后触发的内容）和依赖项（此作业执行前必须运行的内容）：

teamcity job tree MyProject_DeployStaging

仅显示一个方向：

teamcity job tree MyProject_Build --only dependents
teamcity job tree MyProject_Deploy --only dependencies

限制树的深度：

teamcity job tree MyProject_Build --depth 2

标志	描述
`-d`， `--depth`	限制树深度（0 = 不限）
`--only`	仅显示 `dependents` 或 `dependencies`

暂停作业以防止新构建被触发：

teamcity job pause MyProject_Build

恢复已暂停的作业以允许新构建：

teamcity job resume MyProject_Build

视图作业上定义的所有参数：

teamcity job param list MyProject_Build
teamcity job param list MyProject_Build --json

获取指定参数的值：

teamcity job param get MyProject_Build VERSION
teamcity job param get MyProject_Build env.JAVA_HOME

设置或更新参数值：

teamcity job param set MyProject_Build VERSION "2.0.0"

要将参数标记为安全（密码字段），请使用 --secure 标志。安全参数的值会在 web 接口和构建日志中被隐藏：

teamcity job param set MyProject_Build SECRET_KEY "my-secret-value" --secure

从作业中移除参数：

teamcity job param delete MyProject_Build MY_PARAM

2026年 8月 6日