.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH nethsm-key-get 1  "nethsm-key-get " 
.SH "نام (NAME)"
nethsm\-key\-get \- دریافت اطلاعات یک کلید
.SH "خلاصه دستور (SYNOPSIS)"
\fBnethsm key get\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] <\fIKEY_ID\fR> 
.SH "توضیحات (DESCRIPTION)"
دریافت اطلاعات درباره یک کلید.
.PP
اطلاعاتی درباره سازوکارهای پشتیبانی‌شده کلید، نوع کلید، محدودیت‌های اعمال‌شده (یعنی برچسب‌های تنظیم‌شده برای کلید)، اطلاعات مربوط به بخش کلید عمومی و تعداد عملیات‌های انجام‌شده با کلید را نمایش می‌دهد.
.PP
کاربران سراسری سیستم در نقش "Administrator" یا "Operator" تنها می‌توانند اطلاعات کلیدهای سراسری را دریافت کنند.
کاربران دارای فضای نام (Namespaced) در نقش "Administrator" یا "Operator" تنها می‌توانند اطلاعات کلیدهای موجود در فضای نام اختصاصی خود را دریافت کنند.
.PP
نیازمند احراز هویت کاربری با نقش "Administrator" یا "Operator" است (با داشتن دسترسی به کلید \- "nethsm key tag" و "nethsm user tag" را ببینید).
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-a\fR, \fB\-\-auth\-passphrase\-file\fR \fI<AUTH_PASSPHRASE_FILE>\fR
مسیر فایلی که حاوی یک عبارت عبور (passphrase) برای احراز هویت است.

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

این گزینه می‌تواند چندین بار مشخص شود، که برای دستورهایی که به‌طور هم‌زمان به چندین نقش نیاز دارند لازم است.
با مشخص کردن چندین فایل عبارت عبور، ترتیب اهمیت پیدا می‌کند؛ چرا که فایل‌ها به کاربر متناظری که از طریق گزینه "\-\-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
<\fIKEY_ID\fR>
شناسه (ID) کلیدی که اطلاعات آن باید نمایش داده شود.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_KEY_ID\fR مشخص شود. 
.RE