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

.SH "نام (NAME)"
gh-auth-refresh \- به‌روزرسانی توکن‌های احراز هویت


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


.SH "توضیحات (DESCRIPTION)"
گسترش یا اصلاح دامنه‌های دسترسی (scopes) برای اعتبارنامه‌های ذخیره‌شده حساب فعال.

.PP
گزینه
.B \-\-scopes
فهرستی از دامنه‌های جداشده با کاما را می‌پذیرد که می‌خواهید اعتبارنامه‌های
.B gh
شما داشته باشند. در صورت عدم ارائه دامنه‌ها، این دستور دامنه‌های اضافه‌شده قبلی را حفظ می‌کند.

.PP
گزینه
.B \-\-remove\-scopes
فهرستی از دامنه‌های جداشده با کاما را می‌پذیرد که می‌خواهید از اعتبارنامه‌های
.B gh
خود حذف نمایید. حذف دامنه‌ها بدون اثر جانبی تکرار (idempotent) است. حداقل مجموعه دامنه‌ها (شامل
.BR repo ،
.B read:org
و
.BR gist )
را نمی‌توان حذف کرد.

.PP
گزینه
.B \-\-reset\-scopes
دامنه‌های اعتبارنامه‌های
.B gh
شما را به مجموعه پیش‌فرض دامنه‌ها برای جریان احراز هویت شما بازنشانی می‌کند.

.PP
اگر چندین حساب کاربری در
.B gh auth status
دارید و می‌خواهید اعتبارنامه‌های یک حساب غیرفعال را به‌روزرسانی کنید، باید ابتدا با
.B gh auth switch
به آن حساب بروید و پس از اتمام کار با این دستور، مجدداً به حساب پیشین بازگردید.

.PP
برای اطلاعات بیشتر درباره دامنه‌های OAuth، به نشانی زیر مراجعه کنید:
.PP
\[la]https://docs.github.com/en/developers/apps/building\-oauth\-apps/scopes\-for\-oauth\-apps\[ra]\&.


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB-c\fR, \fB--clipboard\fR
کپی کردن کد یک‌بارمصرف دستگاه OAuth در کلیپ‌بورد

.TP
\fB-h\fR, \fB--hostname\fR \fB<string>\fR
میزبان گیت‌هاب مورد استفاده برای احراز هویت

.TP
\fB--insecure-storage\fR
ذخیره اعتبارنامه‌های احراز هویت به صورت متن ساده به‌جای استفاده از مخزن اعتبارنامه‌ها

.TP
\fB-r\fR, \fB--remove-scopes\fR \fB<strings>\fR
دامنه‌های احراز هویت برای حذف از gh

.TP
\fB--reset-scopes\fR
بازنشانی دامنه‌های احراز هویت به حداقل مجموعه پیش‌فرض دامنه‌ها

.TP
\fB-s\fR, \fB--scopes\fR \fB<strings>\fR
دامنه‌های احراز هویت اضافی برای اعطا به gh


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

.PP
1: خطا

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

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

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


.SH "مثال‌ها (EXAMPLES)"
.EX
# باز کردن مرورگر برای افزودن دامنه‌های write:org و read:public_key
$ gh auth refresh --scopes write:org,read:public_key

# باز کردن مرورگر برای اطمینان از اینکه اعتبارنامه‌های احراز هویت دارای حداقل دامنه‌های صحیح هستند
$ gh auth refresh

# باز کردن مرورگر برای حذف بدون اثر جانبی دامنه delete_repo
$ gh auth refresh --remove-scopes delete_repo

# باز کردن مرورگر برای احراز هویت مجدد با حداقل دامنه‌های پیش‌فرض
$ gh auth refresh --reset-scopes

# باز کردن مرورگر برای احراز هویت مجدد و کپی کد یک‌بارمصرف OAuth در کلیپ‌بورد
$ gh auth refresh --clipboard

.EE


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