> For the complete documentation index, see [llms.txt](https://docs.parallels.com/landing/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/set-rasgateway.md).

# Set-RASGateway

## SYNOPSIS

Modifies properties of a RAS Secure Gateway.

## SYNTAX

```powershell
Set-RASGateway [-Id] <uint> [-AllClientConnectionsLimit <uint>] [-AllConnectionsLimit <uint>]
 [-AllowAppsInNewTab <bool>] [-AllowCORS <bool>] [-AllowedDomainsForCORS <List`1>]
 [-AllowEmbed <bool>] [-AllowLaunchMethod <bool>] [-AllowWebSocketsWithMissingOrigin <bool>]
 [-AlternateNLBHost <string>] [-AlternateNLBPort <uint>] [-AutoCertificate <SwitchParameter>]
 [-AutoPreferredConnectionBroker <SwitchParameter>] [-BackendLimit <uint>]
 [-BindV4Addresses <string>] [-BindV6Addresses <string>] [-BlockAccessDeprecatedWebAPI <bool>]
 [-BlockAccessSessionLaunchCBAPI <bool>] [-BlockAccessSessionLaunchWebAPI <bool>]
 [-BlockAccessStandardRASSessions <bool>] [-BlockAccessUserPortal <bool>] [-BlockedTimeout <uint>]
 [-Broadcast <bool>] [-BrowserCacheTimeInMonths <uint>] [-CertificateFile <string>]
 [-CertificateId <uint>] [-CertificateObj <Certificate>] [-Cipher <string>]
 [-CipherPreference <bool>] [-CipherStrength {Low | Medium | High | Custom}]
 [-ClientDetectionTimeout <uint>] [-ClientIPPDetectionServiceURL <string>] [-ClientLimit <uint>]
 [-ClientNewAuthLimit <uint>] [-ClientTunnelingViaAPILimit <uint>]
 [-ClipboardDirection {None | ClientToServer | ServerToClient | Bidirectional}]
 [-Description <string>] [-DetectClientMode {Automatic | Manual}] [-DisableWyseCertWarn <bool>]
 [-DOSPro <bool>] [-EnableAlternateNLBHost <bool>] [-EnableAlternateNLBPort <bool>]
 [-Enabled <bool>] [-EnableDeviceManagerPort <bool>] [-EnableGatewayPort <bool>]
 [-EnableHSTS <bool>] [-EnableRDP <bool>] [-EnableRDPUDP <bool>] [-EnableSSL <bool>]
 [-EnableUserPortal <bool>] [-EnableWyseSupport <bool>]
 [-FileTransferMode {Disabled | ClientToServer | ServerToClient | Bidirectional}]
 [-ForwardGatewayServers <string>] [-ForwardHttpServers <string>] [-GatewayPort <uint>]
 [-HSTSIncludeSubdomains <bool>] [-HSTSMaxAge <uint>] [-HSTSPreload <bool>] [-HTTPLimit <uint>]
 [-InheritDefaultModeSettings <bool>] [-InheritDefaultNetworkSettings <bool>]
 [-InheritDefaultSecuritySettings <bool>] [-InheritDefaultSslTlsSettings <bool>]
 [-InheritDefaultUserPortalSettings <bool>] [-InheritDefaultWebSettings <bool>]
 [-InheritDefaultWyseSettings <bool>] [-IPs <string>]
 [-IPVersion {Version4 | Version6 | BothVersions}]
 [-LaunchMethod {ParallelsClientAndWebClient | ParallelsClient | WebClient}] [-LimitsEnabled <bool>]
 [-MACAllowExcept <string[]>] [-MACAllowOnly <string[]>]
 [-MinSSLVersion {TLSv1 | TLSv1_1 | TLSv1_2 | TLSv1_3}] [-Mode {Normal | Forwarding}]
 [-NewServer <string>] [-NormalModeForwarding <bool>] [-OnlyAllowAcmeHttp <bool>]
 [-OptimizeConnectionIPv4 <string>] [-OptimizeConnectionIPv6 <string>] [-PfxFile <string>]
 [-PfxPassword <SecureString>] [-PreferredConnectionBrokerId <uint>]
 [-PreferredConnectionBrokerObj <ConnectionBroker>] [-PrivateKeyFile <string>]
 [-PublicAddress <string>] [-RDPPort <uint>] [-SecurityMode {AllowAllExcept | AllowOnly}]
 [-SSLPort <uint>] [-UseAutoKeyboardDetect <bool>] [-UseClientIPDetectionService <bool>]
 [-UsePreWin2000LoginFormat <bool>] [-UserPortalLimit <uint>] [-UserPortalPort <uint>]
 [-UseSecureWebCookie <bool>] [-WebAPISecret <string>] [-WebCookie <string>]
 [-WebRequestsURL <string>] [-WyseLimit <uint>] [<CommonParameters>]
