xfreerdp3(1) xfreerdp3 xfreerdp3(1) نام (NAME) xfreerdp3 - کلاینت X11 برای FreeRDP خلاصه دستور (SYNOPSIS) xfreerdp3 [file] [options] [/v:server[:port]] توضیحات (DESCRIPTION) xfreerdp3 یک کلاینت پروتکل میزکار از راه دور (RDP) تحت سامانه پنجره‌بندی X11 است که بخشی از پروژه FreeRDP به شمار می‌رود. سرور RDP به صورت پیش‌ساخته در بسیاری از نسخه‌های Windows تعبیه شده است. سرورهای جایگزین شامل ogon، gnome-remote-desktop، xrdp و VRDP (در VirtualBox) هستند. گزینه‌ها (OPTIONS) /a:addin[,options], /addin:addin[,options] افزونه (Addin) /azure:[tenantid:id],[use-tenantid[:[on|off]],[ad:url][avd-access:format string],[avd-token:format string],[avd-scope:format string] گزینه‌های AzureAD /action-script:file-name اسکریپت اقدام (پیش‌فرض:~/.config/freerdp/action.sh) /admin, /console نشست مدیریتی (یا کنسول) +aero ترکیب پنجره‌های میزکار (desktop composition) (پیش‌فرض:off) /app:program:[path|||alias],cmd:command,file:filename,guid:guid,icon:filename,name:name,workdir:directory,hidef:[on|off] برنامه کاربردی راه دور (Remote application) /assistance:password گذرواژه کمک از راه دور (Remote assistance) /auto-request-control: درخواست خودکار کنترل ورودی برای کمک از راه دور +async-channels کانال‌های ناهمگام (آزمایشی) (پیش‌فرض:off) +async-update به‌روزرسانی ناهمگام (پیش‌فرض:off) /audio-mode:[[none|2]|[server|1]|[redirect|0]] حالت خروجی صوتی +auth-only فقط احراز هویت (پیش‌فرض:off) /auth-pkg-list:[[none],]!ntlm,kerberos,!u2u فیلتر بسته‌های احراز هویت (فهرست جداشده با کاما، استفاده از '!' برای غیرفعال‌سازی). به طور پیش‌فرض همه روش‌ها فعال هستند. استفاده از مقدار صریح 'none' به عنوان اولین آرگومان تمام روش‌ها را غیرفعال کرده و تنها مواردی که پس از آن می‌آیند فعال می‌شوند. -authentication احراز هویت (آزمایشی) (پیش‌فرض:on) +auto-reconnect اتصال مجدد خودکار (پیش‌فرض:off) /auto-reconnect-max-retries:retries حداکثر تلاش‌ها برای اتصال مجدد خودکار، مقدار 0 برای نامحدود [0,1000] /bpp:depth عمق رنگ نشست یا bpp (پیش‌فرض:16) /buildconfig چاپ پیکربندی ساخت نرم‌افزار /cache:[bitmap[:on|off],codec[:rfx|nsc],glyph[:on|off],offscreen[:on|off],persist,persist-file:filename] /cert:[deny,ignore,name:name,tofu,fingerprint:hash:hash as hex[,fingerprint:hash:another hash]] گزینه‌های پذیرش گواهی‌نامه. با احتیاط استفاده شود! * deny ... قطع خودکار اتصال در صورت عدم تطابق گواهی‌نامه، بدون دخالت کاربر. * ignore ... نادیده گرفتن کلی بررسی‌های گواهی‌نامه (بر تمام گزینه‌های دیگر اولویت دارد). * name ... استفاده از جایگزین به جای موضوع گواهی‌نامه جهت تطبیق با گواهی‌نامه‌های محلی ذخیره‌شده. * tofu ... پذیرش بدون قید و شرط گواهی‌نامه در نخستین اتصال و رد آن در اتصالات بعدی در صورت عدم تطابق. * fingerprints ... فهرستی از هش‌های گواهی‌نامه که بدون قید و شرط برای اتصال پذیرفته می‌شوند. /client-build-number:number شماره ساخت کلاینت ارسالی به سرور (بر رفتار کارت هوشمند تأثیر می‌گذارد، [MS-RDPESC] را ببینید) /client-hostname:name نام میزبان کلاینت برای ارسال به سرور /clipboard:[[use-selection:atom],[direction-to:[all|local|remote|off]],[files-to[:all|local|remote|off]]] بازهدایت کلیپ‌بورد: * use-selection: ... (در X11) مشخص کردن گزینش X برای دسترسی. پیش‌فرض CLIPBOARD است. مقدار PRIMARY گزینش به سبک کلیک میانی در X است. * direction-to:[all|local|remote|off] کنترل جهت فعال انتقال کلیپ‌بورد * files-to:[all|local|remote|off] کنترل جهت فعال انتقال فایل‌ها در کلیپ‌بورد (پیش‌فرض:on) -compression, -z فشرده‌سازی (پیش‌فرض:on) /compression-level:level سطح فشرده‌سازی (0,1,2) +credentials-delegation واگذاری اطلاعات کاربری (پیش‌فرض:off) /d:domain دامنه (Domain) -decorations تزیینات پنجره (پیش‌فرض:on) /disp کنترل نمایشگر /drive:name,path بازهدایت مسیر پوشه به عنوان یک اشتراک نام‌گذاری‌شده با عنوان . پشتیبانی از اتصال حین کار با /drive:hotplug,* فعال می‌شود. این آرگومان عملکردی مشابه گزینه “Drives that I plug in later” در ابزار MSTSC ارائه می‌دهد. +drives بازهدایت همه نقاط اتصال به عنوان اشتراک (پیش‌فرض:off) /dump:record|replay,file:file[,nodelay] ضبط یا بازپخش دامپ /dvc:channel[,options] کانال مجازی پویا (Dynamic virtual channel) +dynamic-resolution ارسال به‌روزرسانی‌های وضوح تصویر به هنگام تغییر اندازه پنجره (پیش‌فرض:off) /echo, /echo کانال Echo -encryption رمزنگاری (آزمایشی) (پیش‌فرض: on) /encryption-methods:[40,][56,][128,][FIPS] روش‌های رمزنگاری امنیت استاندارد RDP /endpointfedauth:token توکن FedAuth نقطه پایانی برای سناریوهای اتصال به کنسول ماشین مجازی Hyper-V /f حالت تمام‌صفحه (++ وضعیت تمام‌صفحه را تغییر می‌دهد) +fipsmode حالت FIPS (پیش‌فرض: off) /floatbar[:sticky:[on|off],default:[visible|hidden],show:[always|fullscreen|window]] نوار شناور (floatbar) به‌طور پیش‌فرض غیرفعال است (در صورت فعال‌سازی، به‌طور پیش‌فرض در حالت تمام‌صفحه چسبان/sticky است) -fonts فونت‌های هموار (ClearType) (پیش‌فرض: on) +force-console-callbacks استفاده از فراخوانی‌های بازگشتی پیش‌فرض (کنسول) برای گواهی/اعتبارنامه/... (پیش‌فرض: off) /frame-ack:number تعداد تأییدیه‌های فریم (frame acknowledgement) /args-from:file:file|stdin|fd:number|env:name خواندن خط فرمان از یک فایل، stdin یا توصیف‌گر فایل (file descriptor). این آرگومان نمی‌تواند با هیچ آرگومان دیگری ترکیب شود. در هر خط یک آرگومان وارد کنید. /from-stdin[:force] خواندن اطلاعات احراز هویت از stdin. با درخواست قبل از اتصال انجام می‌شود، در غیر این صورت به درخواست سرور خواهد بود. /gateway:g:gateway[:port],u:user,d:domain,p:password,usage-method:[direct|detect],access-token:token,type:[rpc|http[,no-websockets][,extauth-sspi-ntlm]|auto[,no-websockets][,extauth-sspi-ntlm]]|arm,url:wss://url,bearer:oauth2-bearer-token, /gw:g:gateway[:port],u:user,d:domain,p:password,usage-method:[direct|detect],access-token:token,type:[rpc|http[,no-websockets][,extauth-sspi-ntlm]|auto[,no-websockets][,extauth-sspi-ntlm]]|arm,url:wss://url,bearer:oauth2-bearer-token نام میزبان Gateway /gdi:sw|hw رندرینگ GDI /geometry کانال ردیابی هندسه (Geometry) +gestures پردازش ورودی چندلمسی به‌صورت محلی (پیش‌فرض: off) /gfx[:[[progressive[:on|off]|RFX[:on|off]|AVC420[:on|off]AVC444[:on|off]],mask:value,small-cache[:on|off],thin-client[:on|off],progressive[:on|off],frame-ack[:on|off]] خط لوله گرافیکی RDP8 -grab-keyboard تسخیر فوکوس صفحه‌کلید، هدایت تمام کلیدها به سیستم راه دور (پیش‌فرض: on) -grab-mouse تسخیر فوکوس موشواره، هدایت تمام رویدادها به سیستم راه دور (پیش‌فرض: on) /h:height ارتفاع (پیش‌فرض: 768) -heartbeat پشتیبانی از PDUهای ضربان قلب (heartbeat) (پیش‌فرض: on) /help, /? نمایش راهنما +home-drive هدایت دایرکتوری خانگی کاربر به‌عنوان اشتراک (پیش‌فرض: off) /ipv4[:[:force]], /4[:[:force]] اولویت دادن به رکورد A در IPv4 نسبت به رکورد AAAA در IPv6 /ipv6[:[:force]], /6[:[:force]] اولویت دادن به رکورد AAAA در IPv6 نسبت به رکورد A در IPv4 /jpeg پشتیبانی از کُدک JPEG /jpeg-quality:percentage کیفیت JPEG /kbd:[layout:[0xid|name],lang:0xid,fn-key:value,type:value,subtype:value,unicode[:on|off],remap:key1=value1,remap:key2=value2,pipe:filename] گزینه‌های مربوط به صفحه‌کلید: * layout: تنظیم طرح‌بندی صفحه‌کلید اعلان‌شده به سرور * lang: تنظیم شناسه زبان صفحه‌کلید ارسالی به سرور * fn-key: مقدار کلید Function * remap: بازنگاشت اسکن‌کد RDP به مقداری دیگر. برای دریافت نگاشت‌ها از /list:kbd-scancode استفاده کنید. مثال: برای جابه‌جایی 'a' و 's' روی یک صفحه‌کلید آمریکایی (US): /kbd:remap:0x1e=0x1f,remap:0x1f=0x1e * pipe: نام یک لوله نام‌گذاری‌شده (named pipe) که می‌تواند برای نوشتن متن در نشست RDP به کار رود /kerberos:[kdc-url:url,lifetime:time,start-time:time,renewable-lifetime:time,cache:path,armor:path,pkinit-anchors:path,pkcs11-module:name] گزینه‌های Kerberos /load-balance-info:info-string اطلاعات توازن بار (Load balance info) /list:[kbd|kbd-scancode|kbd-lang[:value]|smartcard[:[pkinit-anchors:path][,pkcs11-module:name]]|monitor|tune|timezones] فهرست کردن گزینه‌های موجود برای زیرفرمان (پیش‌فرض: List available options for subcommand) /log-filters:tag:level[,tag:level[,...]] تنظیم فیلترهای ثبت وقایع، برای جزئیات wLog(7) را ببینید /log-level:[OFF|FATAL|ERROR|WARN|INFO|DEBUG|TRACE] تنظیم سطح پیش‌فرض گزارش‌گیری، برای جزئیات wLog(7) را ببینید /max-fast-path-size:size تعیین حداکثر اندازه به‌روزرسانی fast-path /max-loop-time:time تعیین حداکثر زمان برحسب میلی‌ثانیه برای پردازش بسته‌ها +menu-anims پویانمایی‌های منو (پیش‌فرض: off) /microphone[:[sys:sys,][dev:dev,][format:format,][rate:rate,][channel:channel]], /mic[:[sys:sys,][dev:dev,][format:format,][rate:rate,][channel:channel]] ورودی صدا (میکروفون) /monitors:id[,id[,...]] [آزمایشی] انتخاب نمایشگرها جهت استفاده (تنها در حالت تمام‌صفحه یا چندنمایشگره مؤثر است) -mouse-motion ارسال رویدادهای حرکت ماوس (پیش‌فرض: on) +mouse-relative ارسال حرکت ماوس با آدرس‌دهی نسبی (پیش‌فرض: off) /mouse:[relative:[on|off],grab:[on|off]] گزینه‌های مربوط به ماوس: * relative: ارسال حرکات نسبی ماوس در صورت پشتیبانی سرور * grab: به دام انداختن ماوس در صورت قرار داشتن در پنجره /multimon[:force] استفاده از چند نمایشگر +multitouch بازهدایت ورودی چندلمسی (پیش‌فرض: off) -multitransport پشتیبانی از پروتکل multitransport (پیش‌فرض: on) -nego مذاکره امنیتی پروتکل (پیش‌فرض: on) /network:[invalid|modem|broadband|broadband-low|broadband-high|wan|lan|auto] نوع اتصال شبکه /nsc, /nscodec پشتیبانی از NSCodec /orientation:[0|90|180|270] جهت‌گیری نمایشگر بر حسب درجه +old-license استفاده از جریان کاری قدیمی مجوز (بدون CAL و با تنظیم hwId روی 0) (پیش‌فرض: off) /p[:password] گذرواژه. ارسال /p بدون آرگومان در صورتی که نیازی به اطلاعات کاربری برای اتصال نباشد، اعلان‌های تعاملی گذرواژه را غیرفعال می‌کند. /parallel[:name[,path]] بازهدایت دستگاه موازی /parent-window:window-id شناسه پنجره والد /pcb:blob داده باینری پیش‌اتصال (Preconnection Blob) /pcid:id شناسه پیش‌اتصال (Preconnection Id) /pheight:height ارتفاع فیزیکی نمایشگر (به میلی‌متر) /play-rfx:pcap-file پخش مجدد فایل pcap مربوط به rfx /port:number پورت سرور -suppress-output فرونشانی خروجی هنگام کمینه‌شدن (پیش‌فرض: on) +print-reconnect-cookie چاپ کوکی اتصال مجدد base64 پس از اتصال (پیش‌فرض: off) /printer[:name[,driver[,default]]] بازهدایت دستگاه چاپگر /proxy:[proto://][user:password@]host[:port] تنظیمات پروکسی: نادیده‌گرفتن متغیر محیطی (همچنین متغیر محیطی زیر را ببینید). در حالی که "http" پیش‌فرض است، پروتکل "socks5" باید صریحاً مشخص شود. /pth:password-hash, /pass-the-hash:password-hash روش Pass the hash (حالت مدیر محدودشده) /pwidth:width عرض فیزیکی نمایشگر (به میلی‌متر) /rdp2tcp:executable path[:arg...] بازهدایت TCP /reconnect-cookie:base64-cookie ارسال کوکی اتصال مجدد base64 به اتصال /redirect-prefer:FQDN|IP|NETBIOS,[...] بازنویسی ترتیب اولویت بازهدایت /relax-order-checks, /relax-order-checks بررسی نکردن اعلان شدن دستور RDP در حین تبادل قابلیت‌ها؛ تنها هنگام اتصال به سرورهای دارای باگ استفاده شود /restricted-admin, /restrictedAdmin حالت مدیر محدودشده (Restricted admin) /rfx RemoteFX /rfx-mode:[image|video] حالت RemoteFX /scale:[100|140|180] ضریب مقیاس‌بندی نمایشگر (پیش‌فرض: 100) /scale-desktop:percentage ضریب مقیاس‌بندی برای برنامه‌های میزکار (مقداری بین 100 و 500) (پیش‌فرض: 100) /scale-device:100|140|180 ضریب مقیاس‌بندی برای برنامه‌های app store (پیش‌فرض: 100) /sec:rdp[:[on|off]]|tls[:[on|off]]|nla[:[on|off]]|ext[:[on|off]]|aad[:[on|off]] اجبار امنیت پروتکل مشخص. به عنوان مثال /sec:nla پروتکل NLA را فعال و سایر موارد را غیرفعال می‌کند، در حالی که /sec:nla:[on|off] صرفاً وضعیت NLA را تغییر می‌دهد /serial[:name[,path[,driver[,permissive]]]], /tty[:name[,path[,driver[,permissive]]]] بازهدایت دستگاه سریال /server-name:name نام سرور تعیین‌شده توسط کاربر جهت اعتبارسنجی (TLS, Kerberos) /shell:shell پوسته جایگزین /shell-dir:dir دایرکتوری کاری پوسته /size:widthxheight یا percent%[wh] اندازه صفحه نمایش (پیش‌فرض: 1024x768) /smart-sizing[:widthxheight] مقیاس‌بندی میزکار دوردست به اندازه پنجره /smartcard[:str[,str...]] هدایت دستگاه‌های کارت هوشمند که نام آن‌ها حاوی هر یک از باشد. /smartcard-logon[:[[cert:path|cert:base64(PEM)],[key:path|key:base64(PEM)],pin:pin,csp:csp name,reader:reader,card:card]] احراز هویت ورود به سیستم با کارت هوشمند (گواهی اختیاری) را فعال می‌کند. /sound[:[sys:sys,][dev:dev,][format:format,][rate:rate,][channel:channel,][latency:latency,][quality:quality]], /audio[:[sys:sys,][dev:dev,][format:format,][rate:rate,][channel:channel,][latency:latency,][quality:quality]] خروجی صدا (صوت) /span گسترش صفحه نمایش روی چند نمایشگر /spn-class:service-class کلاس سرویس احراز هویت SPN /ssh-agent, /ssh-agent کانال فورواردینگ SSH Agent /sspi-module:SSPI module path مسیر فایل ماژول کتابخانه اشتراکی SSPI /winscard-module:WinSCard module path مسیر فایل ماژول کتابخانه اشتراکی WinSCard /disable-output غیرفعال‌سازی کلیه رمزگشایی‌های گرافیکی در نشست کلاینت. برای آزمون‌های بار با اتصالات هم‌زمان متعدد کاربرد دارد /t:title, /title:title عنوان پنجره -themes تم‌ها (پیش‌فرض: on) /timeout:time in ms, /timeout:time in ms تنظیمات پیشرفته برای پیوندهای با تاخیر بالا: تنظیم مهلت زمانی اتصال؛ در صورت مواجهه با خطای مهلت زمانی در اتصال خود از آن استفاده کنید (پیش‌فرض: 9000) /timezone:windows timezone استفاده از منطقه زمانی ویندوزی ارائه‌شده برای اتصال (نیازمند پشتیبانی سرور است)؛ برای مقادیر مجاز /list:timezones را ببینید /tls:[ciphers|seclevel|secrets-file|enforce] گزینه‌های پیکربندی TLS: * ciphers:[netmon|ma|] * seclevel:، پیش‌فرض: 1، بازه: [0-5] بازنویسی سطح امنیت پیش‌فرض TLS، ممکن است برای سرورهای مقصد قدیمی‌تر مورد نیاز باشد. جزئیات در https://docs.openssl.org/3.0/man3/SSL_CTX_set_security_level * secrets-file: * enforce[:[ssl3|1.0|1.1|1.2|1.3]] اجبار به استفاده از نگارش خاصی از SSL/TLS برای یک اتصال. برخی از سرورها دارای مذاکره نگارش TLS باگ‌دار هستند و ممکن است بدون این گزینه اتصال ناموفق باشد. در صورت عدم ارائه آرگومان، پیش‌فرض روی TLS 1.2 قرار می‌گیرد. برای windows 7 از 1.0 استفاده کنید -toggle-fullscreen کلید Alt+Ctrl+Enter برای تغییر وضعیت تمام‌صفحه (پیش‌فرض: on) /tune:setting:value,setting:value [آزمایشی] دستکاری مستقیم تنظیمات freerdp؛ با احتیاط بسیار زیاد استفاده شود! (پیش‌فرض:) /u:[[domain]user|user[@domain]] نام کاربری +unmap-buttons اجازه به سرور برای مشاهده دکمه فیزیکی واقعی اشاره‌گر (پیش‌فرض: off) /usb:[dbg,][id:vid:pid#...,][addr:bus:addr#...,][auto] هدایت دستگاه USB /v:server[:port] hostname|URL|IPv4|IPv6 سرور یا vsock:// یا /some/path/to/pipe یا |:1234 جهت ارسال یک سوکت TCP برای استفاده /vc:channel[,options] کانال مجازی ایستا /version چاپ نسخه /video کانال ارتباط از راه دور بهینه‌شده برای ویدیو /prevent-session-lock[:time in sec] جلوگیری از قفل شدن نشست با تزریق رویدادهای ساختگی حرکت ماوس به سرور در زمان بیکار بودن اتصال (بازه زمانی پیش‌فرض: 180 ثانیه) /vmconnect[:vmid] کنسول Hyper-V (استفاده از درگاه 2179، غیرفعال‌سازی مذاکره) /w:width عرض (پیش‌فرض: 1024) -wallpaper تصویر پس‌زمینه (پیش‌فرض: on) +window-drag کشیدن کامل پنجره (پیش‌فرض: off) /window-position:xposxypos موقعیت پنجره /wm-class:class-name تنظیم راهنمای WM_CLASS برای نمونه پنجره /workarea استفاده از فضای کاری در دسترس تسخیر صفحه‌کلید و موشواره را رها می‌کند. اگر صفحه‌کلید در حالت تسخیر باشد، میانبرهای سامانهٔ محلی دیگر کار نکرده و به سامانهٔ دوردست ارسال می‌شوند. اگر موشواره تسخیر شده باشد (اختیاری)، تشخیص حرکات لمسی محلی کار نمی‌کند و ممکن است موشواره قادر به خروج از پنجرهٔ RDP نباشد. رویدادهای موشواره تغییر داده نمی‌شوند. ++ وضعیت تمام‌صفحهٔ برنامه را جابه‌جا می‌کند ++ برنامه را کمینه می‌کند ++c کنترل از راه دور را در یک نشست امداد از راه دور تغییر وضعیت می‌دهد ++ ارتباط نشست را قطع کرده و برنامه را خاتمه می‌دهد Action Script با فشردن کلید، یک اسکریپت از پیش تعریف‌شده را اجرا می‌کند. در صورتی که اسکریپت وجود نداشته باشد، نادیده گرفته می‌شود. اسکریپت‌ها را می‌توان در مکان پیش‌فرض $XDG_CONFIG_HOME/freerdp/action.sh یا به عنوان آرگومان خط فرمان /action:script: ارائه داد. اسکریپت ترکیب کلید فعلی را به عنوان آرگومان دریافت خواهد کرد. خروجی اسکریپت برای عبارت key-local پردازش می‌شود که نشان می‌دهد اسکریپت از ترکیب کلید استفاده کرده است، در غیر این صورت ترکیب کلید به سامانهٔ دوردست ارسال می‌شود. متغیرهای محیطی (ENVIRONMENT VARIABLES) متغیرهای محیطی wlog برنامهٔ xfreerdp3 از wLog به عنوان ابزار ثبت وقایع خود استفاده می‌کند؛ برای اطلاعات بیشتر می‌توانید به صفحهٔ راهنمای مربوطه (wlog(7)) مراجعه کنید. آرگومان‌های ارسال‌شده از طریق /log-level یا /log-filters بر متغیرهای محیطی ارجحیت دارند. FREERDP_ASKPASS تنظیم برنامه‌ای برای درخواست گذرواژه، مشابه با SSH_ASKPASS پیکربندی سراسری (GLOBAL CONFIGURATION (client common)) قالب و مکان: فایل‌های پیکربندی در پیکربندی سراسری سامانه ذخیره می‌شوند. مکان مشترک تنظیمات گواهی /etc/FreeRDP/certificates.json است. قالب فایل JSON است گزینه‌های پشتیبانی‌شده: deny JSON boolean رد کردن گواهی در صورتی که بررسی در برابر مخزن SSL سامانه ناموفق باشد ignore JSON boolean نادیده گرفتن خطاهای گواهی؛ صرفاً گواهی نادیده گرفته می‌شود deny-userconfig JSON boolean اگر بررسی‌ها در پیکربندی سراسری گواهی را تأیید نکنند، از کاربر سؤالی پرسیده نشود certificate-db JSON array آرایه‌ای از JSON objects شامل: type JSON string رشته‌ای که الگوریتم درهم‌سازی استفاده‌شده را مشخص می‌کند، به عنوان مثال sha256 hash JSON string رشته‌ای از مقادیر عددی صحیح در مبنای شانزده (hex) که نشان‌دهندهٔ درهم‌سازی گواهی هستند، به عنوان مثال 0123456789abcdef محل پیکربندی کلاینت X11 عبارت است از: /etc/FreeRDP/xfreerdp.json قالب فایل JSON است گزینه‌های پشتیبانی‌شده: isActionScriptAllowed JSON boolean مجاز کردن یا مسدود کردن اسکریپت‌های کنش. حالت پیش‌فرض (در صورت تنظیم نشدن گزینه) مجاز دانستن اسکریپت‌های کنش است. مثال‌ها (EXAMPLES) #!/bin/bash # we got a key combination if [ "$1" = "key" ]; then # we only got one argument 'key' # 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 'key-local' 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 نمونه اسکریپت کنش برای رویدادهای کلید، که مشخص می‌کند ctrl+alt+f1 توسط مدیر پنجرهٔ محلی مدیریت شود و ctrl+alt+f2 یک اسکریپت را اجرا کند مقدار بازگشتی برنامه مشخص می‌کند که آیا کلید به‌صورت محلی مدیریت شود یا از راه دور (0 برای محلی، > 0 برای دوردست، < 0 برای خطاها) xfreerdp3 connection.rdp /p:Pwd123! /f اتصال در حالت تمام‌صفحه با استفاده از پیکربندی ذخیره‌شدهٔ connection.rdp و گذرواژهٔ Pwd123! xfreerdp3 /u:USER /size:50%h /v:rdp.contoso.com اتصال به میزبان rdp.contoso.com با کاربر USER و اندازه‌ای برابر با ۵۰ درصد از ارتفاع. اگر به جای ارتفاع (h) پهنا (w) مانند /size:50%w تنظیم شود. ۵۰ درصد از پهنا استفاده می‌شود. xfreerdp3 /u:CONTOSO\\JohnDoe /p:Pwd123! /v:rdp.contoso.com اتصال به میزبان rdp.contoso.com با کاربر CONTOSO\\JohnDoe و گذرواژهٔ Pwd123! xfreerdp3 /u:JohnDoe /p:Pwd123! /w:1366 /h:768 /v:192.168.1.100:4489 اتصال به میزبان 192.168.1.100 روی درگاه 4489 با کاربر JohnDoe، گذرواژهٔ Pwd123!. پهنای صفحه روی 1366 و ارتفاع آن روی 768 تنظیم شده است. xfreerdp3 /u:JohnDoe /p:Pwd123! /vmconnect:C824F53E-95D2-46C6-9A18-23A5BB403532 /v:192.168.1.100 برقراری ارتباط با میزبان 192.168.1.100 با کاربر JohnDoe، گذرواژهٔ Pwd123! و اتصال به کنسول Hyper-V (استفاده از درگاه 2179، غیرفعال‌سازی مذاکره) با شناسهٔ ماشین مجازی C824F53E-95D2-46C6-9A18-23A5BB403532 +clipboard فعال‌سازی بازهدایت کلیپ‌بورد /drive:home,/home/user فعال‌سازی بازهدایت درایو /home/user به عنوان درایو خانه (home) /smartcard: فعال‌سازی بازهدایت کارت هوشمند برای دستگاه device /printer:, فعال‌سازی بازهدایت چاپگر برای چاپگر device با استفاده از درایور driver /serial: فعال‌سازی بازهدایت درگاه سریال برای درگاه device /parallel: فعال‌سازی بازهدایت درگاه موازی برای درگاه device /sound:sys:alsa فعال‌سازی بازهدایت خروجی صوتی با استفاده از دستگاه sys:alsa /microphone:sys:alsa فعال‌سازی بازهدایت ورودی صوتی با استفاده از دستگاه sys:alsa /multimedia:sys:alsa فعال‌سازی بازهدایت چندرسانه‌ای با استفاده از دستگاه sys:alsa /usb:id,dev:054c:0268 فعال‌سازی بازهدایت دستگاه USB برای دستگاه مشخص‌شده با 054c:0268 /kbd:remap:29=58,remap:58=29 جابه‌جایی کلید Control چپ (29) و Caps Lock (58). http://www.freerdp.com نویسندگان (AUTHORS) تیم FreeRDP freerdp 2026-09-03 xfreerdp3(1)