Remove-LBRealServer

NAME Remove-LBRealServer



SYNOPSIS

Removes a real server from an exisiting VIP





SYNTAX

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

[[-Credential] <PSCredential>] [<CommonParameters>]





DESCRIPTION

Connects to loadbalancer.org appliance API to remove a real server from 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



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

(get-credential) -VIPName 'MyWebApp' -RIPName 'Web01'













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

Remove-LBRealServer -APIKey $APIKey -ConnectionURI $uri -Credential $cred -VIPName 'MyWebApp' -RIPName 'Web01'











RELATED LINKS