```

```powershell
Set-RASGateway [-InputObject] <Gateway> [-AllClientConnectionsLimit <uint>]
 [-AllConnectionsLimit <uint>] [-AllowAppsInNewTab <bool>] [-AllowCORS <bool>]
 [-AllowedDomainsForCORS <List`1>] [-AllowEmbed <bool>] [-AllowLaunchMethod <bool>]
 [-AllowWebSocketsWithMissingOrigin <bool>] [-AlternateNLBHost <string>] [-AlternateNLBPort <uint>]
 [-AutoCertificate <SwitchParameter>] [-AutoPreferredConnectionBroker <SwitchParameter>]
 [-BackendLimit <uint>] [-BindV4Addresses <string>] [-BindV6Addresses <string>]
 [-BlockAccessDeprecatedWebAPI <bool>] [-BlockAccessSessionLaunchCBAPI <bool>]
 [-BlockAccessSessionLaunchWebAPI <bool>] [-BlockAccessStandardRASSessions <bool>]
 [-BlockAccessUserPortal <bool>] [-BlockedTimeout <uint>] [-Broadcast <bool>]
 [-BrowserCacheTimeInMonths <uint>] [-CertificateFile <string>] [-CertificateId <uint>]
 [-CertificateObj <Certificate>] [-Cipher <string>] [-CipherPreference <bool>]
 [-CipherStrength {Low | Medium | High | Custom}] [-ClientDetectionTimeout <uint>]
 [-ClientIPPDetectionServiceURL <string>] [-ClientLimit <uint>] [-ClientNewAuthLimit <uint>]
 [-ClientTunnelingViaAPILimit <uint>]
 [-ClipboardDirection {None | ClientToServer | ServerToClient | Bidirectional}]
 [-Description <string>] [-DetectClientMode {Automatic | Manual}] [-DisableWyseCertWarn <bool>]
 [-DOSPro <bool>] [-EnableAlternateNLBHost <bool>] [-EnableAlternateNLBPort <bool>]
 [-Enabled <bool>] [-EnableDeviceManagerPort <bool>] [-EnableGatewayPort <bool>]
 [-EnableHSTS <bool>] [-EnableRDP <bool>] [-EnableRDPUDP <bool>] [-EnableSSL <bool>]
 [-EnableUserPortal <bool>] [-EnableWyseSupport <bool>]
 [-FileTransferMode {Disabled | ClientToServer | ServerToClient | Bidirectional}]
 [-ForwardGatewayServers <string>] [-ForwardHttpServers <string>] [-GatewayPort <uint>]
 [-HSTSIncludeSubdomains <bool>] [-HSTSMaxAge <uint>] [-HSTSPreload <bool>] [-HTTPLimit <uint>]
 [-InheritDefaultModeSettings <bool>] [-InheritDefaultNetworkSettings <bool>]
 [-InheritDefaultSecuritySettings <bool>] [-InheritDefaultSslTlsSettings <bool>]
 [-InheritDefaultUserPortalSettings <bool>] [-InheritDefaultWebSettings <bool>]
 [-InheritDefaultWyseSettings <bool>] [-IPs <string>]
 [-IPVersion {Version4 | Version6 | BothVersions}]
 [-LaunchMethod {ParallelsClientAndWebClient | ParallelsClient | WebClient}] [-LimitsEnabled <bool>]
 [-MACAllowExcept <string[]>] [-MACAllowOnly <string[]>]
 [-MinSSLVersion {TLSv1 | TLSv1_1 | TLSv1_2 | TLSv1_3}] [-Mode {Normal | Forwarding}]
 [-NewServer <string>] [-NormalModeForwarding <bool>] [-OnlyAllowAcmeHttp <bool>]
 [-OptimizeConnectionIPv4 <string>] [-OptimizeConnectionIPv6 <string>] [-PfxFile <string>]
 [-PfxPassword <SecureString>] [-PreferredConnectionBrokerId <uint>]
 [-PreferredConnectionBrokerObj <ConnectionBroker>] [-PrivateKeyFile <string>]
 [-PublicAddress <string>] [-RDPPort <uint>] [-SecurityMode {AllowAllExcept | AllowOnly}]
 [-SSLPort <uint>] [-UseAutoKeyboardDetect <bool>] [-UseClientIPDetectionService <bool>]
 [-UsePreWin2000LoginFormat <bool>] [-UserPortalLimit <uint>] [-UserPortalPort <uint>]
 [-UseSecureWebCookie <bool>] [-WebAPISecret <string>] [-WebCookie <string>]
 [-WebRequestsURL <string>] [-WyseLimit <uint>] [<CommonParameters>]
```

```powershell
Set-RASGateway [-Server] <string> [[-SiteId] <uint>] [-AllClientConnectionsLimit <uint>]
 [-AllConnectionsLimit <uint>] [-AllowAppsInNewTab <bool>] [-AllowCORS <bool>]
 [-AllowedDomainsForCORS <List`1>] [-AllowEmbed <bool>] [-AllowLaunchMethod <bool>]
 [-AllowWebSocketsWithMissingOrigin <bool>] [-AlternateNLBHost <string>] [-AlternateNLBPort <uint>]
 [-AutoCertificate <SwitchParameter>] [-AutoPreferredConnectionBroker <SwitchParameter>]
 [-BackendLimit <uint>] [-BindV4Addresses <string>] [-BindV6Addresses <string>]
 [-BlockAccessDeprecatedWebAPI <bool>] [-BlockAccessSessionLaunchCBAPI <bool>]
 [-BlockAccessSessionLaunchWebAPI <bool>] [-BlockAccessStandardRASSessions <bool>]
 [-BlockAccessUserPortal <bool>] [-BlockedTimeout <uint>] [-Broadcast <bool>]
 [-BrowserCacheTimeInMonths <uint>] [-CertificateFile <string>] [-CertificateId <uint>]
 [-CertificateObj <Certificate>] [-Cipher <string>] [-CipherPreference <bool>]
 [-CipherStrength {Low | Medium | High | Custom}] [-ClientDetectionTimeout <uint>]
 [-ClientIPPDetectionServiceURL <string>] [-ClientLimit <uint>] [-ClientNewAuthLimit <uint>]
 [-ClientTunnelingViaAPILimit <uint>]
 [-ClipboardDirection {None | ClientToServer | ServerToClient | Bidirectional}]
 [-Description <string>] [-DetectClientMode {Automatic | Manual}] [-DisableWyseCertWarn <bool>]
 [-DOSPro <bool>] [-EnableAlternateNLBHost <bool>] [-EnableAlternateNLBPort <bool>]
 [-Enabled <bool>] [-EnableDeviceManagerPort <bool>] [-EnableGatewayPort <bool>]
 [-EnableHSTS <bool>] [-EnableRDP <bool>] [-EnableRDPUDP <bool>] [-EnableSSL <bool>]
 [-EnableUserPortal <bool>] [-EnableWyseSupport <bool>]
 [-FileTransferMode {Disabled | ClientToServer | ServerToClient | Bidirectional}]
 [-ForwardGatewayServers <string>] [-ForwardHttpServers <string>] [-GatewayPort <uint>]
 [-HSTSIncludeSubdomains <bool>] [-HSTSMaxAge <uint>] [-HSTSPreload <bool>] [-HTTPLimit <uint>]
 [-InheritDefaultModeSettings <bool>] [-InheritDefaultNetworkSettings <bool>]
 [-InheritDefaultSecuritySettings <bool>] [-InheritDefaultSslTlsSettings <bool>]
 [-InheritDefaultUserPortalSettings <bool>] [-InheritDefaultWebSettings <bool>]
 [-InheritDefaultWyseSettings <bool>] [-IPs <string>]
 [-IPVersion {Version4 | Version6 | BothVersions}]
 [-LaunchMethod {ParallelsClientAndWebClient | ParallelsClient | WebClient}] [-LimitsEnabled <bool>]
 [-MACAllowExcept <string[]>] [-MACAllowOnly <string[]>]
 [-MinSSLVersion {TLSv1 | TLSv1_1 | TLSv1_2 | TLSv1_3}] [-Mode {Normal | Forwarding}]
 [-NewServer <string>] [-NormalModeForwarding <bool>] [-OnlyAllowAcmeHttp <bool>]
 [-OptimizeConnectionIPv4 <string>] [-OptimizeConnectionIPv6 <string>] [-PfxFile <string>]
 [-PfxPassword <SecureString>] [-PreferredConnectionBrokerId <uint>]
 [-PreferredConnectionBrokerObj <ConnectionBroker>] [-PrivateKeyFile <string>]
 [-PublicAddress <string>] [-RDPPort <uint>] [-SecurityMode {AllowAllExcept | AllowOnly}]
 [-SSLPort <uint>] [-UseAutoKeyboardDetect <bool>] [-UseClientIPDetectionService <bool>]
 [-UsePreWin2000LoginFormat <bool>] [-UserPortalLimit <uint>] [-UserPortalPort <uint>]
 [-UseSecureWebCookie <bool>] [-WebAPISecret <string>] [-WebCookie <string>]
 [-WebRequestsURL <string>] [-WyseLimit <uint>] [<CommonParameters>]
