# setsettings ![Parralels](https://www.parallels.com/static/pl/fileadmin/res/img/navigation/pl-logo-dk.png) ## AppserverClient Command Line Interface ### setsettings updates settings from a connection or generic to Parallels Client. **Category: Settings** ``` AppServerClientCLI setsettings [-id ras:5] -settings settingname1=0[,settings2=1] ``` ### Arguments * **`id (optional)`** Specify the connection ID to use. * **`settings (mandatory)`** Specify which setting to set. ### Return codes: ok - Command was successful\ NotAvailable - Communication with the client backend failed, ensure that the client is running\ AccessDenied - Logged on user does not have permission to perform the action\ Exception - System problem ### Examples: AppServerClientCLI setsettings -id ras:5/rdp:5 -settings incognitomode=1,username=myuser ### Notes: Possible settings and their relative information: ### Global settings: | Name | Type | Read | Write | Minimum | Maximum | Possible Values | Description | | ------------------------- | ------ | ---- | ----- | ------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | modernui | bool | yes | yes | | | | Enable or disable the Modern interface. | | appearance | int | yes | yes | | | | Change the color theme used by the application. | | banner | int | yes | yes | | | | Select what user interface to use while a connection is being established. | | autorefresh | bool | yes | yes | | | | Whether connections are automatically refreshed. | | autorefreshtime | int | yes | yes | 15 | 9999 | | Specifies the time in minutes for the automatic refresh. | | oncloseallsessions | int | yes | yes | | | | Specifies what happens when all user sessions are closed. | | loglevel | int | yes | yes | | | | Specifies the log level. | | logduration | int | yes | yes | 3600 | 259200 | 0 = Never | Specifies the time in milliseconds after which the logs will return to the Standard level. | | checkforupdate | bool | yes | yes | | | | Whether Parallels Client checks for available updates on startup. | | avdclienttype | int | yes | yes | | | | Specifies using "Azure Virtual Desktop client" or "Windows App" when connecting to Azure Virtual Desktop resources. | | ssoforcethirdparty | bool | yes | yes | | | | Enable or disable force wrap of the third-party SSO component. | | ssowrapprovidername | string | yes | no | | | | The name of the third-party SSO component. This setting is read only. See also [listavailablessoproviders](https://github.com/Parallels-Corp/RAS-20-docs/blob/origin/admin-guide-20.2-release/30_RAS-20_Client_Guides/Windows_CLI/commands/listavailablessoproviders.html). | | ssowrapproviderguid | guid | yes | yes | | | | Specify the GUID of the third-party SSO component. See also [listavailablessoproviders](https://github.com/Parallels-Corp/RAS-20-docs/blob/origin/admin-guide-20.2-release/30_RAS-20_Client_Guides/Windows_CLI/commands/listavailablessoproviders.html). | | language | int | yes | yes | | | | Specify the UI language. You must restart Parallels Client for the changes to take effect. | | hidelauncher | bool | yes | yes | | | | When enabled, the launcher will be minimized to the system tray after an application is launched. | | launchonstartup | bool | yes | yes | | | | When enabled, the launcher will be launched automatically on Windows startup. | | redirectfxusbredir | bool | yes | yes | | | | Enables the RemoteFX USB redirection feature on Windows. Note that the computer must be restarted for the changes to take effect. | | showconnectionstree | bool | yes | yes | | | | When enabled, if an application is closed it continue to run in the background. | | keepapprunning | bool | yes | yes | | | | When enabled, Parallels Client will be shown in the System Tray when you click on the Close button or press Escape. | | sslnowarn | bool | yes | yes | | | | When enabled, connections over SSL with a non-verified certificate will not display a warning message. | | autoaddras | bool | yes | yes | | | | When enabled, a new connection is added to Parallels Client when an item is started from a connection that is not yet listed. | | donotpromptautoaddras | bool | yes | yes | | | | Enable this option to disable prompt messages when adding auto connections. | | clearcookiesonexit | bool | yes | yes | | | | When a user signs in, a Parallels RAS logon cookie is kept on the Parallels Client side. This allows the user to re-connect to Parallels RAS without re-authenticating. When this option is enabled, cookies are deleted when the user closes Parallels Client. | | autocloseerrormsgs | bool | yes | yes | | | | When enabled, all session disconnect error messages are automatically dismissed after 15 seconds. | | swapmousebuttons | bool | yes | yes | | | | When enabled, mouse buttons will be swapped on the remote computer. | | dpiaware | bool | yes | yes | | | | When enabled, this option forces a published application to be DPI-aware depending on the Parallels Client's DPI settings. | | turnoffudponclient | bool | yes | yes | | | | When enabled, RDP sessions will not use the UDP protocol. | | autoinstallfonts | bool | yes | yes | | | | When enabled, server-configured fonts are automatically installed. | | rawprinting | bool | yes | yes | | | | When enabled, Universal Printing will convert non-distributable fonts into images. | | usefontsimageswhereneeded | bool | yes | yes | | | | When enabled, server-configured fonts are automatically installed. | | cacheembeddedfonts | bool | yes | yes | | | | Enable caching of embedded fonts locally to speed up Universal Printing process. | | dynamicprinterredir | bool | yes | yes | | | | When enabled, if any printer configuration which matches the redirection rules is updated, the changes are reflected on the remote virtual printer. This includes adding and removing printers. | | telemetry | bool | yes | yes | | | | Enable this option to participate in the Customer Experience Program. | ### Connection settings: | Name | Type | Connection | Read | Write | Minimum | Maximum | Possible Values | Description | | ------------------------- | ------ | ---------- | ---- | ----- | ------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | server | string | ras/rdp | yes | yes | 1 | 255 | | Specify the server name or IP address. To connect to a specific RAS Theme, specify its name after the server name or IP address separated by a slash. | | port | int | ras/rdp | yes | yes | 1 | 65535 | | Specify the port on which the server listens for incoming connections. | | mode | int | ras/rdp | yes | yes | | |

