New-LBLayer4VIP

NAME New-LBLayer4VIP



SYNOPSIS

Adds a real server to an exisiting VIP





SYNTAX

New-LBLayer4VIP [-APIKey] <String> [-ConnectionURI] <String> [-VIPName] <Object> [-VIPAddress] <Object> [-Port]

<Object> [-ForwardingMethod] <Object> [-Protocol] <Object> [[-Credential] <PSCredential>] [<CommonParameters>]





DESCRIPTION

Connects to loadbalancer.org appliance API to add a real server to an exisiting VIP





PARAMETERS

-APIKey <String>

API Key



Required? true

Position? 1

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-ConnectionURI <String>

Connection URI e.g. https://10.0.0.10:9443/api/



Required? true

Position? 2

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-VIPName <Object>

Name of virtual IP (e.g. 'MyWebApp')



Required? true

Position? 3

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-VIPAddress <Object>

Address of Virtual IP (e.g. '10.0.0.20')



Required? true

Position? 4

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-Port <Object>

VIP Port Number (e.g. '80')



Required? true

Position? 6

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-ForwardingMethod <Object>

Forwarding Method ('gate', 'masq', 'ipip')



Required? true

Position? 7

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-Protocol <Object>

Protocol ('tcp', 'udp')



Required? true

Position? 7

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-Credential <PSCredential>

PSCredential object containing the API username and password, prompts if omitted



Required? false

Position? 6

Default value (Get-Credential)

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 (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS

System.Int32





-------------------------- EXAMPLE 1 --------------------------



PS C:\\>New-LBLayer4VIP -APIKey 'abc123' -ConnectionURI 'https://lbmaster.domain.local:9443/api/' -Credential

(get-credential) -VIPName 'MyWebApp' -VIPAddress '10.0.0.20' -Port '80' -ForwardingMethod 'gate' -Protocol 'tcp'













-------------------------- EXAMPLE 2 --------------------------



PS C:\\>$ApiKey = 'abc123'



$uri = 'https://lbmaster.domain.local:9443/api/'

$cred = New-Object System.Management.Automation.PSCredential -ArgumentList 'loadbalancer', (ConvertTo-SecureString

-AsPlainText 'loadbalancer' -Force)

New-LBLayer4VIP -APIKey $APIKey -ConnectionURI $uri -Credential $cred -VIPName 'MyWebApp' -VIPAddress '10.0.0.20'

-Port '80' -ForwardingMethod 'gate' -Protocol 'tcp'











RELATED LINKS