VirtualDirectoryElementDefaults Klasse 1

Artikel
03/25/2024

Macht Standardkonfigurationseinstellungen für virtuelle IIS-Verzeichnisse verfügbar.

Syntax

class VirtualDirectoryElementDefaults : EmbeddedObject

Methoden

Diese Klasse enthält keine Methoden.

Eigenschaften

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die von der VirtualDirectoryElementDefaults-Klasse verfügbar gemacht werden.

Name	Beschreibung
`AllowSubDirConfig`	Ein `boolean` Lese-/Schreibwert. `true` wenn IIS standardmäßig nach Web.config-Dateien in Inhaltsverzeichnissen unter der aktuellen Ebene sucht; `false` wenn IIS diese Dateien nicht in Verzeichnissen unter der aktuellen Ebene sucht.
`LogonMethod`	Eine `sint32` Lese-/Schreibenumeration, die die Standardmethode angibt, mit der ein Benutzer lokal angemeldet ist. Der Anmeldetyp bestimmt, ob das resultierende Token auch remote verwendet werden kann. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.
`Password`	Ein `string` Wert mit Lese-/Schreibzugriff, der das standardverschlüsselte Kennwort für den Zugriff auf das virtuelle Stammverzeichnis angibt. Der Standardwert ist `null`.
`Path`	Ein `string` Wert mit Lese-/Schreibzugriff, der den standardmäßigen virtuellen Verzeichnispfad enthält.
`PhysicalPath`	Ein `string` Wert mit Lese-/Schreibzugriff, der den physischen Standardpfad angibt, der dem virtuellen Verzeichnis zugeordnet ist.
`UserName`	Ein `string` Lese-/Schreibwert, der einen Standardbenutzer angibt, der über Berechtigungen für den Zugriff auf Konfigurationsdateien oder -inhalte in einem virtuellen Verzeichnis verfügt. Der Standardwert ist `null`.

Unterklassen

Diese Klasse enthält keine Unterklassen.

Hinweise

Instanzen dieser Klasse sind in der VirtualDirectoryDefaults Eigenschaft der Server-, Standort- und Anwendungsklassen enthalten.

Die folgende Tabelle enthält die möglichen Werte und Schlüsselwörter für die LogonMethod Eigenschaft. Der Standardwert ist 3 (ClearText). Weitere Informationen finden Sie in der LogonUserEx-Funktion.

Wert	Schlüsselwort	Beschreibung
0	Interactive	Ermöglicht es dem Benutzer, sich interaktiv über einen Terminalserver, eine Remote-Shell oder einen ähnlichen Prozess anzumelden. Da dieser Anmeldetyp Anmeldeinformationen für getrennte Vorgänge zwischenspeichert, kann die Leistung beeinträchtigt werden. Dieser Anmeldetyp ist daher für Client-/Serveranwendungen, z. B. E-Mail-Server, ungeeignet.
1	Batch	Ermöglicht es dem Benutzer, sich über einen Batchserver anzumelden, bei dem Prozesse für den Benutzer ohne Eingreifen des Benutzers ausgeführt werden können. Dieser Anmeldetyp ist für Server wie E-Mail- oder Webserver geeignet, die viele Nur-Text-Authentifizierungsversuche gleichzeitig verarbeiten. Anmeldeinformationen werden für diesen Anmeldetyp nicht zwischengespeichert.
2	Network	Ermöglicht es dem Benutzer, sich über einen hochleistungsorientierten Server anzumelden, der Nur-Text-Kennwörter authentifiziert. Anmeldeinformationen werden für diesen Anmeldetyp nicht zwischengespeichert.
3	ClearText	Ermöglicht dem Benutzer die Anmeldung mithilfe der Standardauthentifizierung. Der Name und das Passwort des Benutzers werden in einem Authentifizierungspaket gespeichert, das es dem Server ermöglicht, Verbindungen zu anderen Netzwerkservern herzustellen, während er sich als Client ausgibt. Ein Authentifizierungspaket ist eine DLL, die die Authentifizierungslogik kapselt, die bestimmt, ob ein Benutzer sich anmelden kann. Die lokale Sicherheitsbehörde (Local Security Authority, LSA) authentifiziert eine Benutzeranmeldung, indem sie die Anforderung an ein Authentifizierungspaket sendet. Das Authentifizierungspaket überprüft dann die Anmeldeinformationen und authentifiziert den Benutzeranmeldungsversuch oder lehnt den Anmeldeversuch ab.

Beispiel

Das folgende Beispiel zeigt, wie der Benutzername und das Kennwort für alle virtuellen Verzeichnisse auf einer Website festgelegt werden. Anschließend wird gezeigt, wie Sie alle Standardeinstellungen für das virtuelle Verzeichnis für die Website abrufen.

' 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

Vererbungshierarchie

EmbeddedObject

VirtualDirectoryElementDefaults

Anforderungen

type	Beschreibung
Client	- IIS 7.0 unter Windows Vista. - IIS 7.5 unter Windows 7 - IIS 8.0 unter Windows 8 - IIS 10.0 unter Windows 10
Server	- IIS 7.0 unter Windows Server 2008 - IIS 7.5 unter Windows Server 2008 R2 - IIS 8.0 auf Windows Server 2012. - IIS 8.5 unter Windows Server 2012 R2 - IIS 10.0 auf Windows Server 2016
Produkt	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF-Datei	WebAdministration.mof

Weitere Informationen

Application-Klasse
EmbeddedObject-Klasse
Serverklasse
Websiteklasse
VirtualDirectory-Klasse
LogonUserEx

Freigeben über