```

## DESCRIPTION

Modifies properties of a RAS Secure Gateway.

When executing the cmdlet, you can include only the parameters that you want to modify.

## EXAMPLES

### Example 1

```powershell
Set-RASGateway "server.company.dom" -Enable $False
```

Disables the specified RAS Secure Gateway in the Licensing Server site.

To disable a RAS Secure Gateway in a specific site, specify the -SiteId parameter.

All parameters except -Server are optional and only passed if they need to be updated.

### Example 2

```powershell
Set-RASGateway -Id "1" -Enable $True
```

Enables the RAS Secure Gateway specified by ID.

### Example 3

```powershell
Set-RASGateway $Gateway -Enable $False
```

Disables a RAS Secure Gateway specified by Gateway object ($Gateway variable).

A Gateway object representing a RAS Secure Gateway is obtained using the Get-RASGateway cmdlet.

### Example 4

```powershell
Get-RASGateway -Id 1 | Set-RASGateway -Enable $False
```

Disables the RAS Secure Gateway which is identified by an object obtained from the pipeline output.

### Example 5

```powershell
Get-RASGateway -Id 1 | Set-RASGateway -Description "My new Gateway description"
```

Modifies the description of the RAS Secure Gateway obtained from the pipeline output.

## PARAMETERS

### -Server

The name of the RAS Secure Gateway to modify.

The name can be either FQDN or IP address, but you have to enter the actual name this server has in the RAS farm.

```yaml
Type: string
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -SiteId

