Get-IisSecurityAuthentication

Gets a site's (and optional sub-directory's) security authentication configuration section.

Syntax

Get-IisSecurityAuthentication -SiteName <String> [-VirtualPath <String>] -Anonymous [<CommonParameters>]
Get-IisSecurityAuthentication -SiteName <String> [-VirtualPath <String>] -Basic [<CommonParameters>]
Get-IisSecurityAuthentication -SiteName <String> [-VirtualPath <String>] -Digest [<CommonParameters>]
Get-IisSecurityAuthentication -SiteName <String> [-VirtualPath <String>] -Windows [<CommonParameters>]

Description

You can get the anonymous, basic, digest, and Windows authentication sections by using the Anonymous, Basic, Digest, or Windows switches, respectively.

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

Parameters

Name Type Description Required? Pipeline Input Default Value
SiteName String

The site where anonymous authentication should be set.

true false
VirtualPath String

The optional path where anonymous authentication should be set.

false false
Anonymous SwitchParameter

Gets a site's (and optional sub-directory's) anonymous authentication configuration section.

true false False
Basic SwitchParameter

Gets a site's (and optional sub-directory's) basic authentication configuration section.

true false False
Digest SwitchParameter

Gets a site's (and optional sub-directory's) digest authentication configuration section.

true false False
Windows SwitchParameter

Gets a site's (and optional sub-directory's) Windows authentication configuration section.

true false False

Return Values

Microsoft.Web.Administration.ConfigurationSection.

EXAMPLE 1

Get-IisSecurityAuthentication -SiteName Peanuts -Anonymous

Gets the Peanuts site's anonymous authentication configuration section.

EXAMPLE 2

Get-IisSecurityAuthentication -SiteName Peanuts -VirtualPath Doghouse -Basic

Gets the Peanuts site's Doghouse sub-directory's basic authentication configuration section.