New-SCLoadBalancerProtocol

New-SCLoadBalancerProtocol

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

Syntax

Parameter Set: Base
New-SCLoadBalancerProtocol -Name <String> [ <CommonParameters>]

Parameter Set: HTTPS
New-SCLoadBalancerProtocol -Name <String> [-HTTPSCertificateSubjectName <String> ] [-HTTPSReencryptConnection <Boolean> ] [-TerminateHTTPS <Boolean> ] [ <CommonParameters>]

Detailed 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.

Parameters

-HTTPSCertificateSubjectName<String>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-HTTPSReencryptConnection<Boolean>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Name<String>

Specifies the name of a VMM object.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-TerminateHTTPS<Boolean>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

  • LoadBalancerProtocol

Examples

Example 1: Create an HTTPS load balancer protocol object

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.

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

New-SCLoadBalancerVIP