The site ID to which the Secure Gateway belongs.

```yaml
Type: uint
Required: False
Position: 1
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
```

### -Id

The ID of the Secure Gateway to modify.

```yaml
Type: uint
Required: True
Position: 0
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
```

### -InputObject

The Secure Gateway object to be modified.

A Secure Gateway object representing a Secure Gateway is obtained using the Get-RASGateway cmdlet.

Type reference: [Gateway](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/gateway.md)

```yaml
Type: Gateway
Required: True
Position: 0
Default value: None
Accept pipeline input: true (ByValue)
Accept wildcard characters: False
```

### -Enabled

Enable or disable the specified Secure Gateway.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -NewServer

The new Secure Gateway name. The name must be either a valid FQDN or a valid IP address.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Description

A user-defined Secure Gateway description.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -PublicAddress

The Public Address of the Secure Gateway.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -IPVersion

The IP version for the Secure Gateway to use. Accepted values: Version4 (IPv4), Version6 (IPv6), BothVersions (both IPv4 and IPv6).

Possible values: Version4, Version6, BothVersions

Type reference: [IPVersion](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/ipversion.md)

```yaml
Type: IPVersion
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -IPs

One or multiple (separated by comma) IP addresses.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -BindV4Addresses

IPv4 address to bind to.

If '0.0.0.0' is passed, will bind to all available addresses.

When using a specific address, it has to be available in the IPv4 address list.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -OptimizeConnectionIPv4

Optimize connection for the list of IPv4 (comma separated values).

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -BindV6Addresses

IPv6 address to bind to.

If '::' is passed, will bind to all available addresses.

When using a specific address, it has to be available in the IPv6 address list.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -OptimizeConnectionIPv6

Optimize connection for the list of IPv6 (comma separated values).

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -InheritDefaultModeSettings

Enable or disable default mode settings.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -InheritDefaultNetworkSettings

Enable or disable default network settings.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -InheritDefaultSslTlsSettings

Enable or disable default SSL/TLS setting.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -InheritDefaultUserPortalSettings

Enable or disable default User Portal settings.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -InheritDefaultWyseSettings

Enable or disable default wyse settings.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -InheritDefaultSecuritySettings

Enable or disable default security settingsd.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -InheritDefaultWebSettings

Enable or disable default web settings.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Mode

Gateway Mode. Accepted values: Normal, Forwarding.

Possible values: Normal, Forwarding

Type reference: [Gateway](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/gateway.md)

```yaml
Type: Gateway
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -NormalModeForwarding

