Condividi tramite


Classe VirtualDirectoryElementDefaults1

Espone le impostazioni di configurazione predefinite per le directory virtuali IIS.

Sintassi

class VirtualDirectoryElementDefaults : EmbeddedObject  

Metodi

Questa classe non contiene metodi.

Proprietà

Nella tabella seguente sono elencate le proprietà esposte dalla VirtualDirectoryElementDefaults classe .

Nome Descrizione
AllowSubDirConfig Valore di lettura/scrittura boolean . true se per impostazione predefinita IIS cerca file Web.config nelle directory di contenuto inferiori al livello corrente; false se IIS non cerca questi file nelle directory inferiori al livello corrente.
LogonMethod Enumerazione di lettura/scrittura sint32 che specifica il metodo predefinito in base al quale un utente è connesso in locale. Il tipo di accesso determina se il token risultante può essere usato anche in remoto. I valori possibili sono elencati più avanti nella sezione Osservazioni.
Password Valore di lettura/scrittura string che specifica la password crittografata predefinita per l'accesso alla directory radice virtuale. Il valore predefinito è null.
Path Valore di lettura/scrittura string contenente il percorso predefinito della directory virtuale.
PhysicalPath Valore di lettura/scrittura string che specifica il percorso fisico predefinito associato alla directory virtuale.
UserName Valore di lettura/scrittura string che specifica un utente predefinito che dispone dei diritti per accedere a qualsiasi file di configurazione o contenuto in una directory virtuale. Il valore predefinito è null.

Sottoclassi

Questa classe non contiene sottoclassi.

Commenti

Le istanze di questa classe sono contenute nella VirtualDirectoryDefaults proprietà delle classi Server, Site e Application .

La tabella seguente contiene i valori e le parole chiave possibili per la LogonMethod proprietà. Il valore predefinito è 3 (ClearText). Per altre informazioni, vedere la funzione LogonUserEx .

Valore Parola chiave Descrizione
0 Interattività Consente all'utente di accedere in modo interattivo tramite un server terminale, una shell remota o un processo simile. Poiché questo tipo di accesso memorizza nella cache le informazioni di accesso per le operazioni disconnesse, le prestazioni potrebbero essere interessate. Questo tipo di accesso è quindi inappropriato per le applicazioni client/server, ad esempio i server di posta elettronica.
1 Batch Consente all'utente di accedere tramite un server batch, in cui i processi possono essere eseguiti per l'utente senza l'intervento dell'utente. Questo tipo di accesso è appropriato per i server, ad esempio posta elettronica o server Web, che elaborano molti tentativi di autenticazione di testo non crittografato alla volta. Le credenziali non vengono memorizzate nella cache per questo tipo di accesso.
2 Rete Consente all'utente di accedere tramite un server ad alte prestazioni che autentica le password di testo non crittografato. Le credenziali non vengono memorizzate nella cache per questo tipo di accesso.
3 ClearText Consente all'utente di accedere usando l'autenticazione di base. Il nome e la password dell'utente vengono conservati in un pacchetto di autenticazione, che consente al server di effettuare connessioni ad altri server di rete durante la rappresentazione del client.

Un pacchetto di autenticazione è una DLL che incapsula la logica di autenticazione che determina se consentire a un utente di accedere. Autorità di sicurezza locale (LSA) autentica un accesso utente inviando la richiesta a un pacchetto di autenticazione. Il pacchetto di autenticazione esamina quindi le informazioni di accesso ed esegue l'autenticazione o rifiuta il tentativo di accesso dell'utente.

Esempio

Nell'esempio seguente viene illustrato come impostare il nome utente e la password per tutte le directory virtuali in un sito Web. Viene quindi illustrato come recuperare tutte le impostazioni predefinite della directory virtuale per il sito.

' 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  
  

Gerarchia di ereditarietà

EmbeddedObject

VirtualDirectoryElementDefaults

Requisiti

Tipo Descrizione
Client - IIS 7.0 in Windows Vista
- IIS 7.5 in Windows 7
- IIS 8.0 in Windows 8
- IIS 10.0 in Windows 10
Server - IIS 7.0 in Windows Server 2008
- IIS 7.5 in Windows Server 2008 R2
- IIS 8.0 in Windows Server 2012
- IIS 8.5 in Windows Server 2012 R2
- IIS 10.0 in Windows Server 2016
Prodotto - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
File MOF WebAdministration.mof

Vedere anche

Classe application
Classe EmbeddedObject
Classe server
Classe del sito
Classe VirtualDirectory
LogonUserEx