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