Compartilhar via

Método ConfiguredObject.GetSection

  • Artigo

Recupera o conteúdo de uma seção de configuração de um objeto configurado.

Sintaxe

ConfiguredObject.GetSection(SectionName, Section);  

ConfiguredObject.GetSection SectionName, Section

Parâmetros

Nome Descrição
SectionName Uma variável string que contém o nome da seção de configuração a ser recuperada (por exemplo, "BasicAuthenticationSection").
Section Uma variável ConfigurationSection na qual o conteúdo da seção de configuração é colocado.

Valor de retorno

Esse método não retorna um valor.

Comentários

Você pode usar o método GetSection para recuperar o conteúdo de uma seção de configuração desejada e definir as propriedades configuráveis.

Observação

A assinatura do método GetSection contém um parâmetro [IN] para o nome da seção e um parâmetro [OUT] para o objeto de seção que o método retorna.

Exemplo

O exemplo a seguir obtém a seção de erros HTTP para o site padrão e exibe as propriedades de matriz e não matriz.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
' Get the default Web site.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
  
' Get the HTTP errors section by using the GetSection method.  
oSite.GetSection "HttpErrorsSection", oSection  
  
' Display a heading.  
WScript.Echo "=============================="  
WScript.Echo "Http Errors Section Properties"  
WScript.Echo "=============================="  
  
' Display the HttpErrorsSection non-array properties.  
For Each vProp In oSection.Properties_  
    If (vProp.Name <> "HttpErrors") And _  
        (vProp.Name <> "SectionInformation") Then  
        WScript.Echo vProp.Name & ": " & vProp.Value  
    End If  
Next  
WScript.Echo   
  
' Display the HttpErrorsSection SectionInformation properties.  
WScript.Echo "HttpErrorsSection.SectionInformation"  
WScript.Echo "------------------------------------"  
For Each vProp In oSection.SectionInformation.Properties_  
    WScript.Echo vProp.Name & ": " & vProp.Value  
Next  
WScript.Echo  
  
' Display the contents of the HttpErrors array property.  
WScript.Echo "HttpErrorsSection.HttpErrors"  
WScript.Echo "----------------------------"  
For Each oHttpErrorElement In oSection.HttpErrors  
    For Each vProp In oHttpErrorElement.Properties_  
        WScript.Echo vProp.Name & ": " & vProp.Value  
    Next  
    WScript.Echo  
Next

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 ConfigurationSection
Classe ConfiguredObject
Classe HttpErrorElement
Classe HttpErrorsSection