# 移行者ロールの付与

移行者ロールは、組織に代わって移行を実行する機能をユーザーまたはチームに提供します。

Organization の所有者以外のユーザーが移行を実行したり、移行ログをダウンロードしたりできるようにするには、ユーザーまたはチームに移行者ロールを付与します。

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 を移行者ロールを付与する 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`)。