New-SCLoadBalancerHealthMonitor

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

Syntax

New-SCLoadBalancerHealthMonitor -IntervalSeconds <Int32> [-Name <String>] [-NumberOfRetries <Int32>]
 -ProtocolName <String> [-Request <String>] [-Response <String>] -TimeoutSeconds <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
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

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

Type:String
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ProtocolName

Specifies the protocol used to communicate with a load balancer.

Type:String
Required:True
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Outputs

LoadBalancerHealthMonitor

This cmdlet returns a **LoadBalancerHealthMonitor** object.