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

.SH "نام (NAME)"
gh-auth-status \- نمایش وضعیت احراز هویت


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


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

.PP
برای هر میزبان، وضعیت احراز هویت تمام حساب‌های شناخته‌شده بررسی می‌شود و هرگونه مشکل در خروجی گنجانده خواهد شد.
بخش مربوط به هر میزبان نشان‌دهنده حساب فعال خواهد بود؛ حسابی که هنگام کار با آن میزبان مورد استفاده قرار می‌گیرد.

.PP
اگر حسابی در هر میزبان (یا تنها میزبان ارائه‌شده از طریق
.BR \-\-hostname )
دارای مشکل احراز هویت باشد، این دستور با کد ۱ پایان یافته و خروجی را در
.B stderr
می‌نویسد. توجه داشته باشید که هنگام استفاده از گزینه
.BR \-\-json ،
دستور صرف‌نظر از هرگونه مشکل در احراز هویت، همواره با کد صفر پایان می‌یابد، مگر این‌که یک خطای مهلک رخ دهد.

.PP
برای تغییر دادن حساب کاربری فعال یک میزبان،
.B gh auth switch
را ببینید.


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-a\fR, \fB\-\-active\fR
تنها نمایش حساب فعال

.TP
\fB\-h\fR, \fB\-\-hostname\fR \fB<string>\fR
بررسی وضعیت احراز هویت تنها برای یک نام میزبان خاص

.TP
\fB\-\-jq\fR \fB<expression>\fR
فیلتر کردن خروجی JSON با استفاده از عبارت jq

.TP
\fB\-\-json\fR \fB<fields>\fR
تولید خروجی JSON با فیلدهای مشخص‌شده

.TP
\fB\-t\fR, \fB\-\-show-token\fR
نمایش توکن احراز هویت

.TP
\fB\-\-template\fR \fB<string>\fR
قالب‌بندی خروجی JSON با استفاده از یک الگوی Go؛ دستور "gh help formatting" را ببینید


.SH "فیلدهای JSON (JSON FIELDS)"
hosts


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

.PP
1: خطا

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

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

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


.SH "مثال‌ها (EXAMPLES)"
.EX
# نمایش وضعیت احراز هویت برای تمام حساب‌ها در تمام میزبان‌ها
$ gh auth status

# نمایش وضعیت احراز هویت برای حساب فعال در یک میزبان خاص
$ gh auth status --active --hostname github.example.com

# نمایش توکن‌ها به صورت متن ساده
$ gh auth status --show-token

# قالب‌بندی وضعیت احراز هویت به صورت JSON
$ gh auth status --json hosts

# گنجاندن توکن متنی ساده در خروجی JSON
$ gh auth status --json hosts --show-token

# قالب‌بندی میزبان‌ها به صورت یک آرایه مسطح JSON
$ gh auth status --json hosts --jq '.hosts | add'

.EE


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