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.