New-SCLoadBalancerProtocol

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

Syntax

New-SCLoadBalancerProtocol
   -Name <String>
   [<CommonParameters>]
New-SCLoadBalancerProtocol
   -Name <String>
   [-HTTPSCertificateSubjectName <String>]
   [-HTTPSReencryptConnection <Boolean>]
   [-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.

Required Parameters

-Name

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

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

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

Outputs

LoadBalancerProtocol

This cmdlet returns a LoadBalancerProtocol object.