New-SCLoadBalancerProtocol

Module:

VirtualMachineManager Module

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

Syntax

Base (Default)

New-SCLoadBalancerProtocol
    -Name <String>
    [<CommonParameters>]

HTTPS

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.

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

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

HTTPS

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-HTTPSReencryptConnection

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

Parameter properties

Type:	Boolean
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

HTTPS

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-Name

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

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-TerminateHTTPS

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

Parameter properties

Type:	Boolean
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

HTTPS

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Outputs

LoadBalancerProtocol

This cmdlet returns a LoadBalancerProtocol object.