New-SCLoadBalancerProtocol

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

Syntax

New-SCLoadBalancerProtocol [-HTTPSCertificateSubjectName <String>] [-HTTPSReencryptConnection <Boolean>]
 -Name <String> [-TerminateHTTPS <Boolean>] [<CommonParameters>]

Description

The New-SCLoadBalancerProtocol cmdlet creates a load balancer protocol 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 an HTTPS load balancer protocol object

PS C:\> $LBProtocol = New-SCLoadBalancerProtocol -Name "HTTPS" -HTTPSCertificate "C=US,ST=WA,L=Redmond,O=Contoso,OU=Test,CN=www.contoso.com/emailAddress=contoso@contoso.com" -HTTPSReencryptconnection $True -TerminateHTTPS $True

This command creates a load balancer protocol object specifying that HTTPS terminates at the load balancer and that the load balancer re-encrypts the connection to the server. The command then stores the object in the $LPProtocol variable.

Parameters

-HTTPSCertificateSubjectName

Specifies the subject name property of the certificate used to terminate the HTTPS connection at the load balancer.



Example format: C=US,ST=WA,L=Redmond,O=Contoso,OU=Test,CN=www.contoso.com/emailAddress=contoso@contoso.com

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

Indicates whether a load balancer should re-encrypt traffic to the server after it has terminated an HTTPS connection.

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

Indicates whether HTTPS traffic is terminated at the load balancer. If set to $True, you must provide a certificate subject name.

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

Outputs

LoadBalancerProtocol

This cmdlet returns a **LoadBalancerProtocol** object.