.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH nethsm-user-tag 1  "nethsm-user-tag " 
.SH "نام (NAME)"
nethsm\-user\-tag \- افزودن یک برچسب به کاربر
.SH "خلاصه دستور (SYNOPSIS)"
\fBnethsm user tag\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] <\fINAME\fR> <\fITAG\fR> 
.SH "توضیحات (DESCRIPTION)"
افزودن یک برچسب به کاربر
.PP
برچسب‌ها دسترسی به کلیدها را برای کاربران فراهم می‌کنند.
کلیدهایی که دارای برچسب‌های یکسان با برچسب یک کاربر باشند، برای آن کاربر قابل دسترسی خواهند بود.
برچسب‌های روی یک کلید باید از قبل وجود داشته باشند (دستور «nethsm key tag» را ببینید) تا بتوان برچسبی یکسان را به یک کاربر اضافه کرد.
.PP
کاربران سراسری سیستم در نقش «Administrator» تنها می‌توانند برای کاربران سراسری در نقش «Operator» برچسب اضافه کنند.
کاربران محدود به فضای نام (Namespaced) در نقش «Administrator» تنها می‌توانند برای کاربران با نقش «Operator» در همان فضای نام برچسب اضافه کنند.
.PP
دستگاه باید در وضعیت «Operational» باشد.
.PP
نیازمند احراز هویت کاربری در نقش «Administrator» است.
.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
<\fINAME\fR>
نام کاربری که برچسب باید به آن افزوده شود
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_USER_NAME\fR مشخص شود.
.RE
.TP
<\fITAG\fR>
برچسبی که باید برای کاربر افزوده شود
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_USER_TAG\fR مشخص شود.
.RE