Compartilhar via


Método ConfigurationSection.GetAllowLocation

Recupera o atributo allowLocation para uma seção de configuração.

Sintaxe

ConfigurationSection.GetAllowLocation AllowLocation  
ConfigurationSection.GetAllowLocation(AllowLocation);  

Parâmetros

Nome Definição
AllowLocation Uma variável string que recebe o atributo allowLocation que o método GetAllowLocation retorna. Os valores possíveis são "true" ou "false". O padrão é "true". Anotação: esse parâmetro é uma string, não um boolean.

Valor de retorno

Esse método não retorna um valor.

Comentários

O atributo allowLocation especifica se uma seção de configuração pode aparecer dentro de um par de tags de localização.

Como GetAllowLocation é um método estático, será necessário chamá-lo obtendo um objeto de classe, conforme o exemplo a seguir.

' Correct syntax:  
Set oAnonAuth = oWebAdmin.Get("AnonymousAuthenticationSection")  
oAnonAuth.GetAllowLocation strAnonAuthAllowLocation  

A sintaxe a seguir falha porque tenta chamar GetAllowLocation em uma instância concreta da classe Site. A chamada para o método causará um erro "SWbemObjectEx: não encontrado".

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

Exemplo

O exemplo a seguir exibe o atributo allowLocation para a seção Configuração de autenticação anônima.

' 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  
  

Requisitos

Tipo Descrição
Cliente – IIS 7.0 no Windows Vista
– IIS 7.5 no Windows 7
– IIS 8.0 no Windows 8
– IIS 10.0 no Windows 10
Servidor – IIS 7.0 no Windows Server 2008
– IIS 7.5 no Windows Server 2008 R2
– IIS 8.0 no Windows Server 2012
– IIS 8.5 no Windows Server 2012 R2
– IIS 10.0 no Windows Server 2016
Product – IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Arquivo MOF WebAdministration.mof

Confira também

Classe AnonymousAuthenticationSection
Classe ConfigurationSection
Método ConfigurationSection.GetAllowDefinition