Forward requests to HTTP server.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -ForwardGatewayServers

One or multiple (separated by comma) Forwarding Gateway Servers.

E.g. localhost:80, web1

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -AutoPreferredConnectionBroker

Set preferred Connection Broker Automatically.

```yaml
Type: SwitchParameter
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
```

### -PreferredConnectionBrokerObj

The preferred Connection Broker.

To obtain an object of type Broker representing the Preferred Connection Broker, use the Get-RASConnectionBroker cmdlet.

Type reference: [ConnectionBroker](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/connectionbroker.md)

```yaml
Type: ConnectionBroker
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -PreferredConnectionBrokerId

The preferred Connection Broker ID.

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -ForwardHttpServers

One or multiple (separated by comma) Forwarding HTTP Servers.

E.g. localhost:81, web1

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -EnableGatewayPort

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.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -GatewayPort

A custom Gateway port number. For this port to take effect, the EnableGatewayPort parameters must be set to $True.

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -OnlyAllowAcmeHttp

Whether to ignore all incoming requests except for Acme ones received on 'GatewayPort'

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -EnableRDP

Enable or disable a custom RDP port.

To specify a custom port number, use the RDPPort parameter.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -RDPPort

A custom RDP port number. For this port to take effect, the EnableRDPPort parameter must be set to True.

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Broadcast

Enable or disable the 'Broadcast RAS Secure Gateway Address' option.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -EnableRDPUDP

Enable or disable the 'RDP UDP Data Tunneling' option.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -EnableDeviceManagerPort

Enable or disable the 'Device Manager Port' option.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -DOSPro

Enable or disable the 'RDP DOS Attack Filter' option.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -EnableSSL

Enable or disable SSL on the port specified in the SSLPort parameter.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -SSLPort

SSL port number. To enable the port, set the EnableSSL port parameter to True.

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -MinSSLVersion

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

Type reference: [AcceptedSSLVersion](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/acceptedsslversion.md)

```yaml
Type: AcceptedSSLVersion
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -CipherStrength

