Sets how a website or part of a website should handle and use SSL.
Set-IisSslFlags [-SiteName] <String> [[-Path] <String>] [-RequireSsl] [-AcceptClientCertificates] [-RequireClientCertificates] [-Enable128BitSsl] [-WhatIf] [-Confirm] [<CommonParameters>]
This function allows you to configure the following SSL-related settings:
RequireSsl
switch)AccepClientCertificates
and RequireClientCertificates
switches).Enable128BitSsl
switch).By default, this function will make SSL optional, set the ignore client certificates flag, and not require 128-bit SSL.
Changing any SSL settings will do you no good if the website doesn't have an SSL binding or doesn't have an SSL certificate. The configuration will most likely succeed, but won't work in a browser. So sad.
Name | Type | Description | Required? | Pipeline Input | Default Value |
---|---|---|---|---|---|
SiteName | String | The website whose SSL flags should be modifed. | true | false | |
Path | String | The path to the folder/virtual directory/application under the website whose SSL flags should be set. | false | false | |
RequireSsl | SwitchParameter | Should SSL be required? | false | false | |
AcceptClientCertificates | SwitchParameter | Should client certificates be accepted? | false | false | |
RequireClientCertificates | SwitchParameter | Should client certificates be required? | false | false | |
Enable128BitSsl | SwitchParameter | Requires 128-bit SSL. | false | false | |
WhatIf | SwitchParameter | false | false | ||
Confirm | SwitchParameter | false | false | ||
CommonParameters | This cmdlet supports common parameters. For more information type Get-Help about_CommonParameters . |
Set-IisSslFlags -Site Peanuts
Resets the Peanuts
website's SSL flags to defaults, i.e. makes SSL optional, ignores client certificates, and makes 128-bit SSL optional.
Set-IisSslFlags -Site Peanuts -Path Snoopy/DogHouse -RequireSsl
Configures the /Snoopy/DogHouse
directory in the Peanuts
site to require SSL. It also turns off any client certificate settings and makes 128-bit SSL optional.
Set-IisFlags -Site Peanuts -AcceptClientCertificates
Configures the Peanuts
website to accept client certificates, makes SSL optional, and makes 128-bit SSL optional.
Set-IisFlags -Site Peanuts -Enable128BitSsl
Configures the Peanuts
website to require 128-bit SSL, makes SSL optional, and ignores client certificates.