VirtualDirectoryElementDefaults Class1

Expõe o conjunto de configurações padrão para diretórios virtuais dos IIS.

Sintaxe

class VirtualDirectoryElementDefaults : EmbeddedObject  

Métodos

Essa classe não contém métodos.

Propriedades

A tabela a seguir lista as propriedades expostas pela classe VirtualDirectoryElementDefaults.

Nome	Descrição
AllowSubDirConfig	Um valor boolean de leitura/gravação. true se, por padrão, o IIS procura arquivos Web.config em diretórios de conteúdo inferiores ao nível atual; false se o IIS não procura arquivos web.config em diretórios de conteúdo inferiores ao nível atual.
LogonMethod	Uma enumeração sint32 de leitura/gravação que especifica o método padrão pelo qual um usuário está conectado localmente. O tipo de logon determinará se o token resultante também pode ser usado remotamente. Os valores possíveis estão listados posteriormente na seção Comentários.
Password	Um valor string de leitura/gravação que especifica a senha criptografada padrão para acesso ao diretório raiz virtual. O padrão é null.
Path	Um valor string de leitura/gravação que contém o caminho do diretório virtual padrão.
PhysicalPath	Um valor string de leitura/gravação que especifica o caminho físico padrão associado ao diretório virtual.
UserName	Um valor string de leitura/gravação que especifica um usuário padrão que tem direitos para acessar qualquer arquivo de configuração ou conteúdo em um diretório virtual. O padrão é null.

Subclasses

Essa classe não contém subclasses.

Comentários

As instâncias dessa classe estão contidas na propriedade VirtualDirectoryDefaults das classes Server, Site e Application.

A tabela a seguir contém os possíveis valores e palavras-chave da propriedade LogonMethod. O padrão é 3 (ClearText). Para obter mais informações, confira a função LogonUserEx.

Valor	Palavra-chave	Descrição
0	Interativo	Permite que o usuário faça logon interativamente por meio de um servidor de terminal, shell remoto ou processo semelhante. Como esse tipo de logon armazena em cache as informações de logon para operações desconectadas, o desempenho pode ser afetado. Esse tipo de logon é, portanto, inadequado para aplicativos cliente/servidor, como servidores de email.
1	Lote	Permite que o usuário faça logon por meio de um servidor em lote, onde os processos podem ser executados para o usuário sem a intervenção do usuário. Esse tipo de logon é apropriado para servidores, como servidores de email ou Web, que processam muitas tentativas de autenticação de texto sem formatação ao mesmo tempo. As credenciais não são armazenadas em cache para esse tipo de logon.
2	Rede	Permite que o usuário faça logon por meio de um servidor de alto desempenho que autentica senhas de texto sem formatação. As credenciais não são armazenadas em cache para esse tipo de logon.
3	ClearText	Permite que o usuário faça logon usando a autenticação Básica. O nome do usuário e a senha são mantidos em um pacote de autenticação, o que permite que o servidor faça conexões com outros servidores de rede enquanto representa o cliente. Um pacote de autenticação é um DLL que encapsulas a lógica de autenticação que determina se o usuário deve ter permissão para fazer logon. A LSA (Autoridade de Segurança Local) autentica um logon de usuário enviando a solicitação para um pacote de autenticação. Em seguida, o pacote de autenticação examina as informações de logon e autentica ou rejeita a tentativa de logon do usuário.

Exemplo

O exemplo a seguir mostra como definir o nome de usuário e a senha para todos os diretórios virtuais em um site. Em seguida, ele mostra como recuperar todos os padrões de diretório virtual do site.

' 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'")  
  
' Set the virtual directory defaults on the Web site.  
oSite.VirtualDirectoryDefaults.UserName = "JohnV"  
oSite.VirtualDirectoryDefaults.Password = "p@ssw0rd."  
oSite.Put_  
  
' List all the virtual directory defaults for the Web site.  
WScript.Echo "AllowSubDirConfig: " & _  
    oSite.VirtualDirectoryDefaults.AllowSubDirConfig  
WScript.Echo "LogonMethod: " & _  
    GetLogonMethodText(oSite.VirtualDirectoryDefaults.LogonMethod)  
WScript.Echo "Password: " & oSite.VirtualDirectoryDefaults.Password  
WScript.Echo "Path: " & oSite.VirtualDirectoryDefaults.Path  
WScript.Echo "PhysicalPath: " & _  
    oSite.VirtualDirectoryDefaults.PhysicalPath  
WScript.Echo "UserName: " & oSite.VirtualDirectoryDefaults.UserName  
  
' This helper function converts the LogonMethod value to text.  
Function GetLogonMethodText(LogonMethodValue)  
    Select Case LogonMethodValue  
        Case 0  
            GetLogonMethodText = "Interactive"  
        Case 1  
            GetLogonMethodText = "Batch"  
        Case 2  
            GetLogonMethodText = "Network"  
        Case 3  
            GetLogonMethodText = "ClearText"  
        Case Else  
            GetLogonMethodText = "Unknown logon method."  
    End Select  
End Function  
  

Hierarquia de herança

EmbeddedObject

VirtualDirectoryElementDefaults

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 Application
Classe EmbeddedObject
Classe Server
Classe Site
Classe VirtualDirectory
LogonUserEx