.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH nethsm-system-restore 1  "nethsm-system-restore " 
.SH "نام (NAME)"
nethsm\-system\-restore \- بازیابی دستگاه از یک نسخهٔ پشتیبان
.SH "خلاصه دستور (SYNOPSIS)"
\fBnethsm system restore\fR [\fB\-b\fR|\fB\-\-backup\-passphrase\-file\fR] [\fB\-s\fR|\fB\-\-system\-time\fR] [\fB\-a\fR|\fB\-\-auth\-passphrase\-file\fR] [\fB\-c\fR|\fB\-\-config\fR] [\fB\-l\fR|\fB\-\-label\fR] [\fB\-u\fR|\fB\-\-user\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIINPUT\fR> 
.SH "توضیحات (DESCRIPTION)"
بازیابی دستگاه از یک نسخهٔ پشتیبان.
.PP
دستگاه ممکن است در وضعیت «Operational» یا «Unprovisioned» باشد.
در هر دو حالت، کاربران و کلیدهای موجود در نسخهٔ پشتیبان جایگزین موارد روی دستگاه (در صورت وجود) می‌شوند.
.PP
اگر دستگاه در وضعیت «Unprovisioned» باشد، هرگونه اطلاعات ارائه‌شده برای احراز هویت نادیده گرفته می‌شود، پیکربندی سیستم
(مانند گواهی TLS، عبارت عبور بازگشایی قفل، و غیره) از نسخهٔ پشتیبان نیز استفاده می‌شود، دستگاه بازراه‌اندازی شده و در وضعیت
«Locked» قرار می‌گیرد.
.PP
اگر زمان جدیدی برای سیستم مشخص نشود، از زمان سیستم فراخواننده مشتق می‌شود.
اگر عبارت عبور نسخهٔ پشتیبان به‌طور مشخص ارائه نشود، به‌صورت تعاملی درخواست می‌گردد.
.PP
تنها در صورتی که دستگاه در وضعیت «Operational» باشد، به احراز هویت یک کاربر سراسری سیستم در نقش «Administrator» نیاز است.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-b\fR, \fB\-\-backup\-passphrase\-file\fR \fI<BACKUP_PASSPHRASE_FILE>\fR
مسیر فایل حاوی عبارت عبور نسخهٔ پشتیبان
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_BACKUP_PASSPHRASE_FILE\fR مشخص شود. 
.RE
.TP
\fB\-s\fR, \fB\-\-system\-time\fR \fI<SYSTEM_TIME>\fR
زمان جدید سیستم برای دستگاه

باید در قالب برچسب زمانی UTC با استاندارد ISO 8601 ارائه شود.
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_SYSTEM_TIME\fR مشخص شود. 
.RE
.TP
\fB\-a\fR, \fB\-\-auth\-passphrase\-file\fR \fI<AUTH_PASSPHRASE_FILE>\fR
مسیر فایل حاوی عبارت عبور برای احراز هویت

عبارت عبور ارائه‌شده در فایل باید متعلق به کاربری باشد که برای این دستور انتخاب شده است.

این گزینه می‌تواند چندین بار مشخص شود، که برای دستورهای نیازمند به چند نقش به‌طور هم‌زمان لازم است.
در صورت استفاده از چند فایل عبارت عبور، ترتیب آن‌ها اهمیت دارد؛ چرا که فایل‌ها به کاربر مربوطهٔ مشخص‌شده با گزینهٔ «\-\-user» اختصاص می‌یابند.
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_AUTH_PASSPHRASE_FILE\fR مشخص شود. 
.RE
.TP
\fB\-c\fR, \fB\-\-config\fR \fI<CONFIG>\fR
مسیر یک فایل پیکربندی سفارشی

در صورت تعیین، فایل پیکربندی سفارشی به جای مکان پیش‌فرض فایل پیکربندی استفاده می‌شود.
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_CONFIG\fR مشخص شود. 
.RE
.TP
\fB\-l\fR, \fB\-\-label\fR \fI<LABEL>\fR
برچسبی برای شناسایی یکتای دستگاه در فایل پیکربندی

در صورتی که بیش از یک دستگاه در فایل پیکربندی تنظیم شده باشد، مشخص کردن این گزینه الزامی است.
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_LABEL\fR مشخص شود. 
.RE
.TP
\fB\-u\fR, \fB\-\-user\fR \fI<USER>\fR
نام کاربری که برای اجرای دستور به کار می‌رود

اگر هیچ نام کاربری در فایل پیکربندی برای دستگاه تنظیم نشده باشد، می‌تواند ارائه شود.
اگر چندین نام کاربری با نقش هدف یکسان در فایل پیکربندی برای یک دستگاه تنظیم شده باشند، ارائه آن الزامی است.

این گزینه می‌تواند چندین بار مشخص شود که برای دستورهای نیازمند چندین نقش به‌طور هم‌زمان لازم است.

.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_USER\fR مشخص شود. 
.RE
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش راهنما (مشاهدهٔ خلاصه‌ای با \*(Aq\-h\*(Aq)
.TP
<\fIINPUT\fR>
مسیر یک فایل پشتیبان معتبر NetHSM
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_BACKUP_FILE\fR مشخص شود. 
.RE