# New-RASHALB ## NAME New-RASHALB ## SYNOPSIS Creates a new instance of the HALB Virtual server settings. ## SYNTAX **New-RASHALB** \[[Name](#name-string)] *(string)*\*\* \[\[-[SiteId](#siteid-string)] *(uint)*] \[\[-[LBGateways](#LBGateways)] *(List`1)*] [[-[LBGatewayPort](#lbgatewayport-string)] *(uint)*] [[-[EnableSSLPayload](#enablesslpayload-string)] *(SwitchParameter)*] [[-[SSLMode](#SSLMode)] {SSLOffloading | SSLPassthrough}] [[-[LBSSLGateways](#LBSSLGateways)] *(List`1)*] \[\[-[LBSSLGatewayPort](#lbsslgatewayport-string)] *(uint)*] \[\[-[AcceptedSSLVersion](#AcceptedSSLVersion)] {TLSv1 | TLSv1\_1 | TLSv1\_2 | TLSv1\_3}] \[\[-[CipherStrength](#CipherStrength)] {Low | Medium | High | Custom}] \[\[-[SSLCustomCipher](#sslcustomcipher-string)] *(string)*] \[\[-[CertificateID](#certificateid-string)] *(uint)*] \[\[-[Description](#description-string)] *(string)*] \[\[-[EnableDeviceManagement](#enabledevicemanagement-string)] *(SwitchParameter)*] \[\[-[DeviceManagerGateways](#DeviceManagerGateways)] *(List`1)*] [-[IPVersion](#IPVersion)] {Version4 | Version6 | BothVersions} [[-[VirtualIPv4](#virtualipv4-string)] *(string)*] [[-[SubnetMask](#subnetmask-string)] *(string)*] [[-[VirtualIPv6](#virtualipv6-string)] *(string)*] [[-[PrefixIPV6](#prefixipv6-string)] *(uint)*] [[-[DeviceIPs](#DeviceIPs)] *(List`1)*] \[\[-[EnableGatewayPayload](#enablegatewaypayload-string)] *(SwitchParameter)*] \[[CipherPreference](#cipherpreference-string) *(bool)*] \[[ClientIdleTimeout](#clientidletimeout-string) *(uint)*] \[[ClientQueueTimeout](#clientqueuetimeout-string) *(uint)*] \[[EnableTunneling](#enabletunneling-string) *(bool)*] \[[GatewayConnectionTimeout](#gatewayconnectiontimeout-string) *(uint)*] \[[GatewayHealthCheckIntervals](#gatewayhealthcheckintervals-string) *(uint)*] \[[GatewayIdleTimeout](#gatewayidletimeout-string) *(uint)*] \[[KeepLBProxyConfig](#keeplbproxyconfig-string) *(bool)*] \[[KeepVRRPConfig](#keepvrrpconfig-string) *(bool)*] \[[MaxTCPConnections](#maxtcpconnections-string) *(uint)*] \[[NoInstall](#noinstall-string) *(SwitchParameter)*] \[[PublicAddress](#publicaddress-string) *(string)*] \[[SessionRate](#sessionrate-string) *(uint)*] \[[VRRPAdvertisementInterval](#vrrpadvertisementinterval-string) *(uint)*] \[[VRRPAuthenticationPassword](#vrrpauthenticationpassword-string) *(SecureString)*] \[[VRRPBroadcastInterval](#vrrpbroadcastinterval-string) *(uint)*] \[[VRRPHealthScriptCheckInterval](#vrrphealthscriptcheckinterval-string) *(uint)*] \[[VRRPHealthScriptCheckTimeout](#vrrphealthscriptchecktimeout-string) *(uint)*] \[[VRRPVirtualRouterID](#vrrpvirtualrouterid-string) *(uint)*] \[*(*[*CommonParameters*](#CommonParameters)*)*] ## DESCRIPTION Can also intialize the HALB Devices that were specified. ## PARAMETERS ## Name (string) The HALB Virtual Server name. ``` Required? true Position? 0 Default value Accept pipeline input? false Accept wildcard characters? false ``` ## SiteId (uint) 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://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/ipversion)) 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 (List\`1) The list of the HALB Device IPs. ``` Required? false Position? 8 Default value Accept pipeline input? false Accept wildcard characters? false ``` ## EnableGatewayPayload (SwitchParameter) 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 (SwitchParameter) 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 (SwitchParameter) 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 (SwitchParameter) 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 (string) The HALB Virtual Server description. ``` Required? false Position? 2 Default value Accept pipeline input? false Accept wildcard characters? false ``` ## PublicAddress (string) The HALB Virtual Server Public Address. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## VirtualIPv4 (string) The IPv4 of the HALB Virtual Server. ``` Required? false Position? 4 Default value Accept pipeline input? false Accept wildcard characters? false ``` ## SubnetMask (string) The Subnet Mask of the HALB Virtual Server. ``` Required? false Position? 5 Default value Accept pipeline input? false Accept wildcard characters? false ``` ## VirtualIPv6 (string) The IPv6 of the HALB Virtual Server. ``` Required? false Position? 6 Default value Accept pipeline input? false Accept wildcard characters? false ``` ## PrefixIPV6 (uint) The IPv6 Prefix of the HALB Virtual Server. ``` Required? false Position? 7 Default value Accept pipeline input? false Accept wildcard characters? false ``` ## EnableTunneling (bool) 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 (uint) 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 (SecureString) The VRRP Authentication password. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## ClientIdleTimeout (uint) The client inactivity timeout. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## GatewayConnectionTimeout (uint) The Gateway connection timeout. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## ClientQueueTimeout (uint) The client queue timeout. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## GatewayIdleTimeout (uint) The Gateway inactivity timeout. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## SessionRate (uint) The amount of TCP connections per second. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## GatewayHealthCheckIntervals (uint) The Gateway Health check intervals in seconds. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## VRRPVirtualRouterID (uint) 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 (uint) The VRRP broadcast interval in minutes. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## VRRPHealthScriptCheckInterval (uint) The VRRP health script check interval in seconds. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## VRRPHealthScriptCheckTimeout (uint) The VRRP health script check timeout in seconds. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## VRRPAdvertisementInterval (uint) The VRRP Advertisement interval in seconds. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## KeepLBProxyConfig (bool) Enable/Disable keeping of existing loadbalancing settings. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## KeepVRRPConfig (bool) Enable/Disable keeping of existing VRRP/keepalive settings. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## LBGateways (List\`1) 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 (uint) The Non-SSL Gateway port. ``` Required? false Position? 11 Default value Accept pipeline input? false Accept wildcard characters? false ``` ## SSLMode ([LoadBalancingSSLMode](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/loadbalancingsslmode)) 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 (List\`1) 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 (uint) The SSL Gateway port. ``` Required? false Position? 15 Default value Accept pipeline input? false Accept wildcard characters? false ``` ## AcceptedSSLVersion ([AcceptedSSLVersion](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/acceptedsslversion)) 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://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/cipherstrength)) 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 (bool) Enable or disable 'Use ciphers according to server preference'. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## SSLCustomCipher (string) The SSL custom cipher for SSL Gateways. ``` Required? false Position? 18 Default value Accept pipeline input? false Accept wildcard characters? false ``` ## CertificateID (uint) The certificate ID. ``` Required? false Position? 19 Default value Accept pipeline input? false Accept wildcard characters? false ``` ## DeviceManagerGateways (List\`1) 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 ``` (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 [HALBSettings](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/halbsettings) ## EXAMPLES **---------- 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. ## RELATED LINKS * [Get-RASHALB](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/commands/get-rashalb) * [Set-RASHALB](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/commands/set-rashalb) * [Remove-RASHALB](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/commands/remove-rashalb) * [Get-RASHALBStatus](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/commands/get-rashalbstatus)