Set-WebSitesSslConfig

Updates SSL the configuration.

Syntax

Parameter Set: Default
Set-WebSitesSslConfig [-HostName] <String> -OwnerName <String> [-Bindings <String[]> ] [-ConnectionString <String> ] [-IpBasedSslMode {Ipv4 | Ipv6 | Ipv4AndIpv6} ] [-IpBasedState {NotConfigured | InProgress | Configured | ConfigurationReverted} ] [-PipelineVariable <String> ] [-SslMode {None | Sni | IpBased} ] [-Thumbprint <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

 

Detailed Description

The Set-WebSitesSslConfig cmdlet updates the Secure Sockets Layer (SSL) configuration.

Parameters

-Bindings<String[]>

Specifies an array of host name bindings.

 

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

 

-ConnectionString<String>

Specifies a connecting string to a hosting database. If this parameter is not specified, the default instance of the hosting database is used.

 

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

 

-HostName<String>

Specifies a host name.

 

Aliases	none
Required?	true
Position?	1
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

 

-IpBasedSslMode<IpBasedSslMode>

Specifies the IP-based SSL mode. Valid values are:

-- Ipv4

-- Ipv6

-- Ipv4AndIpv6

The acceptable values for this parameter are:

 

Ipv4
Ipv6
Ipv4AndIpv6

 

 

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

 

-IpBasedState<HostNameIpBasedSslState>

Specifies the host name IP-based SSL state. Valid values are:

-- NotConfigured

-- InProgress

-- Configured

-- ConfigurationReverted

The acceptable values for this parameter are:

 

NotConfigured
InProgress
Configured
ConfigurationReverted

 

 

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

 

-OwnerName<String>

Specifies the name of the certificate owner.

 

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

 

-PipelineVariable<String>

Specifies a variable to be used with the pipeline operator.

 

Aliases	pv
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

 

-SslMode<SslMode>

Specifies the SSL mode. Valid values are:

-- None

-- Sni

-- IpBased

The acceptable values for this parameter are:

 

None
Sni
IpBased

 

 

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

 

-Thumbprint<String>

Specifies the thumbprint of the certificate to associate with the binding.

 

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

 

-Confirm

Prompts you for confirmation before executing the command.

 

Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

 

-WhatIf

Describes what would happen if you executed the command without actually executing the command.

 

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.

Examples

Example 1: Update an SSL configuration

This command updates the SSL configuration with the host name HostName.Contoso.com and owner name Subscription01+DefaultWebSpace.

PS C:\> Set-WebSitesSslConfig -HostName "HostName.Contoso.com" -OwnerName "Subscription01+DefaultWebSpace" -IpBasedMode Ipv6 -SslMode IpBased