Méthode ConfigurationSectionWithCollection.Remove

Article
03/20/2024

Supprime l'élément défini d'une collection dans une section de configuration.

Syntaxe

ConfigurationSectionWithCollection.Remove collectionName, element;

ConfigurationSectionWithCollection.Remove collectionName, element

Paramètres

Nom	Définition
`collectionName`	Valeur `string` qui définit le nom de la collection qui a un élément à supprimer.
`element`	Objet CollectionElement qui contient l’élément à supprimer.

Valeur de retour

Cette méthode ne retourne pas de valeur.

Exemple

L’exemple suivant affiche les noms des gestionnaires pour le site internet par défaut, supprime l’élément de gestionnaire nommé « CGI-exe » s’il est présent, puis répertorie à nouveau les noms de gestionnaires. Le code entraîne l’ajout du code XML suivant à la section <system.webServer> du fichier Web.config pour le site internet par défaut :

<handlers>

<remove name="CGI-exe" />

</handlers>

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the default Web site.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
  
' Get the handlers section.  
oSite.GetSection "HandlersSection", oHandlersSection  
  
' Display the current handler names.  
Wscript.Echo "---[Current Handler List]---"  
Call DisplayHandlerNames  
  
' Remove the CGI-exe handler by matching its name.  
For Each oHandler In oHandlersSection.Handlers  
     If oHandler.Name = "CGI-exe" Then  
        oHandlersSection.Remove "Handlers", oHandler  
    End If   
Next  
  
' Refresh the oHandlersSection object so that its contents will  
' reflect the updated configuration.  
oHandlersSection.Refresh_      
  
' List the handler names again to show the change.  
Wscript.Echo "---[New Handler List]---"  
Call DisplayHandlerNames  
  
' Provide a subroutine to display handler names.  
Sub DisplayHandlerNames  
    For Each oHandler In oHandlersSection.Handlers  
        WScript.Echo "Handler Name: " & oHandler.Name  
    Next  
    Wscript.Echo  
End Sub

Remarque : L’appel à la méthode Remove_ met à jour le stockage de configuration sous-jacent, mais pas l’objet oHandlersSection qui s’exécute en mémoire. L’appel à la méthode Refresh_ sur oHandlersSection garantit que ses données sont précises si vous devez l’utiliser ultérieurement dans le même script.

Spécifications

Type	Description
Client	- IIS 7.0 sous Windows Vista - IIS 7.5 sous Windows 7 - IIS 8.0 sous Windows 8 - IIS 10.0 sous Windows 10
Serveur	- IIS 7.0 sous Windows Server 2008 - IIS 7.5 sous Windows Server 2008 R2 - IIS 8.0 sous Windows Server 2012 - IIS 8.5 sous Windows Server 2012 R2 - IIS 10.0 sous 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
Classe HandlersSection

Partager via