# 移行者ロールの付与

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

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

CLI を使用して移行者ロールを付与するには、ADO2GH 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. ADO2GH extensionをインストールします。

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

1. ADO2GH extension of the GitHub CLIは毎週更新されます。 最新バージョンを確実に使うため、拡張機能を更新してください。

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

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 ado2gh grant-migrator-role` コマンドを使って、ORGANIZATION を移行者ロールを付与する Organization に、ACTOR をユーザーまたはチーム名に、TYPE を `USER` または `TEAM` に置き換えます。

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

   >[!NOTE] 
   GHE.comの移行者ロールを付与する場合は、企業のサブドメインのターゲット API URL も含める必要があります。 (例: `--target-api-url https://api.octocorp.ghe.com`)。