ApplicationPool-Klasse1

Artikel
03/28/2024

Stellt einen IIS-Anwendungspool dar.

Syntax

class ApplicationPool : Object

Methoden

In der folgenden Tabelle werden die Methoden aufgelistet, die von der ApplicationPool-Klasse verfügbar gemacht werden.

Name	Beschreibung
Erstellen	Erstellt einen Anwendungspool.
GetState	Gibt den Laufzeitstatus eines Anwendungspools zurück.
Neu starten	Recycelt einen Anwendungspool.
RevertToParent	Setzt den Konfigurationswert oder die Werte eines Anwendungspools auf die werte des übergeordneten Anwendungspools zurück.
Starten	Startet einen Anwendungspool.
Beenden	Stoppt einen Anwendungspool.

Eigenschaften

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die von der ApplicationPool-Klasse verfügbar gemacht werden.

Name	Beschreibung
`AutoStart`	Ein Lese-/Schreibwert `boolean`. `true`, wenn der World Wide Web Publishing Service (WWW-Dienst) den Anwendungspool automatisch startet, wenn der Anwendungspool erstellt oder IIS gestartet wird; andernfalls `false`. Der Standardwert ist `true`.
`Cpu`	Ein ApplicationPoolProcessorSettings-Objekt, das die CPU-Einstellungen für einen Anwendungspool enthält.
`Enable32BitAppOnWin64`	Ein Lese-/Schreibwert `boolean`. `true`, wenn 32-Bit-Anwendungen (sowohl verwaltet als auch systemeigene) unter 64-Bit-Versionen von Windows ausgeführt werden können; andernfalls `false`. Der Standardwert ist `false`.
`Failure`	Ein ApplicationPoolFailureSettings-Objekt, das die Eigenschaften definiert, die die auszuführenden Aktionen bestimmen, wenn ein Anwendungspool oder ein Arbeitsprozess fehlschlägt.
`ManagedPipelineMode`	Ein Lese-/Schreibwert `sint32`, der den verwalteten Pipelinemodus angibt. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.
`ManagedRuntimeVersion`	Ein Wert mit Lese-/Schreibzugriff `string`, der die Version der Common Language Runtime (CLR) enthält, die der Anwendungspool vorab auslädt. Der Standard ist „v2.0“. Wenn die Eigenschaft in die Eigenschaft geschrieben wird, verwendet IIS den Anwendungspool und lädt die neu angegebene .NET Framework-Version dafür.
`Name`	Ein schreibgeschützter `string`-Wert, der den eindeutigen Namen des Anwendungspools enthält. Die Schlüsseleigenschaft. Die maximale Länge ist 64 Zeichen. Leerzeichen und Punkte sind zulässig, aber die folgenden Zeichen können nicht verwendet werden: & / \ : * ? \| " <> [ ] + = ; , @
`PassAnonymousToken`	Ein Lese-/Schreibwert `boolean`. `true`, wenn der Windows-Prozessaktivierungsdienst (WAS) ein Token für das integrierte anonyme IUSR-Benutzerkonto erstellt und an das Modul „Anonyme Authentifizierung“ übergibt; andernfalls `false`. Der Standardwert ist `true`. Das Modul „Anonyme Authentifizierung“ verwendet das Token zum Identitätswechsel des integrierten Kontos. Wenn `PassAnonymousToken` ist `false,`, wird das Token nicht übergeben. Hinweis: Das anonyme Benutzerkonto des IUSR ersetzt das IIS_MachineName anonymen Kontos. Das IUSR-Konto kann von IIS oder anderen Anwendungen verwendet werden. Es verfügt über keine Berechtigungen, die ihm während des Setups zugewiesen wurden.
`ProcessModel`	Ein ProcessModelSettings-Objekt, das die Konfigurationseinstellungen für IIS-Arbeitsprozesse definiert.
`QueueLength`	Ein Lese-/Schreibwert `uint32`, der die Anzahl der Anforderungen angibt, die HTTP.sys für einen Anwendungspool in die Warteschlange stellen, bevor weitere Anforderungen abgelehnt werden. Der Standardwert lautet 1000. Wenn der Grenzwert überschritten wird, lehnt HTTP.sys zusätzliche Anforderungen mit einem Fehler von 503 (Dienst nicht verfügbar) ab.
`Recycling`	Ein RecyclingSettings-Objekt, das die Recyclingkonfigurationseinstellungen für Anwendungspools und Arbeitsprozesse definiert.

Unterklassen

Diese Klasse enthält keine Unterklassen.

Hinweise

Ein Anwendungspool ist eine Gruppe von einer oder mehreren URLs, die von einem Arbeitsprozess oder einer Reihe von Arbeitsprozessen bedient werden. Anwendungspools legen Grenzen für die Anwendungen fest, die sie enthalten, was bedeutet, dass alle Anwendungen, die außerhalb eines angegebenen Anwendungspools ausgeführt werden, keine Auswirkungen auf die Anwendungen innerhalb dieses Anwendungspools haben können.

Wenn eine verwaltete Anwendung in einem Anwendungspool mit integriertem Modus ausgeführt wird, verwendet der Server die integrierten Anforderungsverarbeitungspipelines von IIS und ASP.NET, um die Anforderung zu verarbeiten. Wenn eine verwaltete Anwendung jedoch in einem Anwendungspool mit ISAPI-Modus ausgeführt wird, leitet der Server weiterhin Anforderungen für verwalteten Code über Aspnet_isapi.dll und Verarbeiten von Anforderungen weiter, als ob sie in IIS 6.0 ausgeführt wurden.

Die meisten verwalteten Anwendungen sollten erfolgreich in Anwendungspools mit integriertem Modus ausgeführt werden, aber Möglicherweise müssen Sie Anwendungen aus Kompatibilitätsgründen im ISAPI-Modus ausführen. Testen Sie zuerst die Anwendungen im integrierten Modus, um festzustellen, ob Sie den ISAPI-Modus wirklich benötigen.

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die ManagedPipelineMode-Eigenschaft angezeigt. Der Standardwert ist 0 (Integrated).

Wert	Schlüsselwort	Beschreibung
0	`Integrated`	Die verwaltete Pipeline wird im integrierten Modus ausgeführt.
1	`Classic`	Die verwaltete Pipeline wird im ISAPI-Modus ausgeführt.

Beispiel

Im folgenden Beispiel wird der Name und der Modus (Integriert oder ISAPI) der Anwendungspools auf einem Server angezeigt.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Retrieve the application pools on the server.   
Set oAppPools = oWebAdmin.ExecQuery("SELECT * FROM ApplicationPool")  
  
For Each oAppPool In oAppPools  
    WScript.Echo "--------------------------------------"  
    WScript.Echo "Application pool name:    " & oAppPool.Name  
  
    If oAppPool.ManagedPipelineMode = 0 Then  
        sAppPoolMode = "Integrated"  
    ElseIf oAppPool.ManagedPipelineMode = 1 Then  
        sAppPoolMode = "ISAPI"  
    End if  
  
    WScript.Echo "Application pool mode:    " & sAppPoolMode  
Next

Vererbungshierarchie

Objekt

Application Pool

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

Objektklasse
Konfigurieren von Anwendungspools in IIS 7.0

Freigeben über