{"meta":{"title":"Manuelles Ausführen eines Workflows","intro":"Wenn ein Workflow für die Ausführung auf dem workflow_dispatch Ereignis konfiguriert ist, können Sie den Workflow mithilfe der Registerkarte \"Aktionen\" auf GitHub, GitHub CLIoder der REST-API ausführen.","product":"GitHub Actions","breadcrumbs":[{"href":"/de/actions","title":"GitHub Actions"},{"href":"/de/actions/how-tos","title":"Anleitungen"},{"href":"/de/actions/how-tos/manage-workflow-runs","title":"Workflow-Läufe verwalten"},{"href":"/de/actions/how-tos/manage-workflow-runs/manually-run-a-workflow","title":"Manuelles Ausführen eines Workflows"}],"documentType":"article"},"body":"# Manuelles Ausführen eines Workflows\n\nWenn ein Workflow für die Ausführung auf dem workflow_dispatch Ereignis konfiguriert ist, können Sie den Workflow mithilfe der Registerkarte \"Aktionen\" auf GitHub, GitHub CLIoder der REST-API ausführen.\n\n## Konfigurieren eines Workflows zur manuellen Ausführung\n\nUm einen Workflow manuell auszuführen, muss der Workflow so konfiguriert sein, dass er auf dem `workflow_dispatch`-Ereignis ausgeführt wird.\n\nUm das `workflow_dispatch`-Ereignis auszulösen, muss sich dein Workflow im Standardbranch befinden. Weitere Informationen zum Konfigurieren des `workflow_dispatch`-Ereignisses findest du unter [Ereignisse zum Auslösen von Workflows](/de/actions/reference/workflows-and-actions/events-that-trigger-workflows#workflow_dispatch).\n\nUm diese Schritte auszuführen, ist Schreibzugriff auf das Repository erforderlich.\n\n## Ausführen eines Workflows\n\n<div class=\"ghd-tool webui\">\n\n1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.\n\n2. Klicke unter dem Repositorynamen auf **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-play\" aria-label=\"play\" role=\"img\"><path d=\"M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Zm4.879-2.773 4.264 2.559a.25.25 0 0 1 0 .428l-4.264 2.559A.25.25 0 0 1 6 10.559V5.442a.25.25 0 0 1 .379-.215Z\"></path></svg> Actions**.\n\n   ![Screenshot: Registerkarten für das Repository „github/docs“. Die Registerkarte „Aktionen“ ist mit einem orangefarbenen Rahmen hervorgehoben.](/assets/images/help/repository/actions-tab-global-nav-update.png)\n\n3. Klicke auf der linken Randleiste auf den Namen des Workflows, den du ausführen möchtest.\n\n   ![Screenshot: Seite „Actions“. Auf der linken Randleiste wird ein Workflowname durch einen dunkelorangefarbenen Rahmen hervorgehoben.](/assets/images/help/repository/actions-select-workflow-2022.png)\n\n4. Klicken Sie über der Liste der Workflowausführungen auf die Schaltfläche **Workflow starten**.\n\n   > \\[!NOTE]\n   > Damit die Schaltfläche **Run workflow** angezeigt wird, muss deine Workflowdatei den Ereignistrigger `workflow_dispatch` verwenden. Nur Workflowdateien, die den `workflow_dispatch`-Ereignisauslöser verwenden, haben die Möglichkeit, den Workflow manuell mithilfe der Schaltfläche **Workflow ausführen** auszuführen. Weitere Informationen zum Konfigurieren des `workflow_dispatch`-Ereignisses findest du unter [Ereignisse zum Auslösen von Workflows](/de/actions/reference/workflows-and-actions/events-that-trigger-workflows#workflow_dispatch).\n\n   ![Screenshot einer Workflowseite. Über der Liste der Workflowausführungen ist eine Schaltfläche mit der Beschriftung „Workflow ausführen“ in dunklem Orange eingerahmt.](/assets/images/help/actions/actions-workflow-dispatch.png)\n\n5. Wähle das Dropdownmenü **Branch** aus, und klicke auf einen Branch, für den der Workflow ausgeführt werden soll.\n\n6. Wenn der Workflow eine Eingabe erfordert, fülle die Felder aus.\n\n7. Klicke auf **Workflow ausführen**.\n\n</div>\n\n<div class=\"ghd-tool cli\">\n\n> \\[!NOTE]\n> Weitere Informationen zur GitHub CLI findest du unter [Informationen zu GitHub CLI](/de/github-cli/github-cli/about-github-cli).\n\nUm einen Workflow auszuführen, verwende den Unterbefehl `workflow run`. Ersetze den `workflow`-Parameter durch den Namen, die ID oder den Dateinamen des Workflows, den du ausführen möchtest. Beispiel: `\"Link Checker\"`, `1234567` oder `\"link-check-test.yml\"`. Wenn Sie keinen Workflow angeben, wird ein interaktives Menü zurückgegeben, GitHub CLI in dem Sie einen Workflow auswählen können.\n\n```shell\ngh workflow run WORKFLOW\n```\n\nWenn Ihr Workflow Eingaben akzeptiert, werden Sie aufgefordert, GitHub CLI sie einzugeben. Alternativ kannst du mit `-f` oder `-F` eine Eingabe im `key=value`-Format hinzufügen. Verwenden Sie `-F`, um aus einer Datei zu lesen.\n\n```shell\ngh workflow run greet.yml -f name=mona -f greeting=hello -F data=@myfile.txt\n```\n\nDu kannst Eingaben auch im JSON-Format übergeben, indem du die Standardeingabe verwendest.\n\n```shell\necho '{\"name\":\"mona\", \"greeting\":\"hello\"}' | gh workflow run greet.yml --json\n```\n\nUm einen Workflow auf einem anderen Branch als dem Standardbranch des Repositorys auszuführen, verwende das `--ref`-Flag.\n\n```shell\ngh workflow run WORKFLOW --ref BRANCH\n```\n\nUm den Fortschritt der Workflowausführung anzuzeigen, verwende den Unterbefehl `run watch`, und wähle die Ausführung in der interaktiven Liste aus.\n\n```shell\ngh run watch\n```\n\n</div>\n\n## Ausführen eines Workflows mithilfe der REST-API\n\nWenn du die REST-API verwendest, konfiguriere `inputs` und `ref` als Anforderungstextparameter. Wenn die Eingaben weggelassen werden, werden die in der Workflowdatei definierten Standardwerte verwendet.\n\n> \\[!NOTE]\n> Sie können bis zu 25 `inputs`für ein `workflow_dispatch` Ereignis definieren.\n\nWeitere Informationen zum Verwenden der REST-API findest du unter [REST-API-Endpunkte für Workflows](/de/rest/actions/workflows#create-a-workflow-dispatch-event)."}