New-SCLoadBalancerHealthMonitor

Reference

Module:: VirtualMachineManager

Creates a load balancer health monitor object that is used when you create a load balancer virtual IP.

Syntax

New-SCLoadBalancerHealthMonitor
   [-Name <String>]
   -ProtocolName <String>
   [-Request <String>]
   [-Response <String>]
   -IntervalSeconds <Int32>
   -TimeoutSeconds <Int32>
   [-NumberOfRetries <Int32>]
   [<CommonParameters>]

Description

The New-SCLoadBalancerHealthMonitor cmdlet creates a load balancer health monitor object that is used when you create a load balancer virtual IP.

For information about creating a load balancer virtual IP, type Get-Help New-SCLoadBalancerVIP -Detailed.

Examples

Example 1: Create a load balancer health monitor

PS C:\> $LBHealthMonitor = New-SCLoadBalancerHealthMonitor -Name "HTTPMonitor" -ProtocolName "HTTP" -Request "GET /Index.html HTTP/1.1" -Response 200 -IntervalSeconds 15 -TimeoutSeconds 20

This command creates a load balancer health monitor object named HTTPMonitor and stores the object in the $LBHealthMonitor variable.

Parameters

-IntervalSeconds

Specifies the amount of time, in seconds, that a health monitor waits between sending recurring requests to a load balancer to verify that the load balancer is available. The interval value should be larger than the timeout value.

Type:	Int32
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Specifies the name of a Virtual Machine Manager (VMM) object.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NumberOfRetries

Specifies the number of times that a load balancer health monitor retries sending a request before marking the VIP member as down.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ProtocolName

Specifies the protocol used to communicate with a load balancer.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Request

Specifies the request that a health monitor sends to a load balancer. Typically, this command makes an HTTP GET request for the home page of the load balancer and checks for a header response such as 200 OK.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Response

Specifies the expected response to a request that a health monitor sends to a load balancer.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeoutSeconds

Specifies the amount of time, in seconds, that a process waits before timing out.

Type:	Int32
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

Outputs

LoadBalancerHealthMonitor

This cmdlet returns a LoadBalancerHealthMonitor object.

Share via