# New-RASHALB ### NAME New-RASHALB\
### SYNOPSIS Creates a new instance of the HALB Virtual server settings.\
### SYNTAX New-RASHALB \[-[Name](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#Name)] *\* \[\[-[SiteId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#SiteId)] *\*] \[\[-[LBGateways](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#LBGateways)] *\*] \[\[-[LBGatewayPort](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#LBGatewayPort)] *\*] \[\[-[EnableSSLPayload](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#EnableSSLPayload)] *\*] \[\[-[SSLMode](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#SSLMode)] {SSLOffloading | SSLPassthrough}] \[\[-[LBSSLGateways](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#LBSSLGateways)] *\*] \[\[-[LBSSLGatewayPort](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#LBSSLGatewayPort)] *\*] \[\[-[AcceptedSSLVersion](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#AcceptedSSLVersion)] {TLSv1 | TLSv1\_1 | TLSv1\_2 | TLSv1\_3}] \[\[-[CipherStrength](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#CipherStrength)] {Low | Medium | High | Custom}] \[\[-[SSLCustomCipher](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#SSLCustomCipher)] *\*] \[\[-[CertificateID](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#CertificateID)] *\*] \[\[-[Description](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#Description)] *\*] \[\[-[EnableDeviceManagement](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#EnableDeviceManagement)] *\*] \[\[-[DeviceManagerGateways](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#DeviceManagerGateways)] *\*] \[-[IPVersion](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#IPVersion)] {Version4 | Version6 | BothVersions} \[\[-[VirtualIPv4](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#VirtualIPv4)] *\*] \[\[-[SubnetMask](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#SubnetMask)] *\*] \[\[-[VirtualIPv6](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#VirtualIPv6)] *\*] \[\[-[PrefixIPV6](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#PrefixIPV6)] *\*] \[\[-[DeviceIPs](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#DeviceIPs)] *\*] \[\[-[EnableGatewayPayload](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#EnableGatewayPayload)] *\*] \[-[CipherPreference](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#CipherPreference) *\*] \[-[ClientIdleTimeout](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#ClientIdleTimeout) *\*] \[-[ClientQueueTimeout](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#ClientQueueTimeout) *\*] \[-[EnableOSUpdates](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#EnableOSUpdates) *\*] \[-[EnableTunneling](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#EnableTunneling) *\*] \[-[GatewayConnectionTimeout](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#GatewayConnectionTimeout) *\*] \[-[GatewayHealthCheckIntervals](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#GatewayHealthCheckIntervals) *\*] \[-[GatewayIdleTimeout](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#GatewayIdleTimeout) *\*] \[-[KeepLBProxyConfig](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#KeepLBProxyConfig) *\*] \[-[KeepVRRPConfig](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#KeepVRRPConfig) *\*] \[-[MaxTCPConnections](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#MaxTCPConnections) *\*] \[-[NoInstall](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#NoInstall) *\*] \[-[PublicAddress](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#PublicAddress) *\*] \[-[SessionRate](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#SessionRate) *\*] \[-[VRRPAdvertisementInterval](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#VRRPAdvertisementInterval) *\*] \[-[VRRPAuthenticationPassword](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#VRRPAuthenticationPassword) *\*] \[-[VRRPBroadcastInterval](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#VRRPBroadcastInterval) *\*] \[-[VRRPHealthScriptCheckInterval](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#VRRPHealthScriptCheckInterval) *\*] \[-[VRRPHealthScriptCheckTimeout](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#VRRPHealthScriptCheckTimeout) *\*] \[-[VRRPVirtualRouterID](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#VRRPVirtualRouterID) *\*] \[*<*[*CommonParameters*](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASHALB.html#CommonParameters)*>*]\
### DESCRIPTION Can also intialize the HALB Devices that were specified.\
### PARAMETERS \ -**Name \**\ The HALB Virtual Server name.\
``` Required? true ``` ``` Position? 0 ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**SiteId \**\ The site ID where the HALB settings will be created.\
``` Required? false ``` ``` Position? 1 ``` ``` Default value 0 ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**IPVersion <**[**IPVersion**](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/IPVersion.html)**>**\ The supported IP versions of the HALB Virtual Server.\ \ Possible values: Version4, Version6, BothVersions\
``` Required? true ``` ``` Position? 3 ``` ``` Default value Version4 ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**DeviceIPs \**\ The list of the HALB Device IPs.\
``` Required? false ``` ``` Position? 8 ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**EnableGatewayPayload \**\ Enable/Disable the Non-SSL Gateway configuration of the HALB Virtual Server .\
``` Required? false ``` ``` Position? 9 ``` ``` Default value False ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**EnableSSLPayload \**\ Enable/Disable the SSL Gateway configuration of the HALB Virtual Server.\
``` Required? false ``` ``` Position? 12 ``` ``` Default value False ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**EnableDeviceManagement \**\ Enable/Disable the Device Management configuration of the HALB Virtual Server.\
``` Required? false ``` ``` Position? 20 ``` ``` Default value False ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**NoInstall \**\ If the switch is set, HALB Devices will not be initialized.\
``` Required? false ``` ``` Position? named ``` ``` Default value False ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**Description \**\ The HALB Virtual Server description.\
``` Required? false ``` ``` Position? 2 ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**PublicAddress \**\ The HALB Virtual Server Public Address.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**VirtualIPv4 \**\ The IPv4 of the HALB Virtual Server.\
``` Required? false ``` ``` Position? 4 ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**SubnetMask \**\ The Subnet Mask of the HALB Virtual Server.\
``` Required? false ``` ``` Position? 5 ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**VirtualIPv6 \**\ The IPv6 of the HALB Virtual Server.\
``` Required? false ``` ``` Position? 6 ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**PrefixIPV6 \**\ The IPv6 Prefix of the HALB Virtual Server.\
``` Required? false ``` ``` Position? 7 ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**EnableTunneling \**\ Enable/Disable the RDP/UDP of the HALB Virtual Server.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**MaxTCPConnections \**\ The Maximum allowed TCP Connections to the HALB Virtual Server.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**VRRPAuthenticationPassword \**\ The VRRP Authentication password.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**ClientIdleTimeout \**\ The client inactivity timeout.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**GatewayConnectionTimeout \**\ The Gateway connection timeout.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**ClientQueueTimeout \**\ The client queue timeout.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**GatewayIdleTimeout \**\ The Gateway inactivity timeout.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**SessionRate \**\ The amount of TCP connections per second.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**GatewayHealthCheckIntervals \**\ The Gateway Health check intervals in seconds.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**VRRPVirtualRouterID \**\ The Virtual Router ID of HALB Virtual Server (if not set, the router ID will be automatically computed).\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**VRRPBroadcastInterval \**\ The VRRP broadcast interval in minutes.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**VRRPHealthScriptCheckInterval \**\ The VRRP health script check interval in seconds.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**VRRPHealthScriptCheckTimeout \**\ The VRRP health script check timeout in seconds.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**VRRPAdvertisementInterval \**\ The VRRP Advertisement interval in seconds.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**EnableOSUpdates \**\ Enable/Disable OS updates.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**KeepLBProxyConfig \**\ Enable/Disable keeping of existing loadbalancing settings.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**KeepVRRPConfig \**\ Enable/Disable keeping of existing VRRP/keepalive settings.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**LBGateways \**\ The list of the Non-SSL Gateways for HALB Virtual Server.\
``` Required? false ``` ``` Position? 10 ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**LBGatewayPort \**\ The Non-SSL Gateway port.\
``` Required? false ``` ``` Position? 11 ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**SSLMode <**[**LoadBalancingSSLMode**](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/LoadBalancingSSLMode.html)**>**\ The SSL Mode to use for SSL Gateways.\ \ Possible values: SSLOffloading, SSLPassthrough\
``` Required? false ``` ``` Position? 13 ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**LBSSLGateways \**\ The list of the SSL Gateways for HALB Virtual Server.\
``` Required? false ``` ``` Position? 14 ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**LBSSLGatewayPort \**\ The SSL Gateway port.\
``` Required? false ``` ``` Position? 15 ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**AcceptedSSLVersion <**[**AcceptedSSLVersion**](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/AcceptedSSLVersion.html)**>**\ The SSL version to be used for the SSL Gateways.\ \ Possible values: TLSv1, TLSv1\_1, TLSv1\_2, TLSv1\_3\
``` Required? false ``` ``` Position? 16 ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**CipherStrength <**[**CipherStrength**](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/CipherStrength.html)**>**\ The Cipher strength to be used for the SSL Gateways.\ \ Possible values: Low, Medium, High, Custom\
``` Required? false ``` ``` Position? 17 ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**CipherPreference \**\ Enable or disable 'Use ciphers according to server preference'.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**SSLCustomCipher \**\ The SSL custom cipher for SSL Gateways.\
``` Required? false ``` ``` Position? 18 ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**CertificateID \**\ The certificate ID.\
``` Required? false ``` ``` Position? 19 ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**DeviceManagerGateways \**\ The list of the Device Management Gateways for HALB Virtual Server.\
``` Required? false ``` ``` Position? 21 ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ \ ``` This cmdlet supports the common parameters: Verbose, Debug, ``` ``` ErrorAction, ErrorVariable, WarningAction, WarningVariable, ``` ``` OutBuffer, PipelineVariable, and OutVariable. For more information, see ``` ``` about_CommonParameters . ```
### INPUTS -none- ### OUTPUTS [HALBSettings](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/HALBSettings.html) ### EXAMPLES \ \&#xNAN;**---------- EXAMPLE 1 ----------**\ \ New-RASHALB -Name "HALB-VirtualServer" -IPVersion Version4 -VirtualIPv4 "1.2.3.4" -SubnetMask "255.255.255.0" -DeviceIPs @("4.3.2.1", "1.2.1.2") -NoInstall\ \ To add the HALB Virtual Server to a specific site, add the -SiteId parameter. --- # 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-powershell-api-guide/v19/parallels-ras-powershell-admin-module/commands/new-rashalb.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.