# New-RASHALB

## NAME

New-RASHALB

## SYNOPSIS

Creates a new instance of the HALB Virtual server settings.

## SYNTAX

**New-RASHALB** \[-[Name](#Name)] _\<string>_ \[\[-[SiteId](#SiteId)] _\<uint>_] \[\[-[LBGateways](#LBGateways)] _\<List\`1>_] \[\[-[LBGatewayPort](#LBGatewayPort)] _\<uint>_] \[\[-[EnableSSLPayload](#EnableSSLPayload)] _\<SwitchParameter>_] \[\[-[SSLMode](#SSLMode)] {SSLOffloading | SSLPassthrough}] \[\[-[LBSSLGateways](#LBSSLGateways)] _\<List\`1>_] \[\[-[LBSSLGatewayPort](#LBSSLGatewayPort)] _\<uint>_] \[\[-[AcceptedSSLVersion](#AcceptedSSLVersion)] {TLSv1 | TLSv1\_1 | TLSv1\_2 | TLSv1\_3}] \[\[-[CipherStrength](#CipherStrength)] {Low | Medium | High | Custom}] \[\[-[SSLCustomCipher](#SSLCustomCipher)] _\<string>_] \[\[-[CertificateID](#CertificateID)] _\<uint>_] \[\[-[Description](#Description)] _\<string>_] \[\[-[EnableDeviceManagement](#EnableDeviceManagement)] _\<SwitchParameter>_] \[\[-[DeviceManagerGateways](#DeviceManagerGateways)] _\<List\`1>_] \[-[IPVersion](#IPVersion)] {Version4 | Version6 | BothVersions} \[\[-[VirtualIPv4](#VirtualIPv4)] _\<string>_] \[\[-[SubnetMask](#SubnetMask)] _\<string>_] \[\[-[VirtualIPv6](#VirtualIPv6)] _\<string>_] \[\[-[PrefixIPV6](#PrefixIPV6)] _\<uint>_] \[\[-[DeviceIPs](#DeviceIPs)] _\<List\`1>_] \[\[-[EnableGatewayPayload](#EnableGatewayPayload)] _\<SwitchParameter>_] \[-[CipherPreference](#CipherPreference) _\<bool>_] \[-[ClientIdleTimeout](#ClientIdleTimeout) _\<uint>_] \[-[ClientQueueTimeout](#ClientQueueTimeout) _\<uint>_] \[-[EnableOSUpdates](#EnableOSUpdates) _\<bool>_] \[-[EnableTunneling](#EnableTunneling) _\<bool>_] \[-[GatewayConnectionTimeout](#GatewayConnectionTimeout) _\<uint>_] \[-[GatewayHealthCheckIntervals](#GatewayHealthCheckIntervals) _\<uint>_] \[-[GatewayIdleTimeout](#GatewayIdleTimeout) _\<uint>_] \[-[KeepLBProxyConfig](#KeepLBProxyConfig) _\<bool>_] \[-[KeepVRRPConfig](#KeepVRRPConfig) _\<bool>_] \[-[MaxTCPConnections](#MaxTCPConnections) _\<uint>_] \[-[NoInstall](#NoInstall) _\<SwitchParameter>_] \[-[PublicAddress](#PublicAddress) _\<string>_] \[-[SessionRate](#SessionRate) _\<uint>_] \[-[VRRPAdvertisementInterval](#VRRPAdvertisementInterval) _\<uint>_] \[-[VRRPAuthenticationPassword](#VRRPAuthenticationPassword) _\<SecureString>_] \[-[VRRPBroadcastInterval](#VRRPBroadcastInterval) _\<uint>_] \[-[VRRPHealthScriptCheckInterval](#VRRPHealthScriptCheckInterval) _\<uint>_] \[-[VRRPHealthScriptCheckTimeout](#VRRPHealthScriptCheckTimeout) _\<uint>_] \[-[VRRPVirtualRouterID](#VRRPVirtualRouterID) _\<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**](../classes-and-enumerations/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
```

-**EnableOSUpdates \<bool>**\
Enable/Disable OS updates.

```
        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**](../classes-and-enumerations/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**](../classes-and-enumerations/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**](../classes-and-enumerations/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](../classes-and-enumerations/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](get-rashalb)
* [Set-RASHALB](set-rashalb)
* [Remove-RASHALB](remove-rashalb)
* [Get-RASHALBStatus](get-rashalbstatus)
