.TH "xfreerdp3" "1" "2026-09-03" "freerdp" "xfreerdp3"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.SH "نام (NAME)"
xfreerdp3 \- کلاینت X11 برای FreeRDP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBxfreerdp3\fR
[file] [options] [/v:server[:port]]
.SH "توضیحات (DESCRIPTION)"
.PP
\fBxfreerdp3\fR
یک کلاینت پروتکل میزکار از راه دور (RDP) تحت سامانه پنجره‌بندی X11 است که بخشی از پروژه FreeRDP به شمار می‌رود\&. سرور RDP به صورت پیش‌ساخته در بسیاری از نسخه‌های Windows تعبیه شده است\&. سرورهای جایگزین شامل ogon، gnome\-remote\-desktop، xrdp و VRDP (در VirtualBox) هستند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB/a\fR:\fIaddin\fR[,\fIoptions\fR], \fB/addin\fR:\fIaddin\fR[,\fIoptions\fR]
.RS 4
افزونه (Addin)
.RE
.PP
\fB/azure\fR:[tenantid:\fIid\fR],[use\-tenantid[:[on|off]],[ad:\fIurl\fR][avd\-access:\fIformat string\fR],[avd\-token:\fIformat string\fR],[avd\-scope:\fIformat string\fR]
.RS 4
گزینه‌های AzureAD
.RE
.PP
\fB/action\-script\fR:\fIfile\-name\fR
.RS 4
اسکریپت اقدام (پیش‌فرض:~/\&.config/freerdp/action\&.sh)
.RE
.PP
\fB/admin\fR, \fB/console\fR
.RS 4
نشست مدیریتی (یا کنسول)
.RE
.PP
\fB+aero\fR
.RS 4
ترکیب پنجره‌های میزکار (desktop composition) (پیش‌فرض:off)
.RE
.PP
\fB/app\fR:program:[\fIpath\fR|\fI||alias\fR],cmd:\fIcommand\fR,file:\fIfilename\fR,guid:\fIguid\fR,icon:\fIfilename\fR,name:\fIname\fR,workdir:\fIdirectory\fR,hidef:[on|off]
.RS 4
برنامه کاربردی راه دور (Remote application)
.RE
.PP
\fB/assistance\fR:\fIpassword\fR
.RS 4
گذرواژه کمک از راه دور (Remote assistance)
.RE
.PP
\fB/auto\-request\-control\fR:
.RS 4
درخواست خودکار کنترل ورودی برای کمک از راه دور
.RE
.PP
\fB+async\-channels\fR
.RS 4
کانال‌های ناهمگام (آزمایشی) (پیش‌فرض:off)
.RE
.PP
\fB+async\-update\fR
.RS 4
به‌روزرسانی ناهمگام (پیش‌فرض:off)
.RE
.PP
\fB/audio\-mode\fR:[[none|2]|[server|1]|[redirect|0]]
.RS 4
حالت خروجی صوتی
.RE
.PP
\fB+auth\-only\fR
.RS 4
فقط احراز هویت (پیش‌فرض:off)
.RE
.PP
\fB/auth\-pkg\-list\fR:[[none],]\fI!ntlm,kerberos,!u2u\fR
.RS 4
فیلتر بسته‌های احراز هویت (فهرست جداشده با کاما، استفاده از \*(Aq!\*(Aq برای غیرفعال‌سازی)\&. به طور پیش‌فرض همه روش‌ها فعال هستند\&. استفاده از مقدار صریح \*(Aqnone\*(Aq به عنوان اولین آرگومان تمام روش‌ها را غیرفعال کرده و تنها مواردی که پس از آن می‌آیند فعال می‌شوند\&.
.RE
.PP
\fB\-authentication\fR
.RS 4
احراز هویت (آزمایشی) (پیش‌فرض:on)
.RE
.PP
\fB+auto\-reconnect\fR
.RS 4
اتصال مجدد خودکار (پیش‌فرض:off)
.RE
.PP
\fB/auto\-reconnect\-max\-retries\fR:\fIretries\fR
.RS 4
حداکثر تلاش‌ها برای اتصال مجدد خودکار، مقدار 0 برای نامحدود [0,1000]
.RE
.PP
\fB/bpp\fR:\fIdepth\fR
.RS 4
عمق رنگ نشست یا bpp (پیش‌فرض:16)
.RE
.PP
\fB/buildconfig\fR
.RS 4
چاپ پیکربندی ساخت نرم‌افزار
.RE
.PP
\fB/cache\fR:[bitmap[:on|off],codec[:rfx|nsc],glyph[:on|off],offscreen[:on|off],persist,persist\-file:\fIfilename\fR]
.RS 4
.RE
.PP
\fB/cert\fR:[deny,ignore,name:\fIname\fR,tofu,fingerprint:\fIhash\fR:\fIhash as hex\fR[,fingerprint:\fIhash\fR:\fIanother hash\fR]]
.RS 4
گزینه‌های پذیرش گواهی‌نامه\&. با احتیاط استفاده شود!
.br
 * deny         \&.\&.\&. قطع خودکار اتصال در صورت عدم تطابق گواهی‌نامه، بدون دخالت کاربر\&.
.br
 * ignore       \&.\&.\&. نادیده گرفتن کلی بررسی‌های گواهی‌نامه (بر تمام گزینه‌های دیگر اولویت دارد)\&.
.br
 * name         \&.\&.\&. استفاده از <name> جایگزین به جای موضوع گواهی‌نامه جهت تطبیق با گواهی‌نامه‌های محلی ذخیره‌شده\&.
.br
 * tofu         \&.\&.\&. پذیرش بدون قید و شرط گواهی‌نامه در نخستین اتصال و رد آن در اتصالات بعدی در صورت عدم تطابق\&.
.br
 * fingerprints \&.\&.\&. فهرستی از هش‌های گواهی‌نامه که بدون قید و شرط برای اتصال پذیرفته می‌شوند\&.
.RE
.PP
\fB/client\-build\-number\fR:\fInumber\fR
.RS 4
شماره ساخت کلاینت ارسالی به سرور (بر رفتار کارت هوشمند تأثیر می‌گذارد، [MS\-RDPESC] را ببینید)
.RE
.PP
\fB/client\-hostname\fR:\fIname\fR
.RS 4
نام میزبان کلاینت برای ارسال به سرور
.RE
.PP
\fB/clipboard\fR:[[use\-selection:\fIatom\fR],[direction\-to:[all|local|remote|off]],[files\-to[:all|local|remote|off]]]
.RS 4
بازهدایت کلیپ‌بورد:
.br
 * use\-selection:<atom>  \&.\&.\&. (در X11) مشخص کردن گزینش X برای دسترسی\&. پیش‌فرض CLIPBOARD است\&. مقدار PRIMARY گزینش به سبک کلیک میانی در X است\&.
.br
 * direction\-to:[all|local|remote|off] کنترل جهت فعال انتقال کلیپ‌بورد
.br
 * files\-to:[all|local|remote|off] کنترل جهت فعال انتقال فایل‌ها در کلیپ‌بورد (پیش‌فرض:on)
.RE
.PP
\fB\-compression\fR, \fB\-z\fR
.RS 4
فشرده‌سازی (پیش‌فرض:on)
.RE
.PP
\fB/compression\-level\fR:\fIlevel\fR
.RS 4
سطح فشرده‌سازی (0,1,2)
.RE
.PP
\fB+credentials\-delegation\fR
.RS 4
واگذاری اطلاعات کاربری (پیش‌فرض:off)
.RE
.PP
\fB/d\fR:\fIdomain\fR
.RS 4
دامنه (Domain)
.RE
.PP
\fB\-decorations\fR
.RS 4
تزیینات پنجره (پیش‌فرض:on)
.RE
.PP
\fB/disp\fR
.RS 4
کنترل نمایشگر
.RE
.PP
\fB/drive\fR:\fIname\fR,\fIpath\fR
.RS 4
بازهدایت مسیر پوشه <path> به عنوان یک اشتراک نام‌گذاری‌شده با عنوان <name>\&. پشتیبانی از اتصال حین کار با /drive:hotplug,* فعال می‌شود\&. این آرگومان عملکردی مشابه گزینه \(lqDrives that I plug in later\(rq در ابزار MSTSC ارائه می‌دهد\&.
.RE
.PP
\fB+drives\fR
.RS 4
بازهدایت همه نقاط اتصال به عنوان اشتراک (پیش‌فرض:off)
.RE
.PP
\fB/dump\fR:\fIrecord|replay\fR,file:\fIfile\fR[,nodelay]
.RS 4
ضبط یا بازپخش دامپ
.RE
.PP
\fB/dvc\fR:\fIchannel\fR[,\fIoptions\fR]
.RS 4
کانال مجازی پویا (Dynamic virtual channel)
.RE
.PP
\fB+dynamic\-resolution\fR
.RS 4
ارسال به‌روزرسانی‌های وضوح تصویر به هنگام تغییر اندازه پنجره (پیش‌فرض:off)
.RE.PP
\fB/echo\fR, \fB/echo\fR
.RS 4
کانال Echo
.RE
.PP
\fB\-encryption\fR
.RS 4
رمزنگاری (آزمایشی) (پیش‌فرض: on)
.RE
.PP
\fB/encryption\-methods\fR:[40,][56,][128,][FIPS]
.RS 4
روش‌های رمزنگاری امنیت استاندارد RDP
.RE
.PP
\fB/endpointfedauth\fR:\fItoken\fR
.RS 4
توکن FedAuth نقطه پایانی برای سناریوهای اتصال به کنسول ماشین مجازی Hyper\-V
.RE
.PP
\fB/f\fR
.RS 4
حالت تمام‌صفحه (<Ctrl>+<Alt>+<Enter> وضعیت تمام‌صفحه را تغییر می‌دهد)
.RE
.PP
\fB+fipsmode\fR
.RS 4
حالت FIPS (پیش‌فرض: off)
.RE
.PP
\fB/floatbar\fR[:sticky:[on|off],default:[visible|hidden],show:[always|fullscreen|window]]
.RS 4
نوار شناور (floatbar) به‌طور پیش‌فرض غیرفعال است (در صورت فعال‌سازی، به‌طور پیش‌فرض در حالت تمام‌صفحه چسبان/sticky است)
.RE
.PP
\fB\-fonts\fR
.RS 4
فونت‌های هموار (ClearType) (پیش‌فرض: on)
.RE
.PP
\fB+force\-console\-callbacks\fR
.RS 4
استفاده از فراخوانی‌های بازگشتی پیش‌فرض (کنسول) برای گواهی/اعتبارنامه/\&.\&.\&. (پیش‌فرض: off)
.RE
.PP
\fB/frame\-ack\fR:\fInumber\fR
.RS 4
تعداد تأییدیه‌های فریم (frame acknowledgement)
.RE
.PP
\fB/args\-from\fR:file:\fIfile\fR|stdin|fd:\fInumber\fR|env:\fIname\fR
.RS 4
خواندن خط فرمان از یک فایل، stdin یا توصیف‌گر فایل (file descriptor)\&. این آرگومان نمی‌تواند با هیچ آرگومان دیگری ترکیب شود\&. در هر خط یک آرگومان وارد کنید\&.
.RE
.PP
\fB/from\-stdin\fR[:force]
.RS 4
خواندن اطلاعات احراز هویت از stdin\&. با <force> درخواست قبل از اتصال انجام می‌شود، در غیر این صورت به درخواست سرور خواهد بود\&.
.RE
.PP
\fB/gateway\fR:g:\fIgateway\fR[:\fIport\fR],u:\fIuser\fR,d:\fIdomain\fR,p:\fIpassword\fR,usage\-method:[direct|detect],access\-token:\fItoken\fR,type:[rpc|http[,no\-websockets][,extauth\-sspi\-ntlm]|auto[,no\-websockets][,extauth\-sspi\-ntlm]]|arm,url:\fIwss://url\fR,bearer:\fIoauth2\-bearer\-token\fR, \fB/gw\fR:g:\fIgateway\fR[:\fIport\fR],u:\fIuser\fR,d:\fIdomain\fR,p:\fIpassword\fR,usage\-method:[direct|detect],access\-token:\fItoken\fR,type:[rpc|http[,no\-websockets][,extauth\-sspi\-ntlm]|auto[,no\-websockets][,extauth\-sspi\-ntlm]]|arm,url:\fIwss://url\fR,bearer:\fIoauth2\-bearer\-token\fR
.RS 4
نام میزبان Gateway
.RE
.PP
\fB/gdi\fR:sw|hw
.RS 4
رندرینگ GDI
.RE
.PP
\fB/geometry\fR
.RS 4
کانال ردیابی هندسه (Geometry)
.RE
.PP
\fB+gestures\fR
.RS 4
پردازش ورودی چندلمسی به‌صورت محلی (پیش‌فرض: off)
.RE
.PP
\fB/gfx\fR[:[[progressive[:on|off]|RFX[:on|off]|AVC420[:on|off]AVC444[:on|off]],mask:\fIvalue\fR,small\-cache[:on|off],thin\-client[:on|off],progressive[:on|off],frame\-ack[:on|off]]
.RS 4
خط لوله گرافیکی RDP8
.RE
.PP
\fB\-grab\-keyboard\fR
.RS 4
تسخیر فوکوس صفحه‌کلید، هدایت تمام کلیدها به سیستم راه دور (پیش‌فرض: on)
.RE
.PP
\fB\-grab\-mouse\fR
.RS 4
تسخیر فوکوس موشواره، هدایت تمام رویدادها به سیستم راه دور (پیش‌فرض: on)
.RE
.PP
\fB/h\fR:\fIheight\fR
.RS 4
ارتفاع (پیش‌فرض: 768)
.RE
.PP
\fB\-heartbeat\fR
.RS 4
پشتیبانی از PDUهای ضربان قلب (heartbeat) (پیش‌فرض: on)
.RE
.PP
\fB/help\fR, \fB/?\fR
.RS 4
نمایش راهنما
.RE
.PP
\fB+home\-drive\fR
.RS 4
هدایت دایرکتوری خانگی کاربر به‌عنوان اشتراک (پیش‌فرض: off)
.RE
.PP
\fB/ipv4\fR[:[:force]], \fB/4\fR[:[:force]]
.RS 4
اولویت دادن به رکورد A در IPv4 نسبت به رکورد AAAA در IPv6
.RE
.PP
\fB/ipv6\fR[:[:force]], \fB/6\fR[:[:force]]
.RS 4
اولویت دادن به رکورد AAAA در IPv6 نسبت به رکورد A در IPv4
.RE
.PP
\fB/jpeg\fR
.RS 4
پشتیبانی از کُدک JPEG
.RE
.PP
\fB/jpeg\-quality\fR:\fIpercentage\fR
.RS 4
کیفیت JPEG
.RE
.PP
\fB/kbd\fR:[layout:[0x\fIid\fR|\fIname\fR],lang:\fI0x\fIid\fR\fR,fn\-key:\fIvalue\fR,type:\fIvalue\fR,subtype:\fIvalue\fR,unicode[:on|off],remap:\fIkey1\fR=\fIvalue1\fR,remap:\fIkey2\fR=\fIvalue2\fR,pipe:\fIfilename\fR]
.RS 4
گزینه‌های مربوط به صفحه‌کلید:
.br
 * layout: تنظیم طرح‌بندی صفحه‌کلید اعلان‌شده به سرور
.br
 * lang: تنظیم شناسه زبان صفحه‌کلید ارسالی به سرور
.br
 * fn\-key: مقدار کلید Function
.br
 * remap: بازنگاشت اسکن‌کد RDP به مقداری دیگر\&. برای دریافت نگاشت‌ها از /list:kbd\-scancode استفاده کنید\&. مثال: برای جابه‌جایی \*(Aqa\*(Aq و \*(Aqs\*(Aq روی یک صفحه‌کلید آمریکایی (US): /kbd:remap:0x1e=0x1f,remap:0x1f=0x1e
.br
 * pipe: نام یک لوله نام‌گذاری‌شده (named pipe) که می‌تواند برای نوشتن متن در نشست RDP به کار رود
.br
.RE
.PP
\fB/kerberos\fR:[kdc\-url:\fIurl\fR,lifetime:\fItime\fR,start\-time:\fItime\fR,renewable\-lifetime:\fItime\fR,cache:\fIpath\fR,armor:\fIpath\fR,pkinit\-anchors:\fIpath\fR,pkcs11\-module:\fIname\fR]
.RS 4
گزینه‌های Kerberos
.RE
.PP
\fB/load\-balance\-info\fR:\fIinfo\-string\fR
.RS 4
اطلاعات توازن بار (Load balance info)
.RE
.PP
\fB/list\fR:[kbd|kbd\-scancode|kbd\-lang[:\fIvalue\fR]|smartcard[:[pkinit\-anchors:\fIpath\fR][,pkcs11\-module:\fIname\fR]]|monitor|tune|timezones]
.RS 4
فهرست کردن گزینه‌های موجود برای زیرفرمان (پیش‌فرض: List available options for subcommand)
.RE
.PP
\fB/log\-filters\fR:\fItag\fR:\fIlevel\fR[,\fItag\fR:\fIlevel\fR[,\&.\&.\&.]]
.RS 4
تنظیم فیلترهای ثبت وقایع، برای جزئیات wLog(7) را ببینید
.RE
.PP
\fB/log\-level\fR:[OFF|FATAL|ERROR|WARN|INFO|DEBUG|TRACE]
.RS 4
تنظیم سطح پیش‌فرض گزارش‌گیری، برای جزئیات wLog(7) را ببینید
.RE
.PP
\fB/max\-fast\-path\-size\fR:\fIsize\fR
.RS 4
تعیین حداکثر اندازه به‌روزرسانی fast\-path
.RE
.PP
\fB/max\-loop\-time\fR:\fItime\fR
.RS 4
تعیین حداکثر زمان برحسب میلی‌ثانیه برای پردازش بسته‌ها
.RE
.PP
\fB+menu\-anims\fR
.RS 4
پویانمایی‌های منو (پیش‌فرض: off)
.RE
.PP
\fB/microphone\fR[:[sys:\fIsys\fR,][dev:\fIdev\fR,][format:\fIformat\fR,][rate:\fIrate\fR,][channel:\fIchannel\fR]], \fB/mic\fR[:[sys:\fIsys\fR,][dev:\fIdev\fR,][format:\fIformat\fR,][rate:\fIrate\fR,][channel:\fIchannel\fR]]
.RS 4
ورودی صدا (میکروفون)
.RE
.PP
\fB/monitors\fR:\fIid\fR[,\fIid\fR[,\&.\&.\&.]]
.RS 4
[آزمایشی] انتخاب نمایشگرها جهت استفاده (تنها در حالت تمام‌صفحه یا چندنمایشگره مؤثر است)
.RE.PP
\fB\-mouse\-motion\fR
.RS 4
ارسال رویدادهای حرکت ماوس (پیش‌فرض: on)
.RE
.PP
\fB+mouse\-relative\fR
.RS 4
ارسال حرکت ماوس با آدرس‌دهی نسبی (پیش‌فرض: off)
.RE
.PP
\fB/mouse\fR:[relative:[on|off],grab:[on|off]]
.RS 4
گزینه‌های مربوط به ماوس:
.br
 * relative:   ارسال حرکات نسبی ماوس در صورت پشتیبانی سرور
.br
 * grab:       به دام انداختن ماوس در صورت قرار داشتن در پنجره
.RE
.PP
\fB/multimon\fR[:force]
.RS 4
استفاده از چند نمایشگر
.RE
.PP
\fB+multitouch\fR
.RS 4
بازهدایت ورودی چندلمسی (پیش‌فرض: off)
.RE
.PP
\fB\-multitransport\fR
.RS 4
پشتیبانی از پروتکل multitransport (پیش‌فرض: on)
.RE
.PP
\fB\-nego\fR
.RS 4
مذاکره امنیتی پروتکل (پیش‌فرض: on)
.RE
.PP
\fB/network\fR:[invalid|modem|broadband|broadband\-low|broadband\-high|wan|lan|auto]
.RS 4
نوع اتصال شبکه
.RE
.PP
\fB/nsc\fR, \fB/nscodec\fR
.RS 4
پشتیبانی از NSCodec
.RE
.PP
\fB/orientation\fR:[0|90|180|270]
.RS 4
جهت‌گیری نمایشگر بر حسب درجه
.RE
.PP
\fB+old\-license\fR
.RS 4
استفاده از جریان کاری قدیمی مجوز (بدون CAL و با تنظیم hwId روی 0) (پیش‌فرض: off)
.RE
.PP
\fB/p\fR[:\fIpassword\fR]
.RS 4
گذرواژه\&. ارسال /p بدون آرگومان در صورتی که نیازی به اطلاعات کاربری برای اتصال نباشد، اعلان‌های تعاملی گذرواژه را غیرفعال می‌کند\&.
.RE
.PP
\fB/parallel\fR[:\fIname\fR[,\fIpath\fR]]
.RS 4
بازهدایت دستگاه موازی
.RE
.PP
\fB/parent\-window\fR:\fIwindow\-id\fR
.RS 4
شناسه پنجره والد
.RE
.PP
\fB/pcb\fR:\fIblob\fR
.RS 4
داده باینری پیش‌اتصال (Preconnection Blob)
.RE
.PP
\fB/pcid\fR:\fIid\fR
.RS 4
شناسه پیش‌اتصال (Preconnection Id)
.RE
.PP
\fB/pheight\fR:\fIheight\fR
.RS 4
ارتفاع فیزیکی نمایشگر (به میلی‌متر)
.RE
.PP
\fB/play\-rfx\fR:\fIpcap\-file\fR
.RS 4
پخش مجدد فایل pcap مربوط به rfx
.RE
.PP
\fB/port\fR:\fInumber\fR
.RS 4
پورت سرور
.RE
.PP
\fB\-suppress\-output\fR
.RS 4
فرونشانی خروجی هنگام کمینه‌شدن (پیش‌فرض: on)
.RE
.PP
\fB+print\-reconnect\-cookie\fR
.RS 4
چاپ کوکی اتصال مجدد base64 پس از اتصال (پیش‌فرض: off)
.RE
.PP
\fB/printer\fR[:\fIname\fR[,\fIdriver\fR[,default]]]
.RS 4
بازهدایت دستگاه چاپگر
.RE
.PP
\fB/proxy\fR:[\fIproto\fR://][\fIuser\fR:\fIpassword\fR@]\fIhost\fR[:\fIport\fR]
.RS 4
تنظیمات پروکسی: نادیده‌گرفتن متغیر محیطی (همچنین متغیر محیطی زیر را ببینید)\&. در حالی که "http" پیش‌فرض است، پروتکل "socks5" باید صریحاً مشخص شود\&.
.RE
.PP
\fB/pth\fR:\fIpassword\-hash\fR, \fB/pass\-the\-hash\fR:\fIpassword\-hash\fR
.RS 4
روش Pass the hash (حالت مدیر محدودشده)
.RE
.PP
\fB/pwidth\fR:\fIwidth\fR
.RS 4
عرض فیزیکی نمایشگر (به میلی‌متر)
.RE
.PP
\fB/rdp2tcp\fR:\fIexecutable path[:arg\&.\&.\&.]\fR
.RS 4
بازهدایت TCP
.RE
.PP
\fB/reconnect\-cookie\fR:\fIbase64\-cookie\fR
.RS 4
ارسال کوکی اتصال مجدد base64 به اتصال
.RE
.PP
\fB/redirect\-prefer\fR:\fIFQDN|IP|NETBIOS\fR,[\&.\&.\&.]
.RS 4
بازنویسی ترتیب اولویت بازهدایت
.RE
.PP
\fB/relax\-order\-checks\fR, \fB/relax\-order\-checks\fR
.RS 4
بررسی نکردن اعلان شدن دستور RDP در حین تبادل قابلیت‌ها؛ تنها هنگام اتصال به سرورهای دارای باگ استفاده شود
.RE
.PP
\fB/restricted\-admin\fR, \fB/restrictedAdmin\fR
.RS 4
حالت مدیر محدودشده (Restricted admin)
.RE
.PP
\fB/rfx\fR
.RS 4
RemoteFX
.RE
.PP
\fB/rfx\-mode\fR:[image|video]
.RS 4
حالت RemoteFX
.RE
.PP
\fB/scale\fR:[100|140|180]
.RS 4
ضریب مقیاس‌بندی نمایشگر (پیش‌فرض: 100)
.RE
.PP
\fB/scale\-desktop\fR:\fIpercentage\fR
.RS 4
ضریب مقیاس‌بندی برای برنامه‌های میزکار (مقداری بین 100 و 500) (پیش‌فرض: 100)
.RE
.PP
\fB/scale\-device\fR:100|140|180
.RS 4
ضریب مقیاس‌بندی برای برنامه‌های app store (پیش‌فرض: 100)
.RE
.PP
\fB/sec\fR:rdp[:[on|off]]|tls[:[on|off]]|nla[:[on|off]]|ext[:[on|off]]|aad[:[on|off]]
.RS 4
اجبار امنیت پروتکل مشخص\&. به عنوان مثال /sec:nla پروتکل NLA را فعال و سایر موارد را غیرفعال می‌کند، در حالی که /sec:nla:[on|off] صرفاً وضعیت NLA را تغییر می‌دهد
.RE
.PP
\fB/serial\fR[:\fIname\fR[,\fIpath\fR[,\fIdriver\fR[,permissive]]]], \fB/tty\fR[:\fIname\fR[,\fIpath\fR[,\fIdriver\fR[,permissive]]]]
.RS 4
بازهدایت دستگاه سریال
.RE
.PP
\fB/server\-name\fR:\fIname\fR
.RS 4
نام سرور تعیین‌شده توسط کاربر جهت اعتبارسنجی (TLS, Kerberos)
.RE
.PP
\fB/shell\fR:\fIshell\fR
.RS 4
پوسته جایگزین
.RE
.PP
\fB/shell\-dir\fR:\fIdir\fR
.RS 4
دایرکتوری کاری پوسته
.RE.PP
\fB/size\fR:\fIwidth\fRx\fIheight\fR یا \fIpercent\fR%[wh]
.RS 4
اندازه صفحه نمایش (پیش‌فرض: 1024x768)
.RE
.PP
\fB/smart\-sizing\fR[:\fIwidth\fRx\fIheight\fR]
.RS 4
مقیاس‌بندی میزکار دوردست به اندازه پنجره
.RE
.PP
\fB/smartcard\fR[:\fIstr\fR[,\fIstr\fR\&.\&.\&.]]
.RS 4
هدایت دستگاه‌های کارت هوشمند که نام آن‌ها حاوی هر یک از <str> باشد\&.
.RE
.PP
\fB/smartcard\-logon\fR[:[[cert:\fIpath\fR|cert:\fIbase64(PEM)\fR],[key:\fIpath\fR|key:\fIbase64(PEM)\fR],pin:\fIpin\fR,csp:\fIcsp name\fR,reader:\fIreader\fR,card:\fIcard\fR]]
.RS 4
احراز هویت ورود به سیستم با کارت هوشمند (گواهی اختیاری) را فعال می‌کند\&.
.RE
.PP
\fB/sound\fR[:[sys:\fIsys\fR,][dev:\fIdev\fR,][format:\fIformat\fR,][rate:\fIrate\fR,][channel:\fIchannel\fR,][latency:\fIlatency\fR,][quality:\fIquality\fR]], \fB/audio\fR[:[sys:\fIsys\fR,][dev:\fIdev\fR,][format:\fIformat\fR,][rate:\fIrate\fR,][channel:\fIchannel\fR,][latency:\fIlatency\fR,][quality:\fIquality\fR]]
.RS 4
خروجی صدا (صوت)
.RE
.PP
\fB/span\fR
.RS 4
گسترش صفحه نمایش روی چند نمایشگر
.RE
.PP
\fB/spn\-class\fR:\fIservice\-class\fR
.RS 4
کلاس سرویس احراز هویت SPN
.RE
.PP
\fB/ssh\-agent\fR, \fB/ssh\-agent\fR
.RS 4
کانال فورواردینگ SSH Agent
.RE
.PP
\fB/sspi\-module\fR:\fISSPI module path\fR
.RS 4
مسیر فایل ماژول کتابخانه اشتراکی SSPI
.RE
.PP
\fB/winscard\-module\fR:\fIWinSCard module path\fR
.RS 4
مسیر فایل ماژول کتابخانه اشتراکی WinSCard
.RE
.PP
\fB/disable\-output\fR
.RS 4
غیرفعال‌سازی کلیه رمزگشایی‌های گرافیکی در نشست کلاینت\&. برای آزمون‌های بار با اتصالات هم‌زمان متعدد کاربرد دارد
.RE
.PP
\fB/t\fR:\fItitle\fR, \fB/title\fR:\fItitle\fR
.RS 4
عنوان پنجره
.RE
.PP
\fB\-themes\fR
.RS 4
تم‌ها (پیش‌فرض: on)
.RE
.PP
\fB/timeout\fR:\fItime in ms\fR, \fB/timeout\fR:\fItime in ms\fR
.RS 4
تنظیمات پیشرفته برای پیوندهای با تاخیر بالا: تنظیم مهلت زمانی اتصال؛ در صورت مواجهه با خطای مهلت زمانی در اتصال خود از آن استفاده کنید (پیش‌فرض: 9000)
.RE
.PP
\fB/timezone\fR:\fIwindows timezone\fR
.RS 4
استفاده از منطقه زمانی ویندوزی ارائه‌شده برای اتصال (نیازمند پشتیبانی سرور است)؛ برای مقادیر مجاز /list:timezones را ببینید
.RE
.PP
\fB/tls\fR:[ciphers|seclevel|secrets\-file|enforce]
.RS 4
گزینه‌های پیکربندی TLS: * ciphers:[netmon|ma|<cipher names>]
.br
 * seclevel:<level>، پیش‌فرض: 1، بازه: [0\-5] بازنویسی سطح امنیت پیش‌فرض TLS، ممکن است برای سرورهای مقصد قدیمی‌تر مورد نیاز باشد\&. جزئیات در https://docs\&.openssl\&.org/3\&.0/man3/SSL_CTX_set_security_level
.br
 * secrets\-file:<filename>
.br
 * enforce[:[ssl3|1\&.0|1\&.1|1\&.2|1\&.3]] اجبار به استفاده از نگارش خاصی از SSL/TLS برای یک اتصال\&. برخی از سرورها دارای مذاکره نگارش TLS باگ‌دار هستند و ممکن است بدون این گزینه اتصال ناموفق باشد\&. در صورت عدم ارائه آرگومان، پیش‌فرض روی TLS 1\&.2 قرار می‌گیرد\&. برای windows 7 از 1\&.0 استفاده کنید
.RE
.PP
\fB\-toggle\-fullscreen\fR
.RS 4
کلید Alt+Ctrl+Enter برای تغییر وضعیت تمام‌صفحه (پیش‌فرض: on)
.RE
.PP
\fB/tune\fR:\fIsetting:value\fR,\fIsetting:value\fR
.RS 4
[آزمایشی] دستکاری مستقیم تنظیمات freerdp؛ با احتیاط بسیار زیاد استفاده شود! (پیش‌فرض:)
.RE
.PP
\fB/u\fR:[[\fIdomain\fR\]\fIuser\fR|\fIuser\fR[@\fIdomain\fR]]
.RS 4
نام کاربری
.RE
.PP
\fB+unmap\-buttons\fR
.RS 4
اجازه به سرور برای مشاهده دکمه فیزیکی واقعی اشاره‌گر (پیش‌فرض: off)
.RE
.PP
\fB/usb\fR:[dbg,][id:\fIvid\fR:\fIpid\fR#\&.\&.\&.,][addr:\fIbus\fR:\fIaddr\fR#\&.\&.\&.,][auto]
.RS 4
هدایت دستگاه USB
.RE
.PP
\fB/v\fR:\fIserver\fR[:port]
.RS 4
hostname|URL|IPv4|IPv6 سرور یا vsock://<number> یا /some/path/to/pipe یا |:1234 جهت ارسال یک سوکت TCP برای استفاده
.RE
.PP
\fB/vc\fR:\fIchannel\fR[,\fIoptions\fR]
.RS 4
کانال مجازی ایستا
.RE
.PP
\fB/version\fR
.RS 4
چاپ نسخه
.RE
.PP
\fB/video\fR
.RS 4
کانال ارتباط از راه دور بهینه‌شده برای ویدیو
.RE
.PP
\fB/prevent\-session\-lock\fR[:\fItime in sec\fR]
.RS 4
جلوگیری از قفل شدن نشست با تزریق رویدادهای ساختگی حرکت ماوس به سرور در زمان بیکار بودن اتصال (بازه زمانی پیش‌فرض: 180 ثانیه)
.RE
.PP
\fB/vmconnect\fR[:\fIvmid\fR]
.RS 4
کنسول Hyper\-V (استفاده از درگاه 2179، غیرفعال‌سازی مذاکره)
.RE
.PP
\fB/w\fR:\fIwidth\fR
.RS 4
عرض (پیش‌فرض: 1024)
.RE
.PP
\fB\-wallpaper\fR
.RS 4
تصویر پس‌زمینه (پیش‌فرض: on)
.RE
.PP
\fB+window\-drag\fR
.RS 4
کشیدن کامل پنجره (پیش‌فرض: off)
.RE
.PP
\fB/window\-position\fR:\fIxpos\fRx\fIypos\fR
.RS 4
موقعیت پنجره
.RE
.PP
\fB/wm\-class\fR:\fIclass\-name\fR
.RS 4
تنظیم راهنمای WM_CLASS برای نمونه پنجره
.RE
.PP
\fB/workarea\fR
.RS 4
استفاده از فضای کاری در دسترس
.RE.SH "کلیدهای میانبر (KEYBOARD SHORTCUTS)"
.PP
<Right CTRL>
.RS 4
تسخیر صفحه‌کلید و موشواره را رها می‌کند.
.br
اگر صفحه‌کلید در حالت تسخیر باشد، میانبرهای سامانهٔ محلی دیگر کار نکرده و به سامانهٔ دوردست ارسال می‌شوند.
.br
اگر موشواره تسخیر شده باشد (اختیاری)، تشخیص حرکات لمسی محلی کار نمی‌کند و ممکن است موشواره قادر به خروج از پنجرهٔ RDP نباشد. رویدادهای موشواره تغییر داده نمی‌شوند.
.RE
.PP
<CTRL>+<ALT>+<Return>
.RS 4
وضعیت تمام‌صفحهٔ برنامه را جابه‌جا می‌کند
.RE
.PP
<CTRL>+<ALT>+<m>
.RS 4
برنامه را کمینه می‌کند
.RE
.PP
<CTRL>+<ALT>+c
.RS 4
کنترل از راه دور را در یک نشست امداد از راه دور تغییر وضعیت می‌دهد
.RE
.PP
<CTRL>+<ALT>+<d>
.RS 4
ارتباط نشست را قطع کرده و برنامه را خاتمه می‌دهد
.RE
.PP
Action Script
.RS 4
با فشردن کلید، یک اسکریپت از پیش تعریف‌شده را اجرا می‌کند\&.
در صورتی که اسکریپت وجود نداشته باشد، نادیده گرفته می‌شود\&.
اسکریپت‌ها را می‌توان در مکان پیش‌فرض
\fI$XDG_CONFIG_HOME/freerdp/action\&.sh\fR
یا به عنوان آرگومان خط فرمان
\fI/action:script:<path>\fR
ارائه داد\&.
اسکریپت ترکیب کلید فعلی را به عنوان آرگومان دریافت خواهد کرد\&.
خروجی اسکریپت برای عبارت
\fIkey\-local\fR
پردازش می‌شود که نشان می‌دهد اسکریپت از ترکیب کلید استفاده کرده است، در غیر این صورت ترکیب کلید به سامانهٔ دوردست ارسال می‌شود\&.
.RE
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.PP
متغیرهای محیطی wlog
.RS 4
برنامهٔ xfreerdp3 از wLog به عنوان ابزار ثبت وقایع خود استفاده می‌کند؛ برای اطلاعات بیشتر می‌توانید به صفحهٔ راهنمای مربوطه (wlog(7)) مراجعه کنید\&. آرگومان‌های ارسال‌شده از طریق
\fI/log\-level\fR
یا
\fI/log\-filters\fR
بر متغیرهای محیطی ارجحیت دارند\&.
.br
.RE

.PP
FREERDP_ASKPASS
.RS 4
تنظیم برنامه‌ای برای درخواست گذرواژه، مشابه با \fISSH_ASKPASS\fR
.RE
.SH "پیکربندی سراسری (GLOBAL CONFIGURATION (client common))"
.PP
قالب و مکان:
.RS 4
فایل‌های پیکربندی در پیکربندی سراسری سامانه ذخیره می‌شوند\&.
.br

مکان مشترک تنظیمات گواهی
\fI/etc/FreeRDP/certificates\&.json\fR
است\&.
.br

قالب فایل JSON است
.RE
.PP
گزینه‌های پشتیبانی‌شده:
.RS 4
.PP
\fIdeny\fR
.RS 4
.PP
.RS 4
\fIJSON boolean\fR
.br

رد کردن گواهی در صورتی که بررسی در برابر مخزن SSL سامانه ناموفق باشد
.RE
.RE
.PP
\fIignore\fR
.RS 4
.PP
.RS 4
\fIJSON boolean\fR
.br

نادیده گرفتن خطاهای گواهی؛ صرفاً گواهی نادیده گرفته می‌شود
.RE
.RE
.PP
\fIdeny\-userconfig\fR
.RS 4
.PP
.RS 4
\fIJSON boolean\fR
.br

اگر بررسی‌ها در پیکربندی سراسری گواهی را تأیید نکنند، از کاربر سؤالی پرسیده نشود
.RE
.RE
.PP
\fIcertificate\-db\fR
.RS 4
.PP
\fIJSON array\fR
.RS 4
آرایه‌ای از
\fIJSON objects\fR
شامل:
.PP
\fItype\fR
.RS 4
\fIJSON string\fR
.br

رشته‌ای که الگوریتم درهم‌سازی استفاده‌شده را مشخص می‌کند، به عنوان مثال
\fIsha256\fR

.br

.RE
.PP
\fIhash\fR
.RS 4
\fIJSON string\fR
.br

رشته‌ای از مقادیر عددی صحیح در مبنای شانزده (hex) که نشان‌دهندهٔ درهم‌سازی گواهی هستند، به عنوان مثال
\fI0123456789abcdef\fR
.RE
.RE
.RE
.RE.SH "پیکربندی سراسری (کلاینت X11) (GLOBAL CONFIGURATION (X11 client))"
.PP
محل پیکربندی کلاینت X11 عبارت است از:
\fI/etc/FreeRDP/xfreerdp\&.json\fR
.br

قالب فایل JSON است
.RE
.PP
گزینه‌های پشتیبانی‌شده:
.RS 4
.PP
\fIisActionScriptAllowed\fR
.RS 4
.PP
.RS 4
\fIJSON boolean\fR
.br

مجاز کردن یا مسدود کردن اسکریپت‌های کنش. حالت پیش‌فرض (در صورت تنظیم نشدن گزینه) مجاز دانستن اسکریپت‌های کنش است.
.RE
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
.RS 4
.sp
.if n \{\
.RS 4
.\}
.nf
#!/bin/bash

# we got a key combination
if [ "$1" = "key" ];
then
	# we only got one argument \*(Aqkey\*(Aq
	# list all supported combinations with echo
	if [ $# \-eq 1 ];
	then
		echo "ctrl+alt+f1"
		echo "ctrl+alt+f2"
	else
		# We want the action for a single combination
		# use \*(Aqkey\-local\*(Aq to not forward to RDP session
		if [ "$2" = "ctrl+alt+f1" ];
		then
			echo "key\-local"
		fi
		if [ "$2" = "ctrl+alt+f2" ];
		then
				echo "/usr/local/bin/somescript\&.sh"
		fi
	fi
fi
if [ "$1" = "xevent" ];
	then
		if [ $# \-eq 1 ];
		then
			echo "FocusIn"
			echo "SelectionClear"
		else
			if [ "$2" = "SelectionNotify" ];
			then
				echo "/usr/local/bin/someprogram"
			fi
		fi
	fi
.fi
.if n \{\
.RE
.\}
نمونه اسکریپت کنش برای رویدادهای کلید، که مشخص می‌کند
\fIctrl+alt+f1\fR
توسط مدیر پنجرهٔ محلی مدیریت شود و
\fIctrl+alt+f2\fR
یک اسکریپت را اجرا کند
.sp
مقدار بازگشتی برنامه مشخص می‌کند که آیا کلید به‌صورت محلی مدیریت شود یا از راه دور (0 برای محلی، > 0 برای دوردست، < 0 برای خطاها)
.RE
.PP
\fBxfreerdp3 connection\&.rdp /p:Pwd123! /f\fR
.RS 4
اتصال در حالت تمام‌صفحه با استفاده از پیکربندی ذخیره‌شدهٔ
\fIconnection\&.rdp\fR
و گذرواژهٔ
\fIPwd123!\fR
.RE
.PP
\fBxfreerdp3 /u:USER /size:50%h /v:rdp\&.contoso\&.com\fR
.RS 4
اتصال به میزبان
\fIrdp\&.contoso\&.com\fR
با کاربر
\fIUSER\fR
و اندازه‌ای برابر با
\fI۵۰ درصد از ارتفاع\fR\&. اگر به جای ارتفاع (h) پهنا (w) مانند /size:50%w تنظیم شود\&. ۵۰ درصد از پهنا استفاده می‌شود\&.
.RE
.PP
\fBxfreerdp3 /u:CONTOSO\e\eJohnDoe /p:Pwd123! /v:rdp\&.contoso\&.com\fR
.RS 4
اتصال به میزبان
\fIrdp\&.contoso\&.com\fR
با کاربر
\fICONTOSO\e\eJohnDoe\fR
و گذرواژهٔ
\fIPwd123!\fR
.RE
.PP
\fBxfreerdp3 /u:JohnDoe /p:Pwd123! /w:1366 /h:768 /v:192\&.168\&.1\&.100:4489\fR
.RS 4
اتصال به میزبان
\fI192\&.168\&.1\&.100\fR
روی درگاه
\fI4489\fR
با کاربر
\fIJohnDoe\fR، گذرواژهٔ
\fIPwd123!\fR\&. پهنای صفحه روی
\fI1366\fR
و ارتفاع آن روی
\fI768\fR
تنظیم شده است\&.
.RE
.PP
\fBxfreerdp3 /u:JohnDoe /p:Pwd123! /vmconnect:C824F53E\-95D2\-46C6\-9A18\-23A5BB403532 /v:192\&.168\&.1\&.100\fR
.RS 4
برقراری ارتباط با میزبان
\fI192\&.168\&.1\&.100\fR
با کاربر
\fIJohnDoe\fR، گذرواژهٔ
\fIPwd123!\fR
و اتصال به کنسول Hyper\-V (استفاده از درگاه 2179، غیرفعال‌سازی مذاکره) با شناسهٔ ماشین مجازی
\fIC824F53E\-95D2\-46C6\-9A18\-23A5BB403532\fR
.RE
.PP
\fB+clipboard\fR
.RS 4
فعال‌سازی بازهدایت کلیپ‌بورد
.RE
.PP
\fB/drive:home,/home/user\fR
.RS 4
فعال‌سازی بازهدایت درایو
\fI/home/user\fR
به عنوان درایو خانه (home)
.RE
.PP
\fB/smartcard:<device>\fR
.RS 4
فعال‌سازی بازهدایت کارت هوشمند برای دستگاه
\fIdevice\fR
.RE
.PP
\fB/printer:<device>,<driver>\fR
.RS 4
فعال‌سازی بازهدایت چاپگر برای چاپگر
\fIdevice\fR
با استفاده از درایور
\fIdriver\fR
.RE
.PP
\fB/serial:<device>\fR
.RS 4
فعال‌سازی بازهدایت درگاه سریال برای درگاه
\fIdevice\fR
.RE
.PP
\fB/parallel:<device>\fR
.RS 4
فعال‌سازی بازهدایت درگاه موازی برای درگاه
\fIdevice\fR
.RE
.PP
\fB/sound:sys:alsa\fR
.RS 4
فعال‌سازی بازهدایت خروجی صوتی با استفاده از دستگاه
\fIsys:alsa\fR
.RE
.PP
\fB/microphone:sys:alsa\fR
.RS 4
فعال‌سازی بازهدایت ورودی صوتی با استفاده از دستگاه
\fIsys:alsa\fR
.RE
.PP
\fB/multimedia:sys:alsa\fR
.RS 4
فعال‌سازی بازهدایت چندرسانه‌ای با استفاده از دستگاه
\fIsys:alsa\fR
.RE
.PP
\fB/usb:id,dev:054c:0268\fR
.RS 4
فعال‌سازی بازهدایت دستگاه USB برای دستگاه مشخص‌شده با
\fI054c:0268\fR
.RE
.PP
\fB/kbd:remap:29=58,remap:58=29\fR
.RS 4
جابه‌جایی کلید Control چپ (\
\fI29\fR\
) و Caps Lock (\
\fI58\fR\
).
.RE.SH "پیوندها (LINKS)"
.PP
\m[blue]\fBhttp://www\&.freerdp\&.com\fR\m[]
.SH "نویسندگان (AUTHORS)"
.br
.PP
تیم FreeRDP