ConfigurationSectionWithCollection.Remove-Methode

Artikel
03/28/2024

Entfernt das angegebene Element aus einer Auflistung in einem Konfigurationsabschnitt.

Syntax

ConfigurationSectionWithCollection.Remove collectionName, element;

ConfigurationSectionWithCollection.Remove collectionName, element

Parameter

Name	Definition
`collectionName`	Ein `string`-Wert, der den Namen der Auflistung angibt, für die ein Element entfernt werden soll.
`element`	Ein CollectionElement-Objekt, das das zu entfernende Element enthält.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Beispiel

Im folgenden Beispiel werden die Namen der Handler für die Standardwebsite angezeigt, das Handlerelement namens „CGI-exe“ entfernt, falls vorhanden, und dann werden die Handlernamen erneut aufgelistet. Der Code bewirkt, dass der Abschnitt <system.webServer> der Web.config-Datei für die Standardwebsite den folgenden XML-Code hinzugefügt wird:

<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

Beachten Sie, dass das Aufrufen der Remove_-Methode den zugrunde liegenden Konfigurationsspeicher aktualisiert, aber nicht das oHandlersSection-Objekt, das im Arbeitsspeicher ausgeführt wird. Wenn Sie die Refresh_-Methode aufrufen, stellt oHandlersSection sicher, dass ihre Daten korrekt sind, wenn Sie sie später im selben Skript verwenden müssen.

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

Freigeben über