Export (0) Print
Expand All
Expand Minimize

ConfigurationSection.SetAllowLocation Method [IIS 7 and higher]

IIS 7.0

Sets the allowLocation attribute for a configuration section.

ConfigurationSection.SetAllowLocation(AllowLocation)
ConfigurationSection.SetAllowLocation(AllowLocation);

Name

Definition

AllowLocation

A case-sensitive string variable that sets the allowLocation attribute for the configuration section. The possible attribute values are "true" or "false". The default is "true".

NoteNote:
This parameter is a string, not a boolean.

This method does not return a value.

The allowLocation attribute specifies whether a configuration section can appear inside a pair of location tags.

Because SetAllowLocation is a static method, you should call it by getting a class object, as in the following example.

' Correct syntax:
Set oAnonAuth = oWebAdmin.Get("AnonymousAuthenticationSection")
oAnonAuth.SetAllowLocation "false"

The following syntax fails because it tries to call SetAllowLocation on a concrete instance of the Site class. The call to the method will cause an "SWbemObjectEx: Not found" error.


' Incorrect syntax:
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")
oSite.GetSection "AnonymousAuthenticationSection", oAnonAuth
oAnonAuth.SetAllowLocation "false"

The following example sets the allowLocation attribute for the Anonymous authentication configuration section.

' Get the WebAdministration namespace.
Set oWebAdmin = GetObject( _
    "winmgmts:root\WebAdministration")

' Get the AnonymousAuthenticationSection.
Set oAnonAuth = oWebAdmin.Get( _
    "AnonymousAuthenticationSection")

' Set the allowLocation attribute.
oAnonAuth.GetAllowLocation "false"

Type

Description

Client

Requires IIS 7 on Windows Vista.

Server

Requires IIS 7 on Windows Server 2008.

Product

IIS 7

MOF file

WebAdministration.mof

Community Additions

ADD
Show:
© 2014 Microsoft