.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH nethsm-env-add-device 1  "nethsm-env-add-device " 
.SH "نام (NAME)"
nethsm\-env\-add\-device \- افزودن یک دستگاه به پیکربندی
.SH "خلاصه دستور (SYNOPSIS)"
\fBnethsm env add device\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] <\fIURL\fR> <\fITLS_SECURITY\fR> 
.SH "توضیحات (DESCRIPTION)"
افزودن یک دستگاه به پیکربندی.
.PP
مدخل‌های دستگاه با یک URL و تنظیمات مربوط به امنیت اتصال TLS اضافه می‌شوند.
.PP
برای این دستور ارائه برچسبی که دستگاه را مشخص کند، الزامی است.
.SH "گزینه‌ها (OPTIONS)"
.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
<\fIURL\fR>
نشانی اینترنتی (URL) مربوط به رابط برنامه‌نویسی (API) دستگاه.
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_URL\fR مشخص شود. 
.RE
.TP
<\fITLS_SECURITY\fR>
امنیت اتصال TLS برای دستگاه.

یکی از موارد زیر:
* "Unsafe": اتصال TLS از طریق اعتبارسنجی گواهی میزبان هدف تأیید نمی‌شود
* "Native": اتصال TLS با اعتبارسنجی گواهی میزبان هدف در برابر مخزن بومی گواهی‌های سراسری سیستم فراخواننده تأیید می‌شود
* چک‌سام پین‌شده‌ی SHA\-256 کلید میزبان هدف (با پیشوند "sha256:") برای اعتبارسنجی گواهی میزبان هدف استفاده می‌شود
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_TLS_SECURITY\fR مشخص شود. 
.RE