.nh
.TH "GH-AUTH-SWITCH" "1" "Sep 2026" "" "GitHub CLI manual"

.SH "نام (NAME)"
gh-auth-switch \- جابجایی بین حساب‌های احراز هویت شده


.SH "خلاصه دستور (SYNOPSIS)"
\fBgh auth switch [flags]\fR


.SH "توضیحات (DESCRIPTION)"
تغییر حساب کاربری فعال برای یک میزبان گیت‌هاب (GitHub host).

.PP
این دستور پیکربندی احراز هویتی را تغییر می‌دهد که هنگام اجرای دستورات برای میزبان مشخص‌شده گیت‌هاب استفاده خواهد شد.

.PP
اگر میزبان مشخص‌شده دارای دو حساب کاربری باشد، حساب فعال به‌طور خودکار تغییر می‌یابد. اگر بیش از دو حساب وجود داشته باشد، رفع ابهام از طریق گزینه
.B \-\-user
یا یک اعلان تعاملی لازم خواهد بود.

.PP
برای مشاهده فهرست حساب‌های احراز هویت شده می‌توانید دستور
.B gh auth status
را اجرا کنید.


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-h\fR, \fB\-\-hostname\fR \fB<string>\fR
نام میزبان (hostname) نمونه گیت‌هاب برای تغییر حساب آن

.TP
\fB\-u\fR, \fB\-\-user\fR \fB<string>\fR
حساب کاربری مورد نظر برای جابجایی به آن


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

.PP
1: خطا

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

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

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


.SH "مثال‌ها (EXAMPLES)"
.EX
# انتخاب میزبان و حساب کاربری برای تغییر از طریق اعلان تعاملی
$ gh auth switch

# تغییر حساب فعال در یک میزبان مشخص به یک کاربر خاص
$ gh auth switch --hostname enterprise.internal --user monalisa
.EE


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