Cipher strength. Accepted values: Low, Medium, High, Custom.

Possible values: Low, Medium, High, Custom

Type reference: [CipherStrength](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/cipherstrength.md)

```yaml
Type: CipherStrength
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Cipher

Cipher string.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -CipherPreference

Enable or disable Use ciphers according to server preference.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -AutoCertificate

Set Certificate Automatically.

```yaml
Type: SwitchParameter
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
```

### -CertificateObj

The Certificate.

To obtain an object of type Certificate, use the Get-Certificate cmdlet.

Certificate Set Priority 1. This value will be used if specified.

Type reference: [Certificate](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/certificate.md)

```yaml
Type: Certificate
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -CertificateId

The Certificate ID.

Certificate Set Priority 2. This value will be ignored if a CertificateObj is specified.

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -PfxFile

Certificate file name in pfx format.

Certificate Set Priority 3. This value will be ignored if a CertificateObj/CertificateId is specified.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -PfxPassword

The password of the pfx file specified in the PfxFile parameter.

```yaml
Type: SecureString
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -CertificateFile

Certificate file name.

Certificate Set Priority 4. This value will be ignored if a CertificateObj/CertificateId/PfxFile is specified.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -PrivateKeyFile

Private key file name.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -EnableHSTS

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.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -HSTSMaxAge

Specifies the HSTS maximum age.

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -HSTSIncludeSubdomains

Enable or disable the HSTS sub-domains.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -HSTSPreload

Enable or disable the HSTS preload.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -EnableUserPortal

Enable or disable User Portal connectivity on the Gateway.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -UserPortalPort

A custom User Portal port number.

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -LaunchMethod

Launch method.

Possible values: ParallelsClientAndWebClient, ParallelsClient, WebClient

Type reference: [LaunchMethod](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/launchmethod.md)

```yaml
Type: LaunchMethod
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -AllowLaunchMethod

Allow users to select a resource launch method.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -AllowAppsInNewTab

Allow users to start applications in a new browser tab.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -UsePreWin2000LoginFormat

Enable or disable the 'Use Pre Windows 2000 Login Format' option.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -AllowEmbed

Allow embedding of Web Client into other web pages.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -UseAutoKeyboardDetect

Use automatic keyboard layout detection.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -FileTransferMode

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

Type reference: [FileTransferControlMode](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/filetransfercontrolmode.md)

```yaml
Type: FileTransferControlMode
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -ClipboardDirection

State of clipboard direction.

Possible values: None, ClientToServer, ServerToClient, Bidirectional

Type reference: [ClipboardDirections](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/clipboarddirections.md)

```yaml
Type: ClipboardDirections
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -AllowCORS

Allow cross-origin resource sharing.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -AllowedDomainsForCORS

Allowed domains for cross-origin resource sharing.

```yaml
Type: List`1
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -UseClientIPDetectionService

Use Client IP detection service.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -ClientIPPDetectionServiceURL

Client IP detection service URL.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -DetectClientMode

Detection mode.

Automatically on sign in

Manually on user prompt (Default)

Possible values: Automatic, Manual

Type reference: [DetectClientMode](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/detectclientmode.md)

