.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH nethsm-user-add 1  "nethsm-user-add " 
.SH "نام (NAME)"
nethsm\-user\-add \- افزودن یک کاربر
.SH "خلاصه دستور (SYNOPSIS)"
\fBnethsm user add\fR [\fB\-p\fR|\fB\-\-passphrase\-file\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] <\fIREAL_NAME\fR> [\fIROLE\fR] [\fINAME\fR] 
.SH "توضیحات (DESCRIPTION)"
افزودن یک کاربر
.PP
یک کاربر جدید را با ارائه نام واقعی و یک نقش کاربری اضافه می‌کند.
اگر نام کاربری مشخصی ارائه نشود، یک نام تصادفی به‌طور خودکار توسط دستگاه مقصد تولید می‌شود.
اگر عبارت عبور (passphrase) ارائه نشود، به‌صورت تعاملی از کاربر درخواست خواهد شد.
.PP
کاربران جدید، حوزه (scope) کاربری ایجادکننده خود را به ارث می‌برند.
اگر یک کاربر سراسریِ سیستم (system\-wide) در نقش "Administrator" یک کاربر جدید بسازد (مانند "user1")، آن کاربر جدید نیز یک کاربر سراسری سیستم خواهد بود.
به‌عنوان استثنایی بر این قاعده، یک کاربر سراسری سیستم در نقش "Administrator" می‌تواند با مشخص کردن صریح یک نام کاربری (مانند "namespace1~user1") کاربران دارای فضای نام ایجاد کند، اما تنها در صورتی که فضای نام مورد نظر (یعنی "namespace1") هنوز وجود نداشته باشد (نگاه کنید به "nethsm namespace add").
اگر یک کاربرِ دارای فضای نام در نقش "Administrator" کاربر جدیدی بسازد، آن کاربر جدید نیز کاربری در همان فضای نام خواهد بود.
اگر یک کاربر دارای فضای نام در نقش "Administrator" (مانند "namespace1~admin1") یک نام کاربری خاص ارائه دهد، آن نام حتماً باید در همان فضای نام باشد (برای نمونه "namespace1~user1"، نه "namespace2~user1")!
.PP
دستگاه باید در وضعیت "Operational" باشد.
.PP
نیازمند احراز هویت یک کاربر در نقش "Administrator" است.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-p\fR, \fB\-\-passphrase\-file\fR \fI<PASSPHRASE_FILE>\fR
مسیر فایلی حاوی عبارت عبور کاربر جدید

طول عبارت عبور باید >= ۱۰ و <= ۲۰۰ نویسه باشد.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_PASSPHRASE_FILE\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
<\fIREAL_NAME\fR>
نام واقعی کاربری که ایجاد می‌شود

این نام تنها برای شناسایی بیشتر کاربرد دارد و برای احراز هویت استفاده نمی‌شود!
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_REAL_NAME\fR مشخص شود. 
.RE
.TP
[\fIROLE\fR]
نقش کاربری که ایجاد می‌شود

یکی از مقادیر ["Administrator"، "Backup"، "Metrics"، "Operator"] (پیش‌فرض "Operator").
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_USER_ROLE\fR مشخص شود. 
.RE
.TP
[\fINAME\fR]
نامی یکتا برای کاربری که ایجاد می‌شود

این نام باید یکتا باشد، زیرا برای احراز هویت استفاده می‌شود!
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_USER_NAME\fR مشخص شود. 
.RE