Partager via


Classe HandlersSection

Stocke les gestionnaires d'une URL.

Syntaxe

class HandlersSection : ConfigurationSectionWithCollection  

Méthodes

Le tableau suivant répertorie les méthodes exposées par la classe HandlersSection.

Nom Description
Ajouter (Hérité de ConfigurationSectionWithCollection.)
Clear (Hérité de ConfigurationSectionWithCollection.)
Get (Hérité de ConfigurationSectionWithCollection.)
GetAllowDefinition (Hérité de ConfigurationSection.)
GetAllowLocation (Hérité de ConfigurationSection.)
Remove (Hérité de ConfigurationSectionWithCollection.)
RevertToParent (Hérité de ConfigurationSection.)
SetAllowDefinition (Hérité de ConfigurationSection.)
SetAllowLocation (Hérité de ConfigurationSection.)

Propriétés

Le tableau suivant répertorie les propriétés exposées par la classe HandlersSection.

Nom Description
AccessPolicy Une sint32 qui spécifie la stratégie d'accès pour les gestionnaires. Les valeurs possibles sont répertoriées plus loin dans la section Remarques.
Handlers Un tableau d'objets HandlerAction.
Location (Hérité de ConfigurationSection.) Propriété de clé.
Path (Hérité de ConfigurationSection.) Une propriété clé.
SectionInformation (Hérité de ConfigurationSection.)

Sous-classes

Cette classe ne contient aucune sous-classe.

Notes

Cette classe correspond à la section <handlers> du fichier ApplicationHost.config.

Le tableau suivant répertorie les valeurs possibles pour la propriété AccessPolicy. La valeur par défaut est 1 (Read).

Valeur Mot clé Description
0 None Les gestionnaires n'ont aucun droit.
1 Read Les gestionnaires sont autorisés à lire les fichiers ou le contenu des dossiers. Remarque : cet indicateur a été nommé AccessRead dans IIS 6.0.
2 Write Les gestionnaires sont autorisés à écrire dans des répertoires activés sur le serveur ou à modifier le contenu d'un fichier accessible en écriture. Remarque : cet indicateur a été nommé AccessWrite dans IIS 6.0.
4 Execute Les gestionnaires sont autorisés à exécuter des fichiers ou du contenu de dossiers, quel que soit le type de fichier. Remarque : cet indicateur a été nommé AccessExecute dans IIS 6.0.
16 Source Les gestionnaires sont autorisés à accéder au code source du script si l'indicateur Write ou l'indicateur Read est également défini. Si Read est défini, les gestionnaires peuvent lire le code source. Si Write est défini, les gestionnaires peuvent écrire dans le code source. L'indicateur Source n'est pas disponible si Read ouWrite n'est défini. Remarque : cet indicateur a été nommé AccessSource dans IIS 6.0.
512 Script Le gestionnaire est autorisé à exécuter des scripts. Remarque : cet indicateur a été nommé AccessScript dans IIS 6.0.
1 024 NoRemoteWrite Le gestionnaire n'est pas autorisé à écrire à distance. Les requêtes distantes pour créer ou modifier des fichiers sont refusées. Si l'indicateur Write est également défini, les requêtes provenant uniquement de l'ordinateur qui exécute le serveur Web IIS aboutissent. Remarque : cet indicateur a été nommé AccessNoRemoteWrite dans IIS 6.0.
4096 NoRemoteRead Le gestionnaire n'est pas autorisé à lire à distance. Les requêtes distantes d'affichage des fichiers sont refusées. Si l'indicateur Read est également défini, les requêtes provenant uniquement de l'ordinateur qui exécute le serveur Web IIS aboutissent. Remarque : cet indicateur a été nommé AccessNoRemoteRead dans IIS 6.0.
8192 NoRemoteExecute Le gestionnaire n'est pas autorisé à s'exécuter à distance. Les requêtes distantes d'exécution des applications sont refusées. Si l'indicateur Execute est également défini, les requêtes provenant uniquement de l'ordinateur qui exécute le serveur Web IIS aboutissent. Remarque : cet indicateur a été nommé AccessNoRemoteExecute dans IIS 6.0.
16384 NoRemoteScript Le gestionnaire n'est pas autorisé à exécuter des scripts à distance. Les requêtes distantes d'exécution du contenu dynamique sont refusées. Si l'indicateur Script est également défini, les requêtes provenant uniquement de l'ordinateur qui exécute le serveur Web IIS aboutissent. Remarque : cet indicateur a été nommé AccessNoRemoteScript dans IIS 6.0.

Exemple

Les exemples suivants ajoutent et suppriment un gestionnaire de la section <handlers>.

Remarque

L'ajout ou la suppression d'un élément de configuration modifie la section de configuration sous-jacente, mais pas la variable objet du script qui représente la section de configuration. Pour que la modification apparaisse dans vos scripts, vous devez appeler la méthode WMI Refresh_ sur la variable objet après avoir apporté la modification. Cette opération permet de mettre à jour la variable objet avec les données les plus récentes du magasin de configuration.

' ----------------------------------------------------------  
' 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  
  

Hiérarchie d'héritage

ConfigurationSection

ConfigurationSectionWithCollection

HandlersSection

Spécifications

Type Description
Client - IIS 7.0 sur Windows Vista
- IIS 7.5 sur Windows 7
- IIS 8.0 sous Windows 8
- IIS 10.0 sur Windows 10
Serveur - IIS 7.0 sous Windows Server 2008
- IIS 7.5 sous Windows Server 2008 R2
- IIS 8.0 sur Windows Server 2012
- IIS 8.5 sur Windows Server 2012 R2
- IIS 10.0 sur Windows Server 2016
Produit - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Fichier MOF WebAdministration.mof

Voir aussi

Classe ConfigurationSectionWithCollection
Classe HandlerAction