ConfigurationSection.GetAllowLocation Method

Article
05/20/2022

Retrieves the allowLocation attribute for a configuration section.

Syntax

ConfigurationSection.GetAllowLocation AllowLocation

ConfigurationSection.GetAllowLocation(AllowLocation);

Parameters

Name	Definition
`AllowLocation`	A `string` variable that receives the `allowLocation` attribute that the `GetAllowLocation` method returns. The possible attribute values are "true" or "false". The default is "true". Note: This parameter is a `string`, not a `boolean`.

Return Value

This method does not return a value.

Remarks

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

Because GetAllowLocation 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.GetAllowLocation strAnonAuthAllowLocation

The following syntax fails because it tries to call GetAllowLocation 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.GetAllowLocation strAnonAuthAllowLocation

Example

The following example displays 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")  
  
' Get the allowLocation attribute.  
oAnonAuth.GetAllowLocation strAnonAuthAllowLocation  
  
' Display the allowLocation attribute.  
WScript.Echo _  
    "Anonymous Authentication Allow Location: " & _  
        strAnonAuthAllowLocation

Requirements

Type	Description
Client	- IIS 7.0 on Windows Vista - IIS 7.5 on Windows 7 - IIS 8.0 on Windows 8 - IIS 10.0 on Windows 10
Server	- IIS 7.0 on Windows Server 2008 - IIS 7.5 on Windows Server 2008 R2 - IIS 8.0 on Windows Server 2012 - IIS 8.5 on Windows Server 2012 R2 - IIS 10.0 on Windows Server 2016
Product	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF file	WebAdministration.mof

Share via