New-RASHALB.md

NAME

New-RASHALB

SYNOPSIS

Creates a new instance of the HALB Virtual server settings.

SYNTAX

New-RASHALB [Name] (string) [[-SiteId] (uint)] [[-LBGateways] (List1)*] [[-[LBGatewayPort](#lbgatewayport-string)] *(uint)*] [[-[EnableSSLPayload](#enablesslpayload-string)] *(SwitchParameter)*] [[-[SSLMode](#SSLMode)] {SSLOffloading | SSLPassthrough}] [[-[LBSSLGateways](#LBSSLGateways)] *(List1)] [[-LBSSLGatewayPort] (uint)] [[-AcceptedSSLVersion] {TLSv1 | TLSv1_1 | TLSv1_2 | TLSv1_3}] [[-CipherStrength] {Low | Medium | High | Custom}] [[-SSLCustomCipher] (string)] [[-CertificateID] (uint)] [[-Description] (string)] [[-EnableDeviceManagement] (SwitchParameter)] [[-DeviceManagerGateways] (List1)*] [-[IPVersion](#IPVersion)] {Version4 | Version6 | BothVersions} [[-[VirtualIPv4](#virtualipv4-string)] *(string)*] [[-[SubnetMask](#subnetmask-string)] *(string)*] [[-[VirtualIPv6](#virtualipv6-string)] *(string)*] [[-[PrefixIPV6](#prefixipv6-string)] *(uint)*] [[-[DeviceIPs](#DeviceIPs)] *(List1)] [[-EnableGatewayPayload] (SwitchParameter)] [CipherPreference (bool)] [ClientIdleTimeout (uint)] [ClientQueueTimeout (uint)] [EnableOSUpdates (bool)] [EnableTunneling (bool)] [GatewayConnectionTimeout (uint)] [GatewayHealthCheckIntervals (uint)] [GatewayIdleTimeout (uint)] [KeepLBProxyConfig (bool)] [KeepVRRPConfig (bool)] [MaxTCPConnections (uint)] [NoInstall (SwitchParameter)] [PublicAddress (string)] [SessionRate (uint)] [VRRPAdvertisementInterval (uint)] [VRRPAuthenticationPassword (SecureString)] [VRRPBroadcastInterval (uint)] [VRRPHealthScriptCheckInterval (uint)] [VRRPHealthScriptCheckTimeout (uint)] [VRRPVirtualRouterID (uint)] [(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)

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) 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) 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)

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

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

• Set-RASHALB

• Remove-RASHALB

• Get-RASHALBStatus