命令参考

本页为所有可用 TeamCity CLI 命令提供快捷参考。每个命令组都链接到包含完整描述、标志和示例的详细页面。

身份验证

管理服务器认证。参见 Authentication 以获取详细信息。

命令	描述
`teamcity auth login`	与 TeamCity 服务器进行认证
`teamcity auth logout`	从 TeamCity 服务器登出
`teamcity auth status`	显示认证状态

运行

启动、监控和管理构建。参见 Managing runs 以获取详细信息。

命令	描述
`teamcity run artifacts`	列出工件
`teamcity run cancel`	取消运行
`teamcity run changes`	显示 VCS 变更
`teamcity run comment`	设置或视图注释
`teamcity run diff`	对比两次运行并显示差异
`teamcity run download`	下载工件
`teamcity run list`	列出最近的运行
`teamcity run log`	视图日志
`teamcity run pin`	固定以防止清理
`teamcity run restart`	重启运行
`teamcity run start`	启动新运行
`teamcity run tag`	添加标记
`teamcity run tests`	显示测试结果
`teamcity run tree`	显示快照依赖项树
`teamcity run unpin`	取消固定运行
`teamcity run untag`	移除标记
`teamcity run view`	视图详细信息
`teamcity run watch`	监视运行直到完成

作业

视图和配置构建配置。参见 Managing jobs 以获取详细信息。

命令	描述
`teamcity job list`	列出作业
`teamcity job param delete`	删除作业参数
`teamcity job param get`	获取作业参数值
`teamcity job param list`	列出作业参数
`teamcity job param set`	设置作业参数值
`teamcity job pause`	暂停作业
`teamcity job resume`	恢复已暂停的作业
`teamcity job tree`	显示快照依赖项树
`teamcity job view`	视图作业详细信息

项目

浏览项目并管理参数和设置。参见 Managing projects 以获取详细信息。

命令	描述
`teamcity project cloud image`	管理云镜像
`teamcity project cloud instance`	管理云实例
`teamcity project cloud profile`	管理云配置文件
`teamcity project connection authorize`	打开浏览器，以当前 TeamCity 用户身份对连接进行授权
`teamcity project connection create`	创建项目连接
`teamcity project connection delete`	删除项目连接
`teamcity project connection list`	列出项目连接
`teamcity project create`	创建项目
`teamcity project list`	列出项目
`teamcity project param delete`	删除项目参数
`teamcity project param get`	获取项目参数值
`teamcity project param list`	列出项目参数
`teamcity project param set`	设置项目参数值
`teamcity project settings export`	将项目设置导出为 Kotlin DSL 或 XML
`teamcity project settings status`	显示版本化设置同步状态
`teamcity project settings validate`	在本地验证 Kotlin DSL 配置
`teamcity project ssh delete`	删除 SSH 密钥
`teamcity project ssh generate`	生成 SSH 密钥对
`teamcity project ssh list`	列出 SSH 密钥
`teamcity project ssh upload`	上传 SSH 私有密钥
`teamcity project token get`	获取安全令牌的值
`teamcity project token put`	存储密钥并获取安全令牌
`teamcity project tree`	以树形显示项目层次结构
`teamcity project vcs create`	创建 VCS 根
`teamcity project vcs delete`	删除 VCS 根
`teamcity project vcs list`	列出 VCS 根
`teamcity project vcs test`	测试 VCS 根连接
`teamcity project vcs view`	视图 VCS 根详细信息
`teamcity project view`	视图项目详细信息

队列

管理构建队列。参见 Managing the build queue 以获取详细信息。

命令	描述
`teamcity queue approve`	批准排队运行
`teamcity queue list`	列出排队运行
`teamcity queue remove`	从队列中移除运行
`teamcity queue top`	将运行移至队列顶部

支持人员

监控和控制构建代理。参见 Managing agents 以获取详细信息。

命令	描述
`teamcity agent authorize`	授权代理
`teamcity agent deauthorize`	取消授权代理
`teamcity agent disable`	禁用代理
`teamcity agent enable`	启用代理
`teamcity agent exec`	在代理上执行命令
`teamcity agent jobs`	显示代理可运行的作业
`teamcity agent list`	列出构建代理
`teamcity agent move`	将代理移动到其他池
`teamcity agent reboot`	重启代理
`teamcity agent term`	打开与代理的交互式终端
`teamcity agent view`	查看代理详细信息

代理池

管理代理池赋值。参见 Managing agent pools 以获取详细信息。

命令	描述
`teamcity pool link`	将项目关联到代理池
`teamcity pool list`	列出代理池
`teamcity pool unlink`	将项目从代理池解除关联
`teamcity pool view`	视图池详细信息

API},{

发起原始 REST API 请求。参见 REST API access 以获取详细信息。

命令	描述
`teamcity api <endpoint>`	发起已认证的 API 请求

别名

创建自定义命令快捷键。参见 Aliases 以获取详细信息。

命令	描述
`teamcity alias delete`	删除别名
`teamcity alias list`	列出已配置的别名
`teamcity alias set`	创建命令别名

配置

命令	描述
`teamcity config get`	获取配置值
`teamcity config list`	列出配置信息
`teamcity config set`	设置配置值

关联

命令	描述
`teamcity link`	将此仓库绑定到 TeamCity 项目

Pipelines

命令	描述
`teamcity pipeline create`	从 YAML 创建新流水线
`teamcity pipeline delete`	删除流水线
`teamcity pipeline list`	列出流水线
`teamcity pipeline pull`	下载流水线 YAML
`teamcity pipeline push`	上传流水线 YAML
`teamcity pipeline schema`	打印当前服务器的流水线 JSON 架构
`teamcity pipeline validate`	根据服务器架构校验流水线 YAML
`teamcity pipeline view`	视图流水线详细信息

技能

管理 AI 代理集成。参见 AI agent integration 以获取详细信息。

命令	描述
`teamcity skill install`	为 AI 编码代理安装技能
`teamcity skill list`	列出本版本捆绑的可用技能
`teamcity skill remove`	从 AI 编码代理移除技能
`teamcity skill update`	为 AI 编码代理更新技能

更新

命令	描述
`teamcity update`	检查 CLI 更新

2026年 8月 6日