نام (NAME)

gh-auth-refresh - به‌روزرسانی توکن‌های احراز هویت

خلاصه دستور (SYNOPSIS)

gh auth refresh [flags]

توضیحات (DESCRIPTION)

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

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

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

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

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

برای اطلاعات بیشتر درباره دامنه‌های OAuth، به نشانی زیر مراجعه کنید:

⟨https://docs.github.com/en/developers/apps/building-oauth-apps/scopes-for-oauth-apps⟩.

گزینه‌ها (OPTIONS)

-c, --clipboard: کپی کردن کد یک‌بارمصرف دستگاه OAuth در کلیپ‌بورد
-h, --hostname <string>: میزبان گیت‌هاب مورد استفاده برای احراز هویت
--insecure-storage: ذخیره اعتبارنامه‌های احراز هویت به صورت متن ساده به‌جای استفاده از مخزن اعتبارنامه‌ها
-r, --remove-scopes <strings>: دامنه‌های احراز هویت برای حذف از gh
--reset-scopes: بازنشانی دامنه‌های احراز هویت به حداقل مجموعه پیش‌فرض دامنه‌ها
-s, --scopes <strings>: دامنه‌های احراز هویت اضافی برای اعطا به gh

کدهای خروج (EXIT CODES)

0: اجرای موفقیت‌آمیز

1: خطا

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

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

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

مثال‌ها (EXAMPLES)

# باز کردن مرورگر برای افزودن دامنه‌های 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

همچنین ببینید (SEE ALSO)

gh-auth(1)