用户

users 命令（别名 u）用于管理 Redmine 用户。所有写操作都需要管理员权限；非管理员的自助管理请使用 my-account。

list 按状态、名称或用户组过滤列出用户。

get 通过 ID、登录名或姓名查看单个用户。

me 显示当前已认证的用户。

create 创建新用户账户。

update 修改用户字段。

delete 移除用户账户。

list

redmine users list [flags]

标志	描述
--status	按状态过滤：active、registered、locked
--name	按姓名或登录名过滤
--group	按用户组名称或 ID 过滤
--limit	最大结果数
--offset	分页偏移量
-o, --output	输出格式

get

redmine users get <id-or-name> [flags]

别名：show、view。接受数字 ID、登录名、全名或 me。

标志	描述
--include	包含关联数据：memberships、groups（可重复或逗号分隔）。groups 需 Redmine 2.1+。
-o, --output	输出格式

me

redmine users me [flags]

显示当前已认证用户的详细信息——在脚本中用于解析当前账户非常实用。

标志	描述
--include	包含关联数据：memberships、groups（可重复或逗号分隔）。
-o, --output	输出格式

users me 与 my-account get 的区别

users me 调用 /users/current.json，返回的是其他管理员同样能看到的用户记录。my-account get 调用 /my/account.json，还会额外返回 API 密钥 和账户上的 自定义字段，是与可写自助命令 my-account update 配对的接口。

create

redmine users create [flags]

标志	描述
--login	登录名 — 必填
--password	密码 — 未设置 --generate-password 时必填
--firstname	名 — 必填
--lastname	姓 — 必填
--mail	邮箱地址 — 必填
--admin	授予管理员权限
--mail-notification	邮件通知偏好：all、only_my_events、only_assigned、only_owner、none
--must-change-passwd	强制用户在下次登录时修改密码
--generate-password	由服务器生成随机密码（可省略 --password）
--auth-source-id	外部认证源的数字 ID
--send-information	将账户信息通过邮件发送给新用户

命令行中的密码

在命令行中传入 --password 可能会将密码泄露至 shell 历史记录。建议使用 --generate-password 搭配 --send-information，或通过安全来源以管道方式传入密码。

update

redmine users update <id-or-name> [flags]

接受与 create 相同的标志（均为可选，--send-information 仅在 create 时可用）。用户参数接受数字 ID、登录名、全名或 me。仅显式设置的字段会发送到服务器，因此局部更新不会覆盖其他字段。

delete

危险操作

redmine users delete <id-or-name> [flags]

标志	描述
-f, --force	跳过确认提示