# Set-RASGatewayDefaultSettings.md ## NAME Set-RASGatewayDefaultSettings ## SYNOPSIS Modifies default settings used to configure a RAS Secure Gateway. ## SYNTAX \*\*Set-RASGatewayDefaultSettings \[[AllowAppsInNewTab](#allowappsinnewtab-string) *(bool)*] \[[AllowCORS](#allowcors-string) *(bool)*] \[-[AllowedDomainsForCORS](#AllowedDomainsForCORS) *(List\`1)*] \[[AllowEmbed](#allowembed-string) *(bool)*] \[[AllowLaunchMethod](#allowlaunchmethod-string) *(bool)*] \[[AlternateNLBHost](#alternatenlbhost-string) *(string)*] \[[AlternateNLBPort](#alternatenlbport-string) *(uint)*] \[[AutoCertificate](#autocertificate-string) *(SwitchParameter)*] \[[AutoPreferredBroker](#autopreferredbroker-string) *(SwitchParameter)*] \[[Broadcast](#broadcast-string) *(bool)*] \[[BrowserCacheTimeInMonths](#browsercachetimeinmonths-string) *(uint)*] \[[CertificateId](#certificateid-string) *(uint)*] \[-[CertificateObj](#CertificateObj) *(*[*Certificate*](https://docs.parallels.com/landing/ras-powershell-api-guide/v20/parallels-ras-powershell-admin-module/types/certificate)*)*] \[[Cipher](#cipher-string) *(string)*] \[[CipherPreference](#cipherpreference-string) *(bool)*] \[-[CipherStrength](#CipherStrength) {Low | Medium | High | Custom}] \[[ClientDetectionTimeout](#clientdetectiontimeout-string) *(uint)*] \[[ClientIPPDetectionServiceURL](#clientippdetectionserviceurl-string) *(string)*] \[-[ClipboardDirection](#ClipboardDirection) {None | ClientToServer | ServerToClient | Bidirectional}] \[-[DetectClientMode](#DetectClientMode) {Automatic | Manual}] \[[DisableWyseCertWarn](#disablewysecertwarn-string) *(bool)*] \[[DOSPro](#dospro-string) *(bool)*] \[[EnableAlternateNLBHost](#enablealternatenlbhost-string) *(bool)*] \[[EnableAlternateNLBPort](#enablealternatenlbport-string) *(bool)*] \[[EnableDeviceManagerPort](#enabledevicemanagerport-string) *(bool)*] \[[EnableGatewayPort](#enablegatewayport-string) *(bool)*] \[[EnableHSTS](#enablehsts-string) *(bool)*] \[[EnableRDP](#enablerdp-string) *(bool)*] \[[EnableRDPUDP](#enablerdpudp-string) *(bool)*] \[[EnableSSL](#enablessl-string) *(bool)*] \[[EnableUserPortal](#enableuserportal-string) *(bool)*] \[[EnableWyseSupport](#enablewysesupport-string) *(bool)*] \[-[FileTransferMode](#FileTransferMode) {Disabled | ClientToServer | ServerToClient | Bidirectional}] \[[ForwardGatewayServers](#forwardgatewayservers-string) *(string)*] \[[ForwardHttpServers](#forwardhttpservers-string) *(string)*] \[[GatewayPort](#gatewayport-string) *(uint)*] \[[HSTSIncludeSubdomains](#hstsincludesubdomains-string) *(bool)*] \[[HSTSMaxAge](#hstsmaxage-string) *(uint)*] \[[HSTSPreload](#hstspreload-string) *(bool)*] \[-[LaunchMethod](#LaunchMethod) {ParallelsClientAndWebClient | ParallelsClientAndHTML5 | ParallelsClient | WebClient | HTML5}] \[-[MACAllowExcept](#MACAllowExcept) *(string\[])*] \[-[MACAllowOnly](#MACAllowOnly) *(string\[])*] \[-[MinSSLVersion](#MinSSLVersion) {TLSv1 | TLSv1\_1 | TLSv1\_2 | TLSv1\_3}] \[-[Mode](#Mode) {Normal | Forwarding}] \[[NormalModeForwarding](#normalmodeforwarding-string) *(bool)*] \[[OnlyAllowAcmeHttp](#onlyallowacmehttp-string) *(bool)*] \[[PreferredBrokerId](#preferredbrokerid-string) *(uint)*] \[-[PreferredBrokerObj](#PreferredBrokerObj) *(*[*Broker*](https://docs.parallels.com/landing/ras-powershell-api-guide/v20/parallels-ras-powershell-admin-module/types/broker)*)*] \[[RDPPort](#rdpport-string) *(uint)*] \[-[SecurityMode](#SecurityMode) {AllowAllExcept | AllowOnly}] \[[SiteId](#siteid-string) *(uint)*] \[[SSLPort](#sslport-string) *(uint)*] \[[UseClientIPDetectionService](#useclientipdetectionservice-string) *(bool)*] \[[UsePreWin2000LoginFormat](#useprewin2000loginformat-string) *(bool)*] \[[UserPortalPort](#userportalport-string) *(uint)*] \[[UseSecureWebCookie](#usesecurewebcookie-string) *(bool)*] \[[WebCookie](#webcookie-string) *(string)*] \[[WebRequestsURL](#webrequestsurl-string) *(string)*] \[*(*[*CommonParameters*](#CommonParameters)*)*] ## DESCRIPTION Modifies default settings used to configure a RAS Secure Gateway. For each setting, the cmdlet has a corresponding input parameter. To modify a setting, specify a matching parameter and its value. Default settings are defined on a site level and are applied to a Gateway when it is initially added to the site. To retrieve the current defaults settings, use the Get-RASGatewayDefaultSettings cmdlet. ## PARAMETERS ## SiteId (uint) Site ID for which to modify the default Gateway settings. ``` Required? false Position? named Default value 0 Accept pipeline input? false Accept wildcard characters? false ``` ## Mode ([GatewayMode](https://docs.parallels.com/landing/ras-powershell-api-guide/v20/parallels-ras-powershell-admin-module/types/gatewaymode)) Gateway Mode. Accepted values: Normal, Forwarding. Possible values: Normal, Forwarding ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## NormalModeForwarding (bool) Forward requests to HTTP server. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## ForwardGatewayServers (string) One or multiple (separated by comma) Forwarding Gateway Servers. E.g. localhost:80, web1 ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## AutoPreferredBroker (SwitchParameter) Set preferred Broker Automatically. ``` Required? false Position? named Default value False Accept pipeline input? false Accept wildcard characters? false ``` ## PreferredBrokerObj ([Broker](https://docs.parallels.com/landing/ras-powershell-api-guide/v20/parallels-ras-powershell-admin-module/types/broker)) The preferred Connection Broker. To obtain an object of type Broker representing the Preferred Connection Broker, use the Get-RASBroker cmdlet. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## PreferredBrokerId (uint) The preferred Connection Broker ID. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## ForwardHttpServers (string) One or multiple (separated by comma) Forwarding HTTP Servers. E.g. localhost:81, web1 ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## EnableGatewayPort (bool) Enable or disable a custom RAS Secure Gateway port. To specify a custom port, set this parameter to True and use the GatewayPort parameter to specify the port number. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## GatewayPort (uint) A custom Gateway port number. For this port to take effect, the EnableGatewayPort parameters must be set to $True. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## OnlyAllowAcmeHttp (bool) Whether to ignore all incoming requests except for Acme ones received on 'GatewayPort' ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## EnableRDP (bool) Enable or disable a custom RDP port. To specify a custom port number, use the RDPPort parameter. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## RDPPort (uint) A custom RDP port number. For this port to take effect, the EnableRDPPort parameter must be set to True. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## Broadcast (bool) Enable or disable the 'Broadcast RAS Secure Gateway Address' option. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## EnableRDPUDP (bool) Enable or disable the 'RDP UDP Data Tunneling' option. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## EnableDeviceManagerPort (bool) Enable or disable the 'Device Manager Port' option. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## DOSPro (bool) Enable or disable the 'RDP DOS Attack Filter' option. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## EnableSSL (bool) Enable or disable SSL on the port specified in the SSLPort parameter. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## SSLPort (uint) SSL port number. To enable the port, set the EnableSSL port parameter to True. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## MinSSLVersion ([AcceptedSSLVersion](https://docs.parallels.com/landing/ras-powershell-api-guide/v20/parallels-ras-powershell-admin-module/types/acceptedsslversion)) Minimum SSL version. Accepted values: TLSv1\_3 (TLS v1.3 only, strong), TLSv1\_2 (TLS v1.2 - TLS v1.3), TLSv1\_1 (TLS v1.1 - TLS v1.3), TLSv1 (TLS v1 - TLS v1.3). Possible values: TLSv1, TLSv1\_1, TLSv1\_2, TLSv1\_3 ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## CipherStrength ([CipherStrength](https://docs.parallels.com/landing/ras-powershell-api-guide/v20/parallels-ras-powershell-admin-module/types/cipherstrength)) Cipher strength. Accepted values: Low, Medium, High, Custom. Possible values: Low, Medium, High, Custom ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## Cipher (string) Cipher string. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## CipherPreference (bool) Enable or disable Use ciphers according to server preference. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## AutoCertificate (SwitchParameter) Set Certificate Automatically. ``` Required? false Position? named Default value False Accept pipeline input? false Accept wildcard characters? false ``` ## CertificateObj ([Certificate](https://docs.parallels.com/landing/ras-powershell-api-guide/v20/parallels-ras-powershell-admin-module/types/certificate)) The Certificate. To obtain an object of type Certificate, use the Get-Certificate cmdlet. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## CertificateId (uint) The Certificate ID. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## EnableHSTS (bool) Enable or disable HSTS. To specify a custom HSTS Age, set this parameter to True and use the HSTSMaxAge parameter to specify the HSTS maximum age. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## HSTSMaxAge (uint) Specifies the HSTS maximum age. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## HSTSIncludeSubdomains (bool) Enable or disable the HSTS sub-domains. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## HSTSPreload (bool) Enable or disable the HSTS preload. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## EnableUserPortal (bool) Enable or disable User Portal connectivity on the Gateway. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## UserPortalPort (uint) A custom User Portal port number. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## LaunchMethod ([LaunchMethod](https://docs.parallels.com/landing/ras-powershell-api-guide/v20/parallels-ras-powershell-admin-module/types/launchmethod)) Launch method. Possible values: ParallelsClientAndWebClient, ParallelsClientAndHTML5, ParallelsClient, WebClient, HTML5 ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## AllowLaunchMethod (bool) Allow users to select a resource launch method. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## AllowAppsInNewTab (bool) Allow users to start applications in a new browser tab. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## UsePreWin2000LoginFormat (bool) Enable or disable the 'Use Pre Windows 2000 Login Format' option. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## AllowEmbed (bool) Allow embedding of Web Client into other web pages. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## FileTransferMode ([FileTransferControlMode](https://docs.parallels.com/landing/ras-powershell-api-guide/v20/parallels-ras-powershell-admin-module/types/filetransfercontrolmode)) File Transfer option. Possible values are: 0 (Disabled), 1 (client to Server only), 2 {Server To Client only), 3 (Bidirectional). Possible values: Disabled, ClientToServer, ServerToClient, Bidirectional ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## ClipboardDirection ([ClipboardDirections](https://docs.parallels.com/landing/ras-powershell-api-guide/v20/parallels-ras-powershell-admin-module/types/clipboarddirections)) State of clipboard direction. Possible values: None, ClientToServer, ServerToClient, Bidirectional ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## AllowCORS (bool) Allow cross-origin resource sharing. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## AllowedDomainsForCORS (List\`1) Allowed domains for cross-origin resource sharing. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## UseClientIPDetectionService (bool) Use Client IP detection service. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## ClientIPPDetectionServiceURL (string) Client IP detection service URL. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## DetectClientMode ([DetectClientMode](https://docs.parallels.com/landing/ras-powershell-api-guide/v20/parallels-ras-powershell-admin-module/types/detectclientmode)) Detection mode. Automatically on sign in Manually on user prompt (Default) Possible values: Automatic, Manual ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## ClientDetectionTimeout (uint) Client detection timeout in seconds. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## BrowserCacheTimeInMonths (uint) How long should the browser preserve the cache (in months). ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## EnableAlternateNLBHost (bool) Enable or disable Alternate NLB host name specified in the EnableAlternateNLBHost parameter. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## AlternateNLBHost (string) Alternate NLB host name. To enable the host name, set the EnableAlternateNLBHost port parameter to True. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## EnableAlternateNLBPort (bool) Enable or disable Alternate NLB on the port specified in the AlternateNLBPort parameter. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## AlternateNLBPort (uint) Alternate NLB port number. To enable the port, set the EnableAlternateNLBPort port parameter to True. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## EnableWyseSupport (bool) Enable or disable Wyse ThinOS support. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## DisableWyseCertWarn (bool) Enable or disable the warning if server certificate is not verified. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## SecurityMode ([GatewaySecurityMode](https://docs.parallels.com/landing/ras-powershell-api-guide/v20/parallels-ras-powershell-admin-module/types/gatewaysecuritymode)) Security Mode. Accepted values: AllowAllExcept, AllowOnly. Possible values: AllowAllExcept, AllowOnly ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## MACAllowExcept (string\[]) Specifies the Security 'MAC Allow Except' MAC addresses. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## MACAllowOnly (string\[]) Specifies the Security 'MAC Allow Only' MAC addresses. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## WebRequestsURL (string) Set a URL for Web requests. This is the URL that will open when a user enters the IP address of the RAS Secure Gateway server in a web browser. For the URL to work, the gateway mode must be set to Normal. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## WebCookie (string) Set the Web Cookie Name used by RAS. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## UseSecureWebCookie (bool) Enable or disable the addition of the secure attribute to the cookie to the Web Cookie. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` (CommonParameters) ``` This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters documentation. ``` ## INPUTS -none- ## OUTPUTS -none- ## EXAMPLES \*\*---------- EXAMPLE 1 ---------- Set-RASGatewayDefaultSettings -SiteId 2 -GatewayPort 90 Sets the default value of the GatewayPort property for the specified site. ## RELATED LINKS * [Get-RASGatewayDefaultSettings](https://docs.parallels.com/landing/ras-powershell-api-guide/v20/parallels-ras-powershell-admin-module/commands/get-rasgatewaydefaultsettings) * [Set-RASGateway](https://docs.parallels.com/landing/ras-powershell-api-guide/v20/parallels-ras-powershell-admin-module/commands/set-rasgateway)