> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 用 CLI 管理 workspace 成员

> 用 squarecloud workspace member 通过一次性邀请码邀请成员加入 Square Cloud workspace，更改其权限组或将其移除。

成员通过自己生成的邀请码加入 workspace：

<Steps>
  <Step title="新成员生成邀请码">
    想要加入的人运行 `squarecloud workspace member invite-code`，并把邀请码发给 workspace 拥有者。邀请码只能使用一次，5 分钟后过期。
  </Step>

  <Step title="拥有者添加成员">
    拥有者运行 `squarecloud workspace member add`，传入 workspace ID、邀请码和权限组。
  </Step>
</Steps>

## 权限组

`<group>` 为以下之一：

| 权限组 | 成员可以做什么 |
| - | - |
| `admin` | 完全控制共享的应用，包括环境变量、snapshot、自定义域名和部署设置。 |
| `maintain` | 日常运维：commit，启动、停止和重启，文件，DNS 以及清除缓存。 |
| `manager` | 监控和控制：启动、停止和重启，以及查看部署信息。不能 commit，不能修改文件或网络设置。 |
| `view` | 只读。 |

拥有者自己的权限组是 `owner`，它不能分配给其他人。有关 [workspace 权限](https://help.squarecloud.app/en-us/article/workspace-permissions-collaborators-12ahei1/)的更多信息，请参阅帮助中心。

## `squarecloud workspace member invite-code`

```bash 用法 theme={"system"}
squarecloud workspace member invite-code
```

生成你自己的一次性邀请码，有效期为 5 分钟。

```bash 输出 theme={"system"}
Your invite code (single-use, valid for 5 minutes):
  <inviteCode>
```

## `squarecloud workspace member add`

```bash 用法 theme={"system"}
squarecloud workspace member add <workspaceID> <inviteCode> <group>
```

把生成 `<inviteCode>` 的人以指定的权限组添加到 workspace。只有 workspace 拥有者可以添加成员，数量上限取决于拥有者套餐的成员限制。

```bash theme={"system"}
squarecloud workspace member add <workspaceID> <inviteCode> maintain
```

## `squarecloud workspace member update`

```bash 用法 theme={"system"}
squarecloud workspace member update <workspaceID> <memberID> <group>
```

更改成员的权限组。成员 ID 可从 [`workspace info`](/zh/cli-reference/workspaces#squarecloud-workspace-info) 中获取。

## `squarecloud workspace member remove`

```bash 用法 theme={"system"}
squarecloud workspace member remove <workspaceID> <memberID> [-y]
```

| 标志 | 说明 |
| - | - |
| `-y`, `--yes` | 跳过确认提示。 |

在 `y/N` 确认后，从 workspace 中移除一名成员。只有 workspace 拥有者可以移除成员。要自己退出 workspace，请使用 [`workspace leave`](/zh/cli-reference/workspaces#squarecloud-workspace-leave)。

## 相关内容

| 命令 | API | JavaScript SDK | VS Code |
| - | - | - | - |
| `invite-code` | [`GET .../members/code`](/zh/api-reference/endpoint/workspace/members/code) | [`api.workspaces.members.inviteCode()`](/zh/sdks/js/workspaces) | [复制我的邀请代码](/zh/vscode-extension/features#workspace) |
| `add` | [`POST .../members`](/zh/api-reference/endpoint/workspace/members/invite) | [`api.workspaces.members.add()`](/zh/sdks/js/workspaces) | |
| `update` | [`PATCH .../members`](/zh/api-reference/endpoint/workspace/members/perms) | [`api.workspaces.members.update()`](/zh/sdks/js/workspaces) | |
| `remove` | [`DELETE .../members`](/zh/api-reference/endpoint/workspace/members/kick) | [`api.workspaces.members.remove()`](/zh/sdks/js/workspaces) | |