```yaml
Type: DetectClientMode
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -ClientDetectionTimeout

Client detection timeout in seconds.

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -BrowserCacheTimeInMonths

How long should the browser preserve the cache (in months).

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -EnableAlternateNLBHost

Enable or disable Alternate NLB host name specified in the EnableAlternateNLBHost parameter.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -AlternateNLBHost

Alternate NLB host name. To enable the host name, set the EnableAlternateNLBHost port parameter to True.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -EnableAlternateNLBPort

Enable or disable Alternate NLB on the port specified in the AlternateNLBPort parameter.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -AlternateNLBPort

Alternate NLB port number. To enable the port, set the EnableAlternateNLBPort port parameter to True.

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -EnableWyseSupport

Enable or disable Wyse ThinOS support.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -DisableWyseCertWarn

Enable or disable the warning if server certificate is not verified.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -SecurityMode

Security Mode. Accepted values: AllowAllExcept, AllowOnly.

Possible values: AllowAllExcept, AllowOnly

Type reference: [Gateway](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/gateway.md)

```yaml
Type: Gateway
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -MACAllowExcept

Specifies the Security 'MAC Allow Except' MAC addresses.

```yaml
Type: string[]
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -MACAllowOnly

Specifies the Security 'MAC Allow Only' MAC addresses.

```yaml
Type: string[]
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -BlockAccessStandardRASSessions

Blocks new authentication to standard RAS sessions, preventing application listing and remote session launch. Existing sessions are not affected.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -BlockAccessUserPortal

Blocks access to the User Portal user interface, including portal login and related pages such as cookie policy and download. Other APIs may still be used.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -BlockAccessSessionLaunchWebAPI

Blocks new session launch through the Web API. Existing sessions are not affected. BlockAccessSessionLaunchWebAPI enforces blocking of deprecated Web APIs.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -BlockAccessSessionLaunchCBAPI

Blocks new session launch through the Connection Broker API. Existing sessions are not affected.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -BlockAccessDeprecatedWebAPI

Blocks deprecated Web APIs to reduce security and compatibility risks. The BlockAccessDeprecatedWebAPI parameter can only be set if BlockAccessSessionLaunchWebAPI is disabled.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -LimitsEnabled

Whether the gateway limits are enabled or disabled.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -BlockedTimeout

Client: The blocked timeout in minutes.

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -AllClientConnectionsLimit

Client: The maximum number of All Client Connections allowed (0 = Unlimited).

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -UserPortalLimit

The maximum number of User Portal connections allowed (0 = Unlimited).

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -HTTPLimit

The maximum number of HTTP connections allowed (0 = Unlimited).

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -WyseLimit

The maximum number of WYSE connections allowed (0 = Unlimited).

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -ClientLimit

The maximum number of Client connections allowed (0 = Unlimited).

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -ClientNewAuthLimit

The maximum number of Client NewAuth connections allowed (0 = Unlimited).

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -ClientTunnelingViaAPILimit

The maximum number of Client Tunneling via API connections allowed (0 = Unlimited).

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -BackendLimit

The maximum number of Backend connections allowed (0 = Unlimited).

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -AllConnectionsLimit

The maximum number of All Connections allowed (0 = Unlimited).

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -WebAPISecret

The secret used in the JWT (JSON Web Token) for data exchanged between the caller and User portal.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -WebRequestsURL

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.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -WebCookie

Set the Web Cookie Name used by RAS.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -UseSecureWebCookie

Enable or disable the addition of the secure attribute to the cookie to the Web Cookie.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -AllowWebSocketsWithMissingOrigin

Enable or disable the use of Web Sockets with missing origin.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).

## INPUTS

### [Gateway](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/gateway.md)

## OUTPUTS

### None

## RELATED LINKS

* [New-RASGateway](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/new-rasgateway.md)
* [Get-RASGateway](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/get-rasgateway.md)
* [Remove-RASGateway](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/remove-rasgateway.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/set-rasgateway.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
