Export (0) Print
Expand All
Expand Minimize

ConfigurationSection.SetAllowDefinition Method [IIS 7 and higher]

IIS 7.0

Sets the allowDefinition attribute for a configuration section.

ConfigurationSection.SetAllowDefinition(AllowDefinition)
ConfigurationSection.SetAllowDefinition(AllowDefinition);

Name

Definition

AllowDefinition

A string variable that specifies the value to which the allowDefinition attribute will be set. The possible attribute values are listed later in the Remarks section.

This method does not return a value.

allowDefinition attributes specify where in the configuration hierarchy values may be set for a given configuration section. These attributes are specified in the <configSections> section of the ApplicationHost.config file.

Because SetAllowDefinition 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.SetAllowDefinition "MachineOnly"

The following syntax fails because it tries to call SetAllowDefinition 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.SetAllowDefinition "MachineOnly"

The following table lists the possible values for the allowDefinition attribute.

Keyword

Description

Everywhere

The section can be set anywhere in the hierarchy.

MachineOnly

The section can be set only in the Machine.config file.

NoteNote:
The default location for the Machine.config file is %systemroot% Microsoft.NET\Framework\<version>\config\.

MachineToWebRoot

The section can be set only in the Machine.config file or the root Web.config file.

NoteNote:
The default location for the root Web.config file is %systemroot% Microsoft.NET\Framework\<version>\config\.

AppHostOnly

The section can be set only in the ApplicationHost.config file.

MachineToApplication

The section can be set only at the global level. For .NET Framework sections, the global level is the root Web.config or Machine.config file; for IIS sections, it is the ApplicationHost.config file; and for applications, it is the Web.config file for the root application.

The following example sets the allowDefinition 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 AllowDefinition attribute.
oAnonAuth.SetAllowDefinition "MachineToApplication"

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