.nh
.TH "GH-WORKFLOW-RUN" "1" "Sep 2026" "" "GitHub CLI manual"

.SH "نام (NAME)"
gh-workflow-run \- اجرای یک گردش‌کار با ایجاد رویداد workflow_dispatch


.SH "خلاصه دستور (SYNOPSIS)"
\fBgh workflow run [<workflow-id> | <workflow-name>] [flags]\fR


.SH "توضیحات (DESCRIPTION)"
ایجاد یک رویداد
\fBworkflow_dispatch\fR
برای یک گردش‌کار مشخص\&.

.PP
این دستور اقدام به راه‌اندازی GitHub Actions برای اجرای یک فایل گردش‌کار مشخص می‌کند\&. فایل گردش‌کار داده‌شده باید برای اجرا به این روش، از یک محرک
\fBon.workflow_dispatch\fR
پشتیبانی کند\&.

.PP
اگر فایل گردش‌کار از ورودی‌ها پشتیبانی کند، می‌توان آن‌ها را به چند روش تعیین کرد:
.IP \(bu 2
به‌صورت تعاملی
.IP \(bu 2
از طریق فلگ‌های
\fB-f/--raw-field\fR
یا
\fB-F/--field\fR
.IP \(bu 2
به‌صورت JSON، از طریق ورودی استاندارد

.PP
در صورت دردسترس بودن، نشانی اینترنتی (URL) اجرای گردش‌کارِ ایجادشده بازگردانده خواهد شد\&.


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB-F\fR, \fB--field\fR \fB<key=value>\fR
افزودن یک پارامتر رشته‌ای در قالب key=value، با رعایت نحو @ (به "gh help api" مراجعه کنید)\&.

.TP
\fB--json\fR
خواندن ورودی‌های گردش‌کار به‌صورت JSON از طریق STDIN

.TP
\fB-f\fR, \fB--raw-field\fR \fB<key=value>\fR
افزودن یک پارامتر رشته‌ای در قالب key=value

.TP
\fB-r\fR, \fB--ref\fR \fB<string>\fR
نام شاخه یا برچسبی (tag) که شامل نسخه‌ای از فایل گردش‌کار است که می‌خواهید اجرا کنید


.SH "گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)"
.TP
\fB-R\fR, \fB--repo\fR \fB<[HOST/]OWNER/REPO>\fR
انتخاب یک مخزن دیگر با استفاده از قالب [HOST/]OWNER/REPO


.SH "کدهای خروج (EXIT CODES)"
0: اجرای موفقیت‌آمیز

.PP
1: خطا

.PP
2: دستور لغو شد

.PP
4: نیاز به احراز هویت است

.PP
نکته: دستورات خاص ممکن است کدهای خروج دیگری نیز داشته باشند\&. برای اطلاعات بیشتر به راهنمای دستور مربوطه مراجعه کنید\&.


.SH "مثال‌ها (EXAMPLES)"
.EX
# درخواست gh از شما برای اینکه کدام گردش‌کار را می‌خواهید اجرا کنید و دریافت تعاملی ورودی‌ها
$ gh workflow run

# اجرای فایل گردش‌کار 'triage.yml' در شاخه پیش‌فرض ریموت
$ gh workflow run triage.yml

# اجرای فایل گردش‌کار 'triage.yml' در یک مرجع (ref) مشخص
$ gh workflow run triage.yml --ref my-branch

# اجرای فایل گردش‌کار 'triage.yml' با ورودی‌های خط فرمان
$ gh workflow run triage.yml -f name=scully -f greeting=hello

# اجرای فایل گردش‌کار 'triage.yml' با JSON از طریق ورودی استاندارد
$ echo '{"name":"scully", "greeting":"hello"}' | gh workflow run triage.yml --json

.EE


.SH "همچنین ببینید (SEE ALSO)"
\fBgh-workflow(1)\fR