BasicAuthenticationSection-Klasse

Artikel
04/01/2024

Konfiguriert die Standardauthentifizierung.

Syntax

class BasicAuthenticationSection : ConfigurationSection

Methoden

In der folgenden Tabelle werden die Methoden aufgelistet, die von der BasicAuthenticationSection-Klasse verfügbar gemacht werden.

Name	Beschreibung
GetAllowDefinition	(Geerbt von ConfigurationSection.)
GetAllowLocation	(Geerbt von `ConfigurationSection`.)
RevertToParent	(Geerbt von `ConfigurationSection`.)
SetAllowDefinition	(Geerbt von `ConfigurationSection`.)
SetAllowLocation	(Geerbt von `ConfigurationSection`.)

Eigenschaften

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

Name	Beschreibung
`DefaultLogonDomain`	Ein Lese-/Schreibwert `string`, der die Standarddomäne angibt, die der Server zum Authentifizieren von Benutzern verwendet, wenn der Client keine Domäne im Anmeldedialogfeld angibt.
`Enabled`	Ein Lese-/Schreibwert `boolean`. `true`, wenn die Standardauthentifizierung aktiviert ist; andernfalls `false`. Der Standardwert ist `false`.
`Location`	(Geerbt von `ConfigurationSection`.) Eine Schlüsseleigenschaft.
`LogonMethod`	Eine Lese-/Schreib-Enumeration `sint32`, die die Standardanmeldungsmethode für einen lokalen Benutzer angibt. Der Anmeldetyp bestimmt, ob das resultierende Token auch remote verwendet werden kann. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.
`Path`	(Geerbt von `ConfigurationSection`.) Eine Schlüsseleigenschaft.
`Realm`	Ein Lese-/Schreibwert `string`, der den Namen des Bereichs enthält, der vom Client für die Zwischenspeicherung von Anmeldeinformationen verwendet wird.
`SectionInformation`	(Geerbt von `ConfigurationSection`.)

Unterklassen

Diese Klasse enthält keine Unterklassen.

Hinweise

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die LogonMethod-Eigenschaft angezeigt. Der Standardwert ist 3 (ClearText). Weitere Informationen finden Sie in der LogonUserEx-Funktion.

Wert	Schlüsselwort	Beschreibung
0	`Interactive`	Dieser Anmeldetyp ist für Benutzer vorgesehen, die interaktiv den Computer verwenden.
1	`Batch`	Dieser Anmeldetyp ist für Batchserver vorgesehen, bei denen Prozesse im Auftrag eines Benutzers ohne direkte Intervention ausgeführt werden können. Anmeldeinformationen werden für diesen Anmeldetyp nicht zwischengespeichert.
2	`Network`	Dieser Anmeldetyp ist für Hochleistungsserver zur Authentifizierung von Nur-Text-Kennwörtern vorgesehen. Anmeldeinformationen werden für diesen Anmeldetyp nicht zwischengespeichert.
3	`ClearText`	Dieser Anmeldetyp behält den Namen und das Kennwort im Authentifizierungspaket bei, wodurch der Server Verbindungen zu anderen Netzwerkservern herstellen kann, während er die Identität des Clients vorgibt.

Beispiel

Das folgende Beispiel zeigt die BasicAuthenticationSection-Konfiguration für die Standardwebsite.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = _  
    GetObject("winmgmts:root\WebAdministration")  
  
' Get the Basic authentication section for the default Web site.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "BasicAuthenticationSection", oBasicAuth  
  
' Display the path and location.  
WScript.Echo "Basic Authentication Settings"  
WScript.Echo "-----------------------------"  
WScript.Echo "Path: " & oBasicAuth.Path  
WScript.Echo "Location: " & oBasicAuth.Location  
WScript.Echo   
  
' Display the Enabled, DefaultLogonDomain, Realm, and   
' LogonMethod properties.  
WScript.Echo "Enabled: " & _  
    "[" & oBasicAuth.Enabled & "]"  
  
WScript.Echo "DefaultLogonDomain: " & _  
    "[" & oBasicAuth.DefaultLogonDomain & "]"  
  
WScript.Echo "Realm: " & "[" & oBasicAuth.Realm & "]"  
  
WScript.Echo "LogonMethod: " &  _  
    "[" & GetLogonMethodText(oBasicAuth.LogonMethod) & "]"  
  
' Translate the LogonMethod enumeration values 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 = "Undefined enumeration."  
    End Select  
End Function

Vererbungshierarchie

ConfigurationSection

BasicAuthenticationSection

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

AnonymousAuthenticationSection-Klasse
AuthenticationSection-Klasse
ClientCertificateMappingAuthenticationSection-Klasse
DigestAuthenticationSection-Klasse
FormsAuthenticationConfiguration-Klasse
FormsAuthenticationCredentials-Klasse
FormsAuthenticationUser-Klasse
IisClientCertificateMappingAuthenticationSection-Klasse
PassportAuthentication-Klasse
WindowsAuthenticationSection-Klasse
LogonUserEx

Freigeben über