# Concesión del rol de migrador

El rol de migración ofrece a un usuario o equipo la capacidad de ejecutar migraciones en nombre de una organización.

Para permitir que alguien que no sea propietario de la organización ejecute una migración o descargue registros de migración, puedes conceder el rol de migración a un usuario o equipo.

Para conceder el rol de migrador mediante la CLI, puede usar ADO2GH extension of the GitHub CLI.

1. Instale los GitHub CLI.
   * A fin de obtener instrucciones de instalación para GitHub CLI, vea el [repositorio de GitHub CLI](https://github.com/cli/cli#installation).
   * Si ya tiene GitHub CLI instalado, ejecute `gh --version` para asegurarse de que está ejecutando la versión 2.4.0 o posterior. Si tiene una versión anterior, visite el [GitHub CLI repositorio](https://github.com/cli/cli#installation) para obtener instrucciones de actualización.
1. Instale los ADO2GH extension.

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

1. ADO2GH extension of the GitHub CLI se actualiza semanalmente. Para asegurarte de que usas la versión más reciente, actualiza la extensión.

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

1. En GitHub, cree un personal access token que tenga el ámbito `admin:org` y regístrelo.
1. Establece personal access token como una variable de entorno, y reemplaza TOKEN en los comandos siguientes por el valor personal access token que has registrado antes.

   * Si usas Terminal, utiliza el comando `export`.

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

   * Si usas PowerShell, utiliza el comando `$env`.

      ```shell copy
      $env:GH_PAT="TOKEN"
      ```
1. Usa el comando `gh ado2gh grant-migrator-role`, y reemplaza ORGANIZATION por la organización a la que quieras conceder el rol de migración, ACTOR por el nombre de usuario o equipo, y TYPE por `USER` o `TEAM`.

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

   >[!NOTE] Si va a conceder el rol de migración para GHE.com, también debe incluir la dirección URL de la API de destino para el subdominio de la empresa. Por ejemplo: `--target-api-url https://api.octocorp.ghe.com`.