Configures the settings for Windows authentication.
Set-IisWindowsAuthentication [-SiteName] <String> [[-VirtualPath] <String>] [-DisableKernelMode] [-WhatIf] [-Confirm] [<CommonParameters>]
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.
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 . |
Set-IisWindowsAuthentication -SiteName Peanuts
Configures Windows authentication on the Peanuts
site to use kernel mode.
Set-IisWindowsAuthentication -SiteName Peanuts -VirtualPath Snoopy/DogHouse -DisableKernelMode
Configures Windows authentication on the Doghouse
directory of the Peanuts
site to not use kernel mode.