Set-IisWindowsAuthentication

Configures the settings for Windows authentication.

Syntax

Set-IisWindowsAuthentication [-SiteName] <String> [[-VirtualPath] <String>] [-DisableKernelMode] [-WhatIf] [-Confirm] [<CommonParameters>]

Description

By default, configures Windows authentication on a website. You can configure Windows authentication at a specific path under a website by passing the virtual path (not the physical path) to that directory.

The changes only take effect if Windows authentication is enabled (see Enable-IisSecurityAuthentication).

Beginning with Carbon 2.0.1, this function is available only if IIS is installed.

Related Commands

Parameters

Name Type Description Required? Pipeline Input Default Value
SiteName String

The site where Windows authentication should be set.

true false
VirtualPath String

The optional path where Windows authentication should be set.

false false
DisableKernelMode SwitchParameter

Turn on kernel mode. Default is false. More information about Kerndel Mode authentication.

false 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-IisWindowsAuthentication -SiteName Peanuts

Configures Windows authentication on the Peanuts site to use kernel mode.

EXAMPLE 2

Set-IisWindowsAuthentication -SiteName Peanuts -VirtualPath Snoopy/DogHouse -DisableKernelMode

Configures Windows authentication on the Doghouse directory of the Peanuts site to not use kernel mode.