HandlersSection (clase)
Almacena los controladores de una dirección URL.
Sintaxis
class HandlersSection : ConfigurationSectionWithCollection
Métodos
En la tabla siguiente se enumeran los métodos que expone la clase HandlersSection.
| Nombre | Descripción |
|---|---|
| Add (Agregar) | (Se hereda de ConfigurationSectionWithCollection). |
| Borrar | (Se hereda de ConfigurationSectionWithCollection). |
| Get | (Se hereda de ConfigurationSectionWithCollection). |
| GetAllowDefinition | (Se hereda de ConfigurationSection). |
| GetAllowLocation | (Se hereda de ConfigurationSection). |
| Remove | (Se hereda de ConfigurationSectionWithCollection). |
| RevertToParent | (Se hereda de ConfigurationSection). |
| SetAllowDefinition | (Se hereda de ConfigurationSection). |
| SetAllowLocation | (Se hereda de ConfigurationSection). |
Propiedades
La siguiente tabla muestra las propiedades que expone la clase HandlersSection.
| Nombre | Descripción |
|---|---|
AccessPolicy |
sint32 que especifica la directiva de acceso para los controladores. Los valores posibles se enumeran más adelante en la sección Comentarios. |
Handlers |
Matriz de objetos HandlerAction. |
Location |
(Se hereda de ConfigurationSection). Una propiedad clave. |
Path |
(Se hereda de ConfigurationSection). Una propiedad clave. |
SectionInformation |
(Se hereda de ConfigurationSection). |
Subclases
Esta clase no contiene subclases.
Comentarios
Esta clase corresponde a la sección <handlers> del archivo ApplicationHost.config.
En la siguiente tabla se describen los posibles valores de la propiedad AccessPolicy. El valor predeterminado es 1 (Read).
| Valor | Palabra clave | Descripción |
|---|---|---|
| 0 | None |
A los controladores no se les permite ningún derecho. |
| 1 | Read |
Los controladores pueden usar permisos de lectura para los archivos o el contenido de las carpetas. Nota: Esta marca se denominaba AccessRead en IIS 6.0. |
| 2 | Write |
Los controladores pueden escribir en directorios habilitados en el servidor o cambiar el contenido de un archivo habilitado para escritura. Nota: Esta marca se denominaba AccessWrite en IIS 6.0. |
| 4 | Execute |
Los controladores pueden ejecutar archivos o contenido de carpetas, independientemente del tipo de archivo. Nota: Esta marca se denominaba AccessExecute en IIS 6.0. |
| 16 | Source |
Los controladores pueden acceder al código fuente del script si también se establece la marca Read o Write. Si Read se establece, los controladores pueden leer el código fuente. Si Write se establece, los controladores pueden escribir en el código fuente. La marca Source no está disponible si no se establecen Read ni Write. Nota: Esta marca se denominaba AccessSource en IIS 6.0. |
| 512 | Script |
El controlador puede ejecutar scripts. Nota: Esta marca se denominaba AccessScript en IIS 6.0. |
| 1024 | NoRemoteWrite |
El controlador no puede escribir de forma remota. Se deniegan las solicitudes remotas para crear o cambiar archivos. Si también se establece la marca Write, solo se realizarán correctamente las solicitudes del equipo que ejecuta el servidor web de IIS. Nota: Esta marca se denominaba AccessNoRemoteWrite en IIS 6.0. |
| 4096 | NoRemoteRead |
El controlador no puede leer de forma remota. Se deniegan las solicitudes remotas para ver los archivos. Si también se establece la marca Read, solo se realizarán correctamente las solicitudes del equipo que ejecuta el servidor web de IIS. Nota: Esta marca se denominaba AccessNoRemoteRead en IIS 6.0. |
| 8192 | NoRemoteExecute |
El controlador no puede hacer ejecuciones de forma remota. Se deniegan las solicitudes remotas para ejecutar aplicaciones. Si también se establece la marca Execute, solo se realizarán correctamente las solicitudes del equipo que ejecuta el servidor web de IIS. Nota: Esta marca se denominaba AccessNoRemoteExecute en IIS 6.0. |
| 16384 | NoRemoteScript |
El controlador no puede ejecutar scripts de forma remota. Se deniegan las solicitudes remotas para ejecutar contenido dinámico. Si también se establece la marca Script, solo se realizarán correctamente las solicitudes del equipo que ejecuta el servidor web de IIS. Nota: Esta marca se denominaba AccessNoRemoteScript en IIS 6.0. |
Ejemplo
En los ejemplos siguientes se agrega y quita un controlador en la sección <handlers>.
Nota:
Agregar o quitar un elemento de configuración cambia la sección de configuración subyacente, pero no la variable de objeto del script que representa la sección de configuración. Para que el cambio aparezca en los scripts, debe llamar al método WMI Refresh_ en la variable de objeto después de realizar el cambio. Esto actualizará la variable de objeto con los datos más recientes del almacén de configuración.
' ----------------------------------------------------------
' 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
Jerarquía de herencia
ConfigurationSectionWithCollection
HandlersSection
Requisitos
| Tipo | Descripción |
|---|---|
| Remoto | - IIS 7.0 en Windows Vista - IIS 7.5 en Windows 7 - IIS 8.0 en Windows 8 - IIS 10.0 en Windows 10 |
| Server | - IIS 7.0 en Windows Server 2008 - IIS 7.5 en Windows Server 2008 R2 - IIS 8.0 en Windows Server 2012 - IIS 8.5 en Windows Server 2012 R2 - IIS 10.0 en Windows Server 2016 |
| Producto | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
| Archivo MOF | WebAdministration.mof |
Consulte también
ConfigurationSectionWithCollection (clase)
HandlerAction (clase)