# Gewährung der Migriererolle

Die Migrationsrolle gibt einem Benutzer oder Team die Möglichkeit, Migrationen im Auftrag einer Organisation auszuführen.

Um einer anderen Person als einer Organisationsbesitzer das Ausführen einer Migration oder das Herunterladen von Migrationsprotokollen zu ermöglichen, können einem Benutzer oder Team die Migrationsrolle zuweisen.

Um die Migrationsrolle mithilfe der CLI zu gewähren, können Sie die GL2GH extension of the GitHub CLI.

1. Installieren Sie GitHub CLI.
   * Installationsanweisungen für GitHub CLI findest du im [GitHub CLI-Repository](https://github.com/cli/cli#installation).
   * Wenn Sie GitHub CLI bereits installiert haben, führen Sie `gh --version` aus, um zu bestätigen, dass Sie Version 2.4.0 oder höher verwenden. Wenn Sie über eine ältere Version verfügen, besuchen Sie das [GitHub CLI Repository](https://github.com/cli/cli#installation) , um Upgradeanweisungen zu erhalten.
1. Installieren Sie GL2GH extension.

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

1. Die GL2GH extension of the GitHub CLI Aktualisierung erfolgt häufig. Aktualisieren die Erweiterung, um sicherzustellen, dass du die neueste Version verwendest.

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

1. Erstellen GitHubund aufzeichnen Sie ein personal access token Element, das den `admin:org` Bereich besitzt.
1. Lege das personal access token als Umgebungsvariable fest, und ersetze in den folgenden Befehlen TOKEN durch das personal access token, das du oben gespeichert hast.

   * Wenn du ein Terminal verwendest, führe den Befehl `export` aus.

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

   * Wenn du PowerShell verwendest, führe den Befehl `$env` aus.

      ```shell copy
      $env:GH_PAT="TOKEN"
      ```
1. Verwende den Befehl `gh gl2gh grant-migrator-role`, und ersetze ORGANIZATION durch die Organisation, der du die Migrationsrolle zuweisen möchtest, ACTOR durch den Benutzer- oder Teamnamen und TYPE durch `USER` oder `TEAM`.

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

   >[!NOTE] Wenn Sie die Migrationsrolle gewähren GHE.com, müssen Sie auch die Ziel-API-URL für die Unterdomäne Ihres Unternehmens einschließen. Beispiel: `--target-api-url https://api.octocorp.ghe.com`