.TH "sdl-freerdp3" "1" "2026-09-03" "freerdp" "sdl-freerdp3"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.SH "نام (NAME)"
sdl-freerdp3 \- کلاینت SDL برای FreeRDP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBsdl-freerdp3\fR
[file] [options] [/v:server[:port]]
.SH "توضیحات (DESCRIPTION)"
.PP
برنامهٔ \fBsdl-freerdp3\fR یک کلاینت پروتکل میزکار از راه دور (RDP) مبتنی بر SDL است که بخشی از پروژهٔ 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
برنامهٔ کاربردی از راه دور
.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> جایگزین به جای موضوع (subject) گواهی برای تطبیق با گواهی‌های ذخیره‌شده محلی
.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,* فعال می‌شود\&. این آرگومان عملکردی مشابه گزینهٔ "Drives that I plug in later" در 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
کانال مجازی پویا (DVC)
.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
رمزنگاری (آزمایشی) (پیش‌فرض: فعال)
.RE
.PP
\fB/encryption\-methods\fR:[40,][56,][128,][FIPS]
.RS 4
روش‌های رمزنگاری امنیت استاندارد RDP
.RE
.PP
\fB/endpointfedauth\fR:\fItoken\fR
.RS 4
توکن Endpoint FedAuth برای سناریوهای اتصال به کنسول ماشین مجازی Hyper\-V
.RE
.PP
\fB/f\fR
.RS 4
حالت تمام‌صفحه (<Ctrl>+<Alt>+<Enter> وضعیت تمام‌صفحه را تغییر می‌دهد)
.RE
.PP
\fB+fipsmode\fR
.RS 4
حالت FIPS (پیش‌فرض: غیرفعال)
.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) (پیش‌فرض: فعال)
.RE
.PP
\fB+force\-console\-callbacks\fR
.RS 4
استفاده از کال‌بک‌های پیش‌فرض (کنسول) برای گواهی/اعتبارنامه/\&.\&.\&. (پیش‌فرض: غیرفعال)
.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
پردازش ورودی لمس چندگانه به‌صورت محلی (پیش‌فرض: غیرفعال)
.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
در دست گرفتن فوکوس صفحه‌کلید، ارسال تمام کلیدها به سیستم راه دور (پیش‌فرض: فعال)
.RE
.PP
\fB\-grab\-mouse\fR
.RS 4
در دست گرفتن فوکوس ماوس، ارسال تمام رویدادها به سیستم راه دور (پیش‌فرض: فعال)
.RE
.PP
\fB/h\fR:\fIheight\fR
.RS 4
ارتفاع (پیش‌فرض: 768)
.RE
.PP
\fB\-heartbeat\fR
.RS 4
پشتیبانی از PDUهای heartbeat (پیش‌فرض: فعال)
.RE
.PP
\fB/help\fR, \fB/?\fR
.RS 4
نمایش راهنما
.RE
.PP
\fB+home\-drive\fR
.RS 4
هدایت پوشه خانگی کاربر به‌عنوان یک اشتراک (پیش‌فرض: غیرفعال)
.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 key)
.br
 * remap: نگاشت یک scancode در RDP به دیگری\&. برای دریافت فهرست نگاشت‌ها از /list:kbd\-scancode استفاده کنید\&. مثال: برای جابه‌جایی \*(Aqa\*(Aq و \*(Aqs\*(Aq در یک صفحه‌کلید US: /kbd:remap:0x1e=0x1f,remap:0x1f=0x1e
.br
 * pipe: نام یک 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
فهرست کردن گزینه‌های موجود برای زیرفرمان (پیش‌فرض: فهرست کردن گزینه‌های موجود برای زیرفرمان)
.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
پویانمایی‌های منو (پیش‌فرض: غیرفعال)
.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
بازهدایت دستگاه موازی (parallel)
.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
تنظیمات پروکسی: بازنویسی متغیر محیطی (همچنین بخش متغیرهای محیطی در زیر را ببینید)\&. پروتکل "socks5" باید به‌طور صریح مشخص شود، در حالی که "http" پیش‌فرض است\&.
.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
ضریب مقیاس‌بندی برای برنامه‌های فروشگاه برنامه (پیش‌فرض: 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
نام میزبان سرور|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 "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.PP
متغیرهای محیطی wlog
.RS 4
برنامه sdl-freerdp3 از wLog به عنوان امکانات لاگ‌گیری خود استفاده می‌کند؛ برای اطلاعات بیشتر می‌توانید به صفحه راهنمای مربوطه (wlog(7)) مراجعه کنید\&. آرگومان‌های ارسال‌شده از طریق
\fI/log\-level\fR
یا
\fI/log\-filters\fR
بر متغیرهای محیطی اولویت دارند\&.
.br
.RE

.PP
FREERDP_ASKPASS
.RS 4
برنامه‌ای را برای درخواست گذرواژه‌ها، مشابه \fISSH_ASKPASS\fR تعیین می‌کند\&.
.RE
.PP
FREERDP_WLROOTS_HACK
.RS 4
در صورت تعریف به صورت \fI0\fR، ترفند تشخیص چندنمایشگره را کاملاً غیرفعال می‌کند. برای فعال‌سازی آن در نشست‌های تمام‌صفحه روی \fI1\fR تنظیم کنید. برای فعال‌سازی در تمام نشست‌ها روی \fIforce\fR تنظیم کنید.
.br
\fIهشدار:\fR تنظیم مقدار \fIforce\fR تنها برای نشست‌های تمام‌صفحه یا چندنمایشگره کار می‌کند؛ نشست‌های پنجره‌ای رفتار نادرستی از خود نشان خواهند داد!
.br
به طور پیش‌فرض، با ارزیابی \fIXDG_SESSION_DESKTOP\fR و \fIXDG_CURRENT_DESKTOP\fR به تشخیص sway یا سایر کامپوزیتورهای مبتنی بر wlroots رجوع می‌شود.
.br
.br
دلیل منطقی: کامپوزیتورهای مبتنی بر wlroots اطلاعات نمایشگر را به پنجره‌های نامرئی ارائه نمی‌دهند، بنابراین روش مناسبی برای استعلام چیدمان فعلی مانیتورها وجود ندارد.
.br
با فعال بودن این ترفند، روش جایگزین در پیش گرفته شده و تلاش می‌شود تفکیک‌پذیری‌ها از طریق استعلام جزئیات مقیاس‌بندی و تفکیک‌پذیری نمایشگر که قابلیت اطمینان کمتری دارند، تعیین شوند.
.RE
.SH "فایل پیکربندی (CONFIGURATION FILE)"
.PP
قالب و مکان:
.RS 4
فایل پیکربندی به ازای هر کاربر ذخیره می‌شود\&.
.br

متغیر محیطی
\fIXDG_CONFIG_HOME\fR
می‌تواند برای تغییر دایرکتوری پایه استفاده شود\&.
.br

مقدار پیش‌فرض آن
\fI~/\&.config\fR
است. مکان فایل نسبت به
\fIXDG_CONFIG_HOME\fR
برابر است با
\fI$XDG_CONFIG_HOME/freerdp/sdl\-freerdp\&.json\fR
.br

پیکربندی در قالب JSON ذخیره می‌شود\&.
.RE
.PP
گزینه‌های پشتیبانی‌شده:
.RS 4
.PP
\fISDL_KeyModMask\fR
.RS 4
.PP
.RS 4
ترکیب کلیدهای مورد نیاز برای کلیدهای میانبر کلاینت SDL را تعریف می‌کند\&.
.br

پیش‌فرض
\fIKMOD_RSHIFT\fR
.br

آرایه‌ای از رشته‌های
\fISDL_Keymod\fR
همان‌طور که در
\fIhttps://wiki.libsdl.org/SDL3/SDL_Keymod\fR
تعریف شده است\&.
.br
برای غیرفعال کردن کلیدهای میانبر از \fRKEYMOD_NONE\fR استفاده کنید
.RE
.RE
.PP
\fISDL_Fullscreen\fR
.RS 4
.PP
.RS 4
حالت تمام‌صفحه کلاینت را تغییر می‌دهد\&.
.br

پیش‌فرض
\fISDL_SCANCODE_RETURN\fR\&.
.br

رشته‌ای همان‌طور که در
\fIhttps://wiki.libsdl.org/SDL3/SDL_Scancode\fR
تعریف شده است\&.
.RE
.RE
.PP
\fISDL_Minimize\fR
.RS 4
.PP
.RS 4
پنجره کلاینت را کمینه می‌کند
.br

پیش‌فرض
\fISDL_SCANCODE_M\fR\&.
.br

رشته‌ای همان‌طور که در
\fIhttps://wiki.libsdl.org/SDL3/SDL_Scancode\fR
تعریف شده است\&.
.RE
.RE
.PP
\fISDL_Resizeable\fR
.RS 4
.PP
.RS 4
وضعیت تغییرپذیری اندازه پنجره محلی را تغییر می‌دهد\&.
.br

پیش‌فرض
\fISDL_SCANCODE_R\fR\&.
.br

رشته‌ای همان‌طور که در
\fIhttps://wiki.libsdl.org/SDL3/SDL_Scancode\fR
تعریف شده است\&.
.RE
.RE
.PP
\fISDL_Grab\fR
.RS 4
.PP
.RS 4
وضعیت تصاحب صفحه‌کلید و موشواره را تغییر می‌دهد.
.br
اگر صفحه‌کلید تصاحب شود، کلیدهای میانبر سیستم محلی دیگر کار نکرده و به سیستم راه دور ارسال می‌شوند.
.br
اگر موشواره تصاحب شود (اختیاری)، تشخیص اشاره‌های حرکتی محلی کار نمی‌کند و ممکن است موشواره نتواند از پنجره RDP خارج شود. رویدادهای موشواره دست‌نخورده باقی می‌مانند\&.
.br

پیش‌فرض
\fISDL_SCANCODE_G\fR\&.
.br

رشته‌ای همان‌طور که در
\fIhttps://wiki.libsdl.org/SDL3/SDL_Scancode\fR
تعریف شده است\&.
.RE
.RE
.PP
\fISDL_Disconnect\fR
.RS 4
.PP
.RS 4
اتصال از نشست RDP را قطع می‌کند\&.
.br

پیش‌فرض
\fISDL_SCANCODE_D\fR\&.
.br

رشته‌ای همان‌طور که در
\fIhttps://wiki.libsdl.org/SDL3/SDL_Scancode\fR
تعریف شده است\&.
.RE
.RE
.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

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

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

مجاز یا مسدود کردن پشتیبانی از فایل پیکربندی به ازای هر کاربر.
.RE
.RE
.PP
تمام گزینه‌های سطح کاربر از \fBCONFIGURATION FILE\fR نیز می‌توانند در اینجا تنظیم شوند
.SH "مثال‌ها (EXAMPLES)"
.PP
\fBsdl-freerdp3 connection\&.rdp /p:Pwd123! /f\fR
.RS 4
اتصال در حالت تمام‌صفحه با استفاده از پیکربندی ذخیره‌شدهٔ
\fIconnection\&.rdp\fR
و گذرواژهٔ
\fIPwd123!\fR
.RE
.PP
\fBsdl-freerdp3 /u:USER /size:50%h /v:rdp\&.contoso\&.com\fR
.RS 4
اتصال به میزبان
\fIrdp\&.contoso\&.com\fR
با کاربر
\fIUSER\fR
و اندازه‌ای برابر با
\fI50 درصد از ارتفاع\fR\&. اگر به جای ارتفاع (h)، عرض (w) مانند /size:50%w تنظیم شود\&. 50 درصد از عرض استفاده می‌شود\&.
.RE
.PP
\fBsdl-freerdp3 /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
\fBsdl-freerdp3 /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
\fBsdl-freerdp3 /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، غیرفعال‌سازی مذاکره) با شناسه ماشین مجازی (VMID)
\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
.SH "پیوندها (LINKS)"
.PP
\m[blue]\fBhttp://www\&.freerdp\&.com\fR\m[]
.SH "نویسندگان (AUTHORS)"
.br
.PP
تیم FreeRDP