IPSecuritySection-Klasse

Artikel
03/25/2024

Konfiguriert den Zugriff auf Webserverinhalte basierend auf IP-Adressinformationen.

Syntax

class IPSecuritySection : ConfigurationSectionWithCollection

Methoden

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

Name	Beschreibung
Add (Hinzufügen)	(Geerbt von ConfigurationSectionWithCollection.)
Clear	(Geerbt von `ConfigurationSectionWithCollection`.)
Get	(Geerbt von `ConfigurationSectionWithCollection`.)
GetAllowDefinition	(Geerbt von ConfigurationSection.)
GetAllowLocation	(Geerbt von `ConfigurationSection`.)
Remove	(Geerbt von `ConfigurationSectionWithCollection`.)
RevertToParent	(Geerbt von `ConfigurationSection`.)
SetAllowDefinition	(Geerbt von `ConfigurationSection`.)
SetAllowLocation	(Geerbt von `ConfigurationSection`.)

Eigenschaften

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

Name	Beschreibung
`AllowUnlisted`	Ein Lese-/Schreibwert `boolean`. `true`, wenn Zugriff auf IP-Adresse, Domänenname und Subnetzmaskenkombinationen gewährt wird, die in der `IPAddressFilters` Eigenschaft nicht angegeben sind; andernfalls `false`. Der Standardwert ist `true`. Diese Eigenschaft wird zuletzt in der Reihenfolge verarbeitet. Hinweis: Wenn Sie die lokale Hostadresse (127.0.0.1) verwenden und die `AllowUnlisted` Eigenschaft auf `false`festgelegt ist, wird Benutzern der Zugriff verweigert, es sei denn, 127.0.0.1 wird als `IPSecurity` Eintrag angegeben, auf den die `Allowed` Eigenschaft `true` festgelegt ist.
`EnableReverseDNS`	Ein Lese-/Schreibwert `boolean`. `true`, wenn eine umgekehrte DNS-Suche durchgeführt wird, um den Domänennamen zu überprüfen, in den eine IP-Adresse aufgelöst wird; andernfalls `false`. Der Standardwert ist `false`. Hinweis: Wenn diese Eigenschaft aktiviert ist, muss IIS den DNS-Namen jeder Client-IP-Adresse auflösen. Eine einzelne DNS-Suche erfordert möglicherweise mehrere Sekunden, und IIS muss warten, bis der Domänenname überprüft werden kann. Sie sollten dieses Verhalten berücksichtigen, wenn Sie umfangreiche Implementierungen planen.
`IpSecurity`	Ein Array von Lese-/Schreibzugriffs-IPAddressFilterElement-Werten, die IP-Adresse, Domänenname und Subnetzmaskenkombinationen angeben, auf die der Zugriff gewährt oder verweigert wird. Hinweis: Die Einträge in dieser Eigenschaft werden in der Reihenfolge verarbeitet. Es wird empfohlen, die Einträge zuerst in der Liste zu verweigern.
`Location`	(Geerbt von `ConfigurationSection`.) Eine Schlüsseleigenschaft.
`Path`	(Geerbt von `ConfigurationSection`.) Eine Schlüsseleigenschaft.
`SectionInformation`	(Geerbt von `ConfigurationSection`.)

Unterklassen

Diese Klasse enthält keine Unterklassen.

Hinweise

In IIS 6.0 wurden URLs einzeln gewährt oder verweigert. In IIS 7 werden jedoch Zugriffsregeln geerbt, und ihre Semantik wird zusammengeführt, um den endgültigen Zugriff zu bestimmen, weshalb die Anordnung von Regeln wichtig ist.

Beispiel

Im folgenden Beispiel werden die IPSecuritySection-Werte für die Standardwebsite angezeigt.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = _  
    GetObject("winmgmts:root\WebAdministration")  
  
' Get the IP security section for the default Web site.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "IPSecuritySection", oSection  
  
' Display the Path and Location properties.  
WScript.Echo "=============================="  
WScript.Echo "IP Security Section Properties"  
WScript.Echo "=============================="  
WScript.Echo "Path: " & oSection.Path  
WScript.Echo "Location: " & oSection.Location  
WScript.Echo  
  
' Display the AllowUnlisted and   
' EnableReverseDns properties.  
WScript.Echo "AllowUnlisted: " & oSection.AllowUnlisted  
WScript.Echo "EnableReverseDns: " & _  
                oSection.EnableReverseDns  
WScript.Echo  
  
' Display the IP and domain restrictions.  
WScript.Echo "--------------------------"  
WScript.Echo "IP and domain restrictions"  
WScript.Echo "--------------------------"  
For Each oIPAddressFilter In oSection.IpSecurity  
    WScript.Echo "IpAddress: " & oIPAddressFilter.IpAddress      
    WScript.Echo "DomainName: " & _  
        oIPAddressFilter.DomainName  
    WScript.Echo "SubnetMask: " & _  
        oIPAddressFilter.SubnetMask  
    WScript.Echo "Allowed: " & oIPAddressFilter.Allowed  
    WScript.Echo  
Next

Vererbungshierarchie

ConfigurationSection

ConfigurationSectionWithCollection

IPSecuritySection

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

ConfigurationSectionWithCollection-Klasse
IPAddressFilterElement-Klasse

Freigeben über