New-SCLoadBalancerHealthMonitor
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 20This 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.