New-LBRealServer

NAME New-LBRealServer



SYNOPSIS

Adds a real server to an exisiting VIP





SYNTAX

New-LBRealServer [-APIKey] <String> [-ConnectionURI] <String> [-VIPName] <Object> [-RIPName] <Object>

[-RIPAddress] <Object> [-Port] <Object> [-Weight] <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



-RIPName <Object>

Name of Real Server (e.g. 'Web01')



Required? true

Position? 4

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-RIPAddress <Object>

Real Sever IP Address (e.g. '10.0.0.11')



Required? true

Position? 5

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-Port <Object>

Real Server Port Number (e.g. '80')



Required? true

Position? 6

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-Weight <Object>

Weight of real server (e.g. '100')



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-LBRealServer -APIKey 'abc123' -ConnectionURI 'https://lbmaster.domain.local:9443/api/' -Credential

(get-credential) -VIPName 'MyWebApp' -RIPName 'Web01' -RIPAddress '10.0.0.11' -Port '80' -Weight '100'













-------------------------- 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-LBRealServer -APIKey $APIKey -ConnectionURI $uri -Credential $cred -VIPName 'MyWebApp' -RIPName 'Web01'

-RIPAddress '10.0.0.11' -Port '80' -Weight '100'











RELATED LINKS