# 授予迁移者角色

迁移者角色使用户或团队能够代表组织运行迁移。

若要允许除组织所有者以外的其他人运行迁移或下载迁移日志，可以向用户或团队授予迁移者角色。

若要使用 CLI 授予迁移者角色，可以使用 GL2GH extension of the GitHub CLI.

1. 安装 GitHub CLI。
   * 有关 GitHub CLI 的安装说明，请参阅 [GitHub CLI 存储库](https://github.com/cli/cli#installation)。
   * 如果已安装 GitHub CLI ，请运行 `gh --version` 以确保运行版本 2.4.0 或更高版本。 如果有较旧版本，请访问 [GitHub CLI 存储库](https://github.com/cli/cli#installation) 以获取升级说明。
1. 安装 GL2GH extension。

   ```shell copy
   gh extension install github/gh-gl2gh
   ```

1. 更新 GL2GH extension of the GitHub CLI 频率。 为了确保使用的是最新版本，请更新扩展。

    ```shell copy
    gh extension upgrade github/gh-gl2gh
    ```

1. 打开GitHub，创建并记录具有作用域的`admin:org`一个personal access token。
1. 将 personal access token 设置为环境变量，将以下命令中的 TOKEN 替换为你在上面记录的 personal access token。

   * 如果使用终端，请使用 `export` 命令。

      ```shell copy
      export GH_PAT="TOKEN"
      ```

   * 如果使用 PowerShell，请使用 `$env` 命令。

      ```shell copy
      $env:GH_PAT="TOKEN"
      ```
1. 使用 `gh gl2gh grant-migrator-role` 命令，将 ORGANIZATION 替换为你要为其授予迁移者角色的组织，将 ACTOR 替换为用户或团队名称，并将 TYPE 替换为 `USER` 或 `TEAM`。

   ```shell copy
   gh gl2gh grant-migrator-role --github-org ORGANIZATION --actor ACTOR --actor-type TYPE
   ```

   >[!NOTE] 如果要为其授予迁移程序角色 GHE.com，还必须包含企业子域的目标 API URL。 例如：`--target-api-url https://api.octocorp.ghe.com`。