HandlersSection-Klasse

Speichert die Handler für eine URL.

Syntax

class HandlersSection : ConfigurationSectionWithCollection  

Methoden

In der folgenden Tabelle werden die Methoden aufgelistet, die von der HandlersSection 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 sind die Eigenschaften aufgeführt, die von der HandlersSection Klasse verfügbar gemacht werden.

Name	Beschreibung
AccessPolicy	Ein sint32, dass die Zugriffsrichtlinie für den Handler angibt. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.
Handlers	Ein Array von HandlerAction-Objekten .
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

Diese Klasse entspricht dem <handlers> Abschnitt in der Datei ApplicationHost.config.

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die AccessPolicy Eigenschaft angezeigt. Der Standardwert ist 1 (Read).

Wert	Schlüsselwort	Beschreibung
0	None	Handler sind nicht berechtigt.
1	Read	Handler sind leseberechtigt für Dateien oder Inhalte von . Hinweis: Dieses Flag wurde in IIS 6.0 benannt AccessRead .
2	Write	Handler dürfen in aktivierte Verzeichnisse auf dem Server schreiben oder den Inhalt einer schreibfähigen Datei ändern. Hinweis: Dieses Flag wurde in IIS 6.0 benannt AccessWrite .
4	Execute	Handler dürfen Dateien oder Inhalte von Ordnern unabhängig vom Dateityp ausführen. Hinweis: Dieses Flag wurde in AccessExecuteIIS 6.0 benannt .
16	Source	Handler dürfen auf den Skriptquellcode zugreifen, wenn auch das Read oder das Write- Kennzeichen festgelegt ist. Wenn Read festgelegt, können Handler den Quellcode lesen. Wenn Write festgelegt, können Handler in den Quellcode schreiben. Das Source Flag ist nicht verfügbar, wenn weder Read noch Write festgelegt ist. Hinweis: Dieses Flag wurde in IIS 6.0 benannt AccessSource .
512	Script	Der Handler darf Skripts ausführen. Hinweis: Dieses Flag wurde in IIS 6.0 benannt AccessScript .
1024	NoRemoteWrite	Der Handler darf nicht remote schreiben. Remoteanforderungen zum Erstellen oder Ändern von Dateien werden verweigert. Wenn das Write Flag auch festgelegt ist, werden Anforderungen nur von dem Computer ausgeführt, auf dem der IIS-Webserver ausgeführt wird, erfolgreich. Hinweis: Dieses Flag wurde in IIS 6.0 benannt AccessNoRemoteWrite .
4096	NoRemoteRead	Der Handler darf nicht remote gelesen werden. Remoteanforderungen zum Anzeigen von Dateien werden verweigert. Wenn das Read Flag auch festgelegt ist, werden Anforderungen nur von dem Computer ausgeführt, auf dem der IIS-Webserver ausgeführt wird, erfolgreich. Hinweis: Dieses Flag wurde in IIS 6.0 benannt AccessNoRemoteRead .
8192	NoRemoteExecute	Der Handler darf nicht remote ausführen. Remoteanforderungen zum Ausführen von Anwendungen werden verweigert. Wenn das Execute Flag auch festgelegt ist, werden Anforderungen nur von dem Computer ausgeführt, auf dem der IIS-Webserver ausgeführt wird, erfolgreich. Hinweis: Dieses Flag wurde in IIS 6.0 benannt AccessNoRemoteExecute .
16384	NoRemoteScript	Der Handler darf Skripts nicht remote ausführen. Remoteanforderungen zum Ausführen dynamischer Inhalte werden verweigert. Wenn das Script Flag auch festgelegt ist, werden Anforderungen nur von dem Computer ausgeführt, auf dem der IIS-Webserver erfolgreich ausgeführt wird. Hinweis: Dieses Flag wurde in IIS 6.0 benannt AccessNoRemoteScript .

Beispiel

In den folgenden Beispielen wird ein Handler aus dem <handlers> Abschnitt hinzugefügt und entfernt.

Hinweis

Das Hinzufügen oder Entfernen eines Konfigurationselements ändert den zugrunde liegenden Konfigurationsabschnitt, aber nicht die Objektvariable im Skript, die den Konfigurationsabschnitt darstellt. Damit die Änderung in Ihren Skripts angezeigt wird, müssen Sie die WMI-Methode Refresh_ für die Objektvariable aufrufen, nachdem Sie die Änderung vorgenommen haben. Dadurch wird die Objektvariable mit den neuesten Daten aus dem Konfigurationsspeicher aktualisiert.

' ----------------------------------------------------------  
' The first example adds a handler to the <handlers> section.  
' ----------------------------------------------------------  
' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the <handlers> section.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "HandlersSection", oHandlersSection  
  
' Display the old handler names.  
WScript.Echo "---[Old Handler List]---"  
Call DisplayHandlers  
  
' Create a new handler.  
Set oHandler = oWebAdmin.Get("HandlerAction").SpawnInstance_  
oHandler.Name = "NewHandler"   
oHandler.Path="*.stm"   
oHandler.Verb="GET,POST"   
oHandler.Modules="ServerSideIncludeModule"   
  
' Add the handler to the <handlers> section.  
oHandlersSection.Add "Handlers", oHandler  
  
' Call the WMI Refresh_ method to update the oHandlersSection object.  
oHandlersSection.Refresh_  
  
' Display the new handler names.   
WScript.Echo "---[New Handler List]---"  
Call DisplayHandlers  
  
' ----------------------------------------------------------------  
' The second example removes a handler by using the handler name.  
' ----------------------------------------------------------------  
' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the <handlers> section.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "HandlersSection", oHandlersSection  
  
' Display the old handler names.  
WScript.Echo "---[Old Handler List]---"  
Call DisplayHandlers  
  
' Remove the CGI-exe handler by name.  
For Each oHandler In oHandlersSection.Handlers  
     If oHandler.Name = "CGI-exe" Then  
        oHandlersSection.Remove "Handlers", oHandler  
    End If   
Next  
  
' Call the WMI Refresh_ method to update the oHandlersSection object.  
oHandlersSection.Refresh_  
  
' Display the new list of handler names.   
WScript.Echo "---[New Handler List]---"  
Call DisplayHandlers  
  
' This is the sub that displays the handler names.  
Sub DisplayHandlers  
    WScript.Echo   
    For Each oHandler In oHandlersSection.Handlers  
        WScript.Echo "Handler Name: " & oHandler.Name  
    Next  
End Sub  
  

Vererbungshierarchie

ConfigurationSection

ConfigurationSectionWithCollection

HandlersSection

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
HandlerAction-Klasse