Set-IisSslFlags

Sets how a website or part of a website should handle and use SSL.

Syntax

Set-IisSslFlags [-SiteName] <String> [[-Path] <String>] [-RequireSsl] [-AcceptClientCertificates] [-RequireClientCertificates] [-Enable128BitSsl] [-WhatIf] [-Confirm] [<CommonParameters>]

Description

This function allows you to configure the following SSL-related settings:

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.

Related Commands

Parameters

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.

EXAMPLE 1

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.

EXAMPLE 2

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.

EXAMPLE 3

Set-IisFlags -Site Peanuts -AcceptClientCertificates

Configures the Peanuts website to accept client certificates, makes SSL optional, and makes 128-bit SSL optional.

EXAMPLE 4

Set-IisFlags -Site Peanuts -Enable128BitSsl

Configures the Peanuts website to require 128-bit SSL, makes SSL optional, and ignores client certificates.