Ras:

Rdp:

| Specify the connection mode to use. | | alias | string | ras/rdp | yes | yes | 1 | 255 | | Specify the friendly name to use for this connection. | | backup | string | ras | yes | yes | 1 | 2048 | | Specify the secondary connections. Every connection requires a server name or IP address, a port and a connection mode. \*\*Format: \*\*server,port,connectionmode,...,server,port,connectionmode. | | publicipsvcurl | string | ras | yes | no | 1 | 255 | | Specify the service URL set to retrieve the public IP. | | authtype | int | ras/rdp | yes | yes | | |

Ras:

Rdp:

| Specify the authentication type to use. | | autologin | bool | ras/rdp | yes | yes | | | | When enabled, Parallels Client will connect to this connection on startup automatically. | | username | string | ras/rdp | yes | yes | 0 | 127 | | Specify the username to use, preferebly in the UPN format. If [authtype](https://github.com/Parallels-Corp/RAS-20-docs/blob/origin/admin-guide-20.2-release/30_RAS-20_Client_Guides/Windows_CLI/commands/authtype.html) is set to "Web + Credentials", you cannot set the username. | | domain | string | ras/rdp | yes | yes | 0 | 64 | | If you did not specify the full username, you can specify the domain name. | | password | string | ras/rdp | no | yes | 0 | 127 | | Specify the password to use. This setting can only be set using [setsettings](https://github.com/Parallels-Corp/RAS-20-docs/blob/origin/admin-guide-20.2-release/30_RAS-20_Client_Guides/Windows_CLI/commands/setsettings.html). | | savepassword | bool | ras/rdp | yes | yes | | | | When enabled, the password will be remembered. | | colordepth | int | ras/rdp | yes | yes | | | | Specify the color depth to use. | | useprimarymonitor | bool | ras/rdp | yes | yes | | | | When enabled, display a published resource on the primary monitor only. Other monitors connected to the computer will not be used. | | usedynamicresizeapps | bool | ras/rdp | yes | yes | | | | Eable this option if you want published resources to use the display settings of the local desktop. | | displayconfiguration | int | ras/rdp | yes | yes | | | | Choose which monitors will be used to display published resources. If "Selected" is used, you need to set a value for selected display. | | selecteddisplay | string | ras/rdp | yes | yes | 2 | 100 | | Choose one or several displays manually. See also [listavailabledisplays](https://github.com/Parallels-Corp/RAS-20-docs/blob/origin/admin-guide-20.2-release/30_RAS-20_Client_Guides/Windows_CLI/commands/listavailabledisplays.html). | | smartsizing | int | ras/rdp | yes | yes | | | | Choose a smart sizing option. | | fullscreenconnbar | int | ras/rdp | yes | yes | | | | Choose how the connection bar should be displayed in full screen mode by default: pinned, unpinned, or hidden. | | desktopembed | bool | ras/rdp | yes | yes | | | | Enable this option to open a remote desktop inside the Parallels Client window (launcher). This feature is only available in the Classic user interface only. | | spandesktops | bool | ras/rdp | yes | yes | | | | Enable this option to span published desktops across all connected monitors. | | audiolocation | int | ras/rdp | yes | yes | | | | Choose where to playback remote audio. | | audioquality | int | ras/rdp | yes | yes | | | | Choose the audio quality when redirecting to the local computer. | | enablerecording | bool | ras/rdp | yes | yes | | | | Enable this option to be able to record audio on the remote computer. | | keyboard | int | ras/rdp | yes | yes | | | | Choose when to apply Windows key combinations. | | clipboard | int | ras/rdp | yes | yes | | | | Choose the clipboard redirection mode. | | diskdrives | bool | ras/rdp | yes | yes | | | | Enables disk drives redirection. | | drivesused | string | ras/rdp | yes | yes | 1 | 160 | | Choose which drives to redirect. | | redirdynamicdrives | bool | ras/rdp | yes | yes | | | | Enable this option to redirect disk drives that you will connect to your local computer later. | | drivecachemode | int | ras/rdp | yes | yes | | | | Enabling this option will make file browsing and navigation on the redirected drives much faster. | | redirectreadonlydrives | bool | ras/rdp | yes | no | | | | When set via policies, will redirect all drives in read-only mode. | | videocapturingdevices | bool | ras/rdp | yes | yes | | | | Enable this to redirect video capture devices. | | redirdynamiccameras | bool | ras/rdp | yes | yes | | | | Enable this option to redirect video capture devices that you will connect to your local computer later. | | camerasused | string | ras/rdp | yes | yes | 1 | 500 | | Specifies which video capture devices to redirect from a user device to the remote session. See also [listavailablecameras](https://github.com/Parallels-Corp/RAS-20-docs/blob/origin/admin-guide-20.2-release/30_RAS-20_Client_Guides/Windows_CLI/commands/listavailablecameras.html). | | otherdevices | bool | ras/rdp | yes | yes | | | | Enable this option to redirect other devices that are connected to your local computer. | | devicesused | string | ras/rdp | yes | yes | 1 | 500 | | Specifies which other devices to redirect from a user device to the remote session. See also [listavailabledevices](https://github.com/Parallels-Corp/RAS-20-docs/blob/origin/admin-guide-20.2-release/30_RAS-20_Client_Guides/Windows_CLI/commands/listavailabledevices.html). | | redirdynamicdevices | bool | ras/rdp | yes | yes | | | | Enable this option to redirect other devices that you will connect to your local computer later. | | showpreviousdevices | bool | ras/rdp | yes | yes | | | | Enable this to show devices that were previously connected in the user interface. | | serialports | bool | ras/rdp | yes | yes | | | | Enable this option to redirect serial ports. | | smartcards | bool | ras/rdp | yes | yes | | | | Enable this option to redirect smart cards. | | pentouchinput | int | ras/rdp | yes | yes | | | | Enables this option to redirect pen and touch input to the remote session. | | multimediaforavd | bool | ras | yes | yes | | | | Enable this to accelerate video content played in a browser on a remote Azure Virtual Desktop host. | | networktype | int | ras/rdp | yes | yes | | | | Choose the network type used to optimize the performance of the connection with the remote server. | | desktopbackground | bool | ras/rdp | yes | yes | | | | Enable this so that the remote session could use desktop backgrounds. | | fontsmoothing | bool | ras/rdp | yes | yes | | | | Enable this option to make text smoother and easier to read. | | menuandwindowanimation | bool | ras/rdp | yes | yes | | | | Enable this option to animate the movement of windows, menus, and lists. | | desktopcomposition | bool | ras/rdp | yes | yes | | | | Enable this option to allow desktop composition. With desktop composition, individual windows are no longer drawn directly to the screen. Instead, their drawing is redirected to video memory, which is then rendered into a desktop image and presented on the display. | | showcontentwhiledragging | bool | ras/rdp | yes | yes | | | | Enable this option to show the contents of the window while users move or resize the windows on their desktops. | | themes | bool | ras/rdp | yes | yes | | | | Enable this option to set Windows themes in the remote session. | | bitmapcaching | bool | ras/rdp | yes | yes | | | | Enable this option to improve performance by minimizing the amount of display information that is passed over a connection. | | optimizewindowsplacement | bool | ras/rdp | yes | yes | | | | Enable this option to impriove user exoerience while moving or resizing a remote application window. | | compression | bool | ras/rdp | yes | yes | | | | Enable this option to have a more efficient connection. | | useproxy | bool | ras/rdp | yes | yes | | | | Enable this option to use a proxy server. | | proxytype | int | ras/rdp | yes | yes | | | | Choose the proxy server type. | | proxyhost | string | ras/rdp | yes | yes | 1 | 255 | | Specify the proxy host domain name or IP address. | | proxyport | int | ras/rdp | yes | yes | 1 | 65535 | | Specify the proxy port. | | useproxyauth | bool | ras/rdp | yes | yes | | | | Enable this option if the proxy server requires authentication. | | uselogoncredforproxy | bool | ras/rdp | yes | yes | | | | Enable this option if the credenitals required are the same as those of the current connection. | | proxyusername | string | ras/rdp | yes | yes | 0 | 127 | | Specify the proxy username. | | proxypassword | string | ras/rdp | no | yes | 0 | 127 | | Specify the proxy password. This setting can only be set using [setsettings](https://github.com/Parallels-Corp/RAS-20-docs/blob/origin/admin-guide-20.2-release/30_RAS-20_Client_Guides/Windows_CLI/commands/setsettings.html). | | serverauthmode | int | ras/rdp | yes | yes | | | | Specify what action to take if the server authentication fails. | | nla | bool | ras/rdp | yes | yes | | | | Use this option to enable network level authentication, which will require Parallels Client to authenticate before connecting to the server. | | redirectpos | bool | ras/rdp | yes | yes | | | | Enable this option to redirect Point of Service (POS) devices such as bar code scanners or magnetic readers that are attached to the local computer to be used in the remote connection. | | prewindows2000 | bool | ras/rdp | yes | yes | | | | Enable this option to use legacy (pre-Windows 2000) login format. | | connectiontimeout | int | ras/rdp | yes | yes | 1 | 999 | | Specify the amount of time during which Parallels Client will try to connect to Parallels RAS until the connection is aborted. While the connection is being established, the connection banner will be shown if configured. | | connectionbannertimeout | int | ras/rdp | yes | yes | 1 | 999 | | Specifies the time period in seconds after which the connection banner will be displayed. | | showdesktoptimeout | int | ras/rdp | yes | yes | 1 | 999 | | Specify the the time period to wait for a published application to be launched. If the application is not launched within this time, the server’s desktop will be shown. | | reconnection | bool | ras/rdp | yes | yes | | | | Enable reconnection if a connection is dropped. | | retries | int | ras/rdp | yes | yes | 2 | 50 | | Specifies the number of retires to reconnect. | | reconnectionbannertimeout | int | ras/rdp | yes | yes | 1 | 999 | | Specifies the time period in seconds after which the connection banner will be displayed when reconnected. | | prelaunchmode | int | ras/rdp | yes | yes | | | | Specifies session prelaunch mode. This will make a remote application appear to start faster. | | uselocalproxy | bool | ras/rdp | yes | yes | | | | Enable this option to specify IP address 127.0.0.1 to bind the local RDP proxy. | | computername | string | ras/rdp | yes | yes | 0 | 15 | | Specifies the name that your computer will use during a remote desktop session. | | printertechnology | int | ras | yes | yes | | | | Select the technology to use when redirecting printers to a remote computer. | | redirectprinter | int | ras | yes | yes | | | | Select the printers to be redirected by RAS Universal Printing. If "Specific" is used, select the actual printers by using the printerlist setting. | | printerlist | string | ras | yes | yes | 1 | 2048 | | Specify the specific printers to be redirected by RAS Universal Printing. | | printingdataformat | int | ras | yes | yes | | | | Specify which data format is to be used. | | clientprinterpref | int | ras | yes | yes | | | | Specify how to use the printer preferences. If "Use client preferences for the specifc printers" is used, choose the spefic printers by using printerlistpref setting. | | printerlistpref | string | ras | yes | yes | 1 | 2048 | | Select which printers will use a local printer preferences dialog when you click "Print" | | defaultprinter | string | ras | yes | yes | 1 | 256 | | Specify the default printer in the remote session. \*\*Format: \*\*technology,namepattern. | | matchname | bool | ras | yes | yes | | | | Enable this option when the remote printer must match the custom printer speficied in the defaultprinter setting. | | forcetime | int | ras | yes | yes | 1 | 86400 | | Specify the time in milliseconds after the connection is established in which if the default printer is changed, the set printer is reset back to default. | | updatedefprinter | bool | ras | yes | yes | | | | Enable this to change the remote default printer automatically when the local default printer is changed. Please note that the new printer must be already redirected. | | scannertechonology | int | ras | yes | yes | | | | Select the technology to use when redirecting scanners to a remote computer. | | scannerredirect | int | ras | yes | yes | | | | Select the scanners to be redirected by RAS Universal Scanning. If "Specific" is used select the actual scanners by using the "scannerswia" and "scannerstwain"settings. See also [listavailablescanners](https://github.com/Parallels-Corp/RAS-20-docs/blob/origin/admin-guide-20.2-release/30_RAS-20_Client_Guides/Windows_CLI/commands/listavailablescanners.html). | | scannerswia | string | ras | yes | yes | 1 | 2048 | | Specify the specific scanners that use the WIA technology to be redirected by RAS Universal Scanning. See also [listavailablescanners](https://github.com/Parallels-Corp/RAS-20-docs/blob/origin/admin-guide-20.2-release/30_RAS-20_Client_Guides/Windows_CLI/commands/listavailablescanners.html). | | scannerstwain | string | ras | yes | yes | 1 | 2048 | | Specify the specific scanners that use the TWAIN technology to be redirected by RAS Universal Scanning. See also [listavailablescanners](https://github.com/Parallels-Corp/RAS-20-docs/blob/origin/admin-guide-20.2-release/30_RAS-20_Client_Guides/Windows_CLI/commands/listavailablescanners.html). | | mfarememberlastused | bool | ras | yes | yes | | | | Enable this to remember the last MFA authentication method used which will then used by default. | | mfalastused | string | ras | yes | no | | | | The last MFA action used. This setting is read only. | | browsermode | int | ras | yes | yes | | | | Speficy which browser to open for web authentication. This can be the internal browser built into Parallels Client or any external browser installed on the computer. | | extbrowserpath | string | ras | yes | yes | 0 | 260 | | Specify which external brower path to use. See also [listavailablebrowsers](https://github.com/Parallels-Corp/RAS-20-docs/blob/origin/admin-guide-20.2-release/30_RAS-20_Client_Guides/Windows_CLI/commands/listavailablebrowsers.html). | | incognitomode | bool | ras | yes | yes | | | | Enable this to use incognito mode in the external browser. | | openbrowsetologout | bool | ras | yes | yes | | | | Enable this option to open a SAML sign out dialog in the built-in browser. | | useclientcolors | bool | ras | yes | yes | | | | Enable this option to use Parallels Client system colors instead of those specified on the remote desktop. | | useclientsettings | bool | ras | yes | yes | | | | Enable this option to use Parallels Client system settings instead of those specified on the terminal server. | | createshortcuts | bool | ras | yes | yes | | | | Enable this option to create the shortcuts as instructed by the administrator configuration. Shortcuts can be created on Parallels Client's desktop and the Start menu. | | registerfileext | bool | ras | yes | yes | | | | Enable this option to associate file extensions as instructed by the administrator which will automatically use the remote application. | | redirecturl | bool | ras | yes | yes | | | | Enable this option to use the local browser when opening HTTP links in a remote session. | | redirectmail | bool | ras | yes | yes | | | | Enable this option to use the local mail client when opening the links starting with "mailto:" in a remote session. | | alwaysaskforcreds | bool | ras | yes | yes | | | | Enable this option to be prompted to enter their credentials when starting remote sessions. | | allowservertosendcmds | bool | ras | yes | yes | | | | Enable this option to allow commands being received from the server to be executed by Parallels Client. | | confirmservercmds | bool | ras | yes | yes | | | | Enable this option to have user confirmation before commands are executed from the server. | | disablerdpudp | bool | ras | yes | yes | | | | Enable this option to disable UDP transport when connecting through a gateway. | | desktopsize | string | rdp | yes | yes | 1 | 50 | | Specify the desktop size to use. \*\*Format: \*\*fullscreen/availablearea/width x height. | | printers | bool | rdp | yes | yes | | | | Enable this to redirect printer in a standard RDP connection. | | startonconnection | bool | rdp | yes | yes | | | | Enable this to start an application in a standard RDP connection. | | programpath | string | rdp | yes | yes | 1 | 260 | | Specify the applicaiton target path when using startonconnection setting. | | startfolder | string | rdp | yes | yes | 0 | 260 | | Specify the applicaiton start folder when using startonconnection setting. | | consoleconnect | bool | rdp | yes | yes | | | | Enable this option to start the standard RDP connection with admin rights to perform tasks on a remote computer that require elevated privileges. | ### See also: [getsettings](/landing/ras-windows-cli-guide/commands/getsettings.md)\ [settingsinfo](/landing/ras-windows-cli-guide/commands/settingsinfo.md)\ [factoryreset](/landing/ras-windows-cli-guide/commands/factoryreset.md)\ [listavailablebrowsers](/landing/ras-windows-cli-guide/commands/listavailablebrowsers.md)\ [listavailablessoproviders](/landing/ras-windows-cli-guide/commands/listavailablessoproviders.md)\ [listavailabledisplays](/landing/ras-windows-cli-guide/commands/listavailabledisplays.md)\ [listavailablecameras](/landing/ras-windows-cli-guide/commands/listavailablecameras.md)\ [listavailabledevices](/landing/ras-windows-cli-guide/commands/listavailabledevices.md)\ [listavailablescanners](/landing/ras-windows-cli-guide/commands/listavailablescanners.md)\ [isssoenabled](/landing/ras-windows-cli-guide/commands/isssoenabled.md)\ [enablesso](/landing/ras-windows-cli-guide/commands/enablesso.md) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.parallels.com/landing/ras-windows-cli-guide/commands/setsettings.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.