ProcessModelSection-Klasse

Artikel
03/25/2024

Konfiguriert die ASP.NET Prozessmodelleinstellungen auf einem Webserver, auf dem IIS ausgeführt wird.

Syntax

class ProcessModelSection : ConfigurationSection

Methoden

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

Name	Beschreibung
GetAllowDefinition	(Geerbt von ConfigurationSection.)
GetAllowLocation	(Geerbt von `ConfigurationSection`.)
RevertToParent	(Geerbt von `ConfigurationSection`.)
SetAllowDefinition	(Geerbt von `ConfigurationSection`.)
SetAllowLocation	(Geerbt von `ConfigurationSection`.)

Eigenschaften

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

Name	Beschreibung
`AutoConfig`	Ein Lese-/Schreib`boolean`-Wert. `true` wenn ASP.NET bestimmte Attribute automatisch so konfiguriert, dass eine optimale Leistung erzielt wird, die auf der Computerkonfiguration basiert; `false` wenn ASP.NET die explizit definierten Werte für die Attribute verwendet. Der Standardwert ist `false`. Die konfigurierten Attribute werden weiter unten im Abschnitt "Hinweise" aufgeführt. Hinweis: Diese Attribute wirken sich nur auf ASP.NET Anwendungen aus, nicht auf die .NET Framework-Clientanwendungen. Hinweis: Die Standardeinstellung für diese Eigenschaft in der Datei "Machine.config" lautet `true`, welche die Einstellungen in niedrigeren Konfigurationsdateien überschreiben wird. Wenn Sie den `autoConfig` Eintrag aus Machine.config entfernen, wird der Standardwert auf `false`rückgängig gemacht.
`ClientConnectedCheck`	Ein Lese-/Schreib`datetime`-Wert, der angibt, wie lange eine Anforderung in der Warteschlange verbleibt, bevor ASP.NET eine Überprüfung durchführt, um zu bestimmen, ob der Client verbunden ist. Der Standardwert lautet 5 Sekunden.
`ComAuthenticationLevel`	Ein Lese-/Schreib`sint32`-Wert, der die Authentifizierungsebene für DCOM-Sicherheit angibt. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.
`ComImpersonationLevel`	Ein Lese-/Schreib`sint32`-Wert, der die Authentifizierungsstufe für COM-Sicherheit angibt. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.
`CpuMask`	Ein Lese-/Schreib`sint32`-Wert, der angibt, welche Prozessoren (CPUs) auf einem Multiprozessorserver für die Ausführung ASP.NET Prozesse qualifiziert sind. Der Standardwert ist 0xffffffff. Dieser Wert gibt ein Bitmuster an, das die CPUs angibt, die für die Ausführung ASP.NET Threads qualifiziert sind. Beispielsweise stellt der hexadezimale Wert 0x0d das Bitmuster 1101 dar. Auf einem Computer mit vier CPUs gibt dies an, dass ASP.NET Prozesse auf CPUs 0, 2 und 3, aber nicht auf CPU 1 geplant werden können. ASP.NET startet einen Arbeitsprozess für jede qualifizierte CPU. Wenn `WebGarden` die Eigenschaft`true` lautet, schränkt `CpuMask`die Arbeitsprozesse auf die Anzahl der qualifizierten CPUs ein. Die maximale Anzahl von Arbeitsprozessen entspricht der Anzahl der CPUs. Wenn die `WebGarden` Eigenschaft `false` (der Standardwert) ist, wird `CpuMask` ignoriert und nur ein Arbeitsprozess ausgeführt.
`Enable`	Ein Lese-/Schreib`boolean`-Wert. `true` wenn das Prozessmodell aktiviert ist; andernfalls, `false`. Der Standardwert ist `true`.
`IdleTimeout`	Ein Lese-/Schreib`datetime`-Wert, der den Zeitraum der Inaktivität angibt, nach dem ASP.NET den Arbeitsprozess automatisch beendet. Der Standardwert ist unendlich.
`Location`	(Geerbt von `ConfigurationSection`.) Eine Schlüsseleigenschaft.
`LogLevel`	Ein Lese-/Schreib-Wert`sint32`, der Ereignistypen angibt, die in das Ereignisprotokoll geschrieben werden sollen. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.
`MaxAppDomains`	Ein Lese-/Schreib`sint32`-Wert, der die maximale Anzahl von Anwendungsdomänen angibt, die in einem Prozess zulässig sind. Dieses Attribut muss kleiner oder gleich 2000 sein. Der Standardwert ist „2000“.
`MaxIOThreads`	Ein Lese-/Schreib`sint32`-Wert, der die maximale Anzahl von E/A-Threads (von 5 bis 100) angibt, die für den Prozess pro CPU verwendet werden sollen. Der Standardwert ist 20. Wenn dieser Wert beispielsweise 25 auf einem Einzelprozessorserver ist, legt ASP.NET den Prozessgrenzwert auf 25 fest. Auf einem Server mit zwei Prozessoren legt ASP.NET den Grenzwert auf 50 fest. Der Wert dieser Eigenschaft muss gleich oder größer als die `MinFreeThread` Eigenschaft der HttpRuntimeSection-Klasse sein.
`MaxWorkerThreads`	Ein Lese-/Schreib`sint32`-Wert, der die maximale Anzahl von Arbeitsthreads (von 5 bis 100) angibt, die für den Prozess pro CPU verwendet werden sollen. Der Standardwert ist 20. Wenn dieser Wert beispielsweise 25 auf einem Einzelprozessorserver ist, verwendet ASP.NET die Laufzeit-APIs, um den Prozessgrenzwert auf 25 festzulegen. Auf einem Server mit zwei Prozessoren legt ASP.NET den Grenzwert auf 50 fest. Der Wert dieser Eigenschaft muss gleich oder größer als die `MinFreeThread` Eigenschaft der `HttpRuntimeSection` Klasse sein.
`MemoryLimit`	Ein Lese-/Schreib`sint32`-Wert, der die maximal zulässige Arbeitsspeichergröße als Prozentsatz des gesamten Systemspeichers angibt, den der Arbeitsprozess verbrauchen kann, bevor ASP.NET einen neuen Prozess startet und vorhandene Anforderungen neu zuzuweisen. Der Standardwert ist 60.
`MinIOThreads`	Ein Lese-/Schreib`sint32`-Wert, der die Mindestanzahl der E/A-Threads angibt, die für den Prozess pro CPU-Basis verwendet werden sollen. Der Standardwert ist 1.
`MinWorkerThreads`	Ein Lese-/Schreib`sint32`-Wert, der die maximale Anzahl von Arbeitsthreads angibt, die für den Prozess pro CPU-Basis verwendet werden sollen. Der Standardwert ist 1.
`Password`	Ein Lese-/Schreib`string`-Wert (sofern vorhanden), der zusammen mit der `UserName` Eigenschaft den Arbeitsprozess mit der konfigurierten Microsoft Windows-Identität ausführt. Der Standardwert ist "AutoGenerate". Hinweis: Weitere Informationen zu den speziellen Namen "System" und "Computer", die kein Kennwort erfordern, sowie Informationen zum Speichern verschlüsselter Arbeitsprozessanmeldeinformationen in der Registrierung finden Sie in der `UserName` Eigenschaft.
`Path`	(Geerbt von `ConfigurationSection`.) Eine Schlüsseleigenschaft.
`PingFrequency`	Ein Lese-/Schreib`datetime`-Wert, der das Zeitintervall angibt, in dem die ISAPI-Erweiterung den Arbeitsprozess angibt, um zu bestimmen, ob der Prozess ausgeführt wird. Der Standardwert ist unendlich. Wenn der Arbeitsprozess nicht in dem durch die `PingTimeout` Eigenschaft angegebenen Intervall reagiert, wird er neu gestartet.
`PingTimeout`	Ein Lese-/Schreib`datetime`-Wert, der das Zeitintervall angibt, nach dem ein Arbeitsprozess, der nicht mehr reagiert, neu gestartet wird. Der Standardwert ist unendlich. Die ISAPI-Erweiterungen pingen den Arbeitsprozess im durch die `PingFrequency` Eigenschaft angegebenen Intervall. Wenn der Arbeitsprozess nicht in dem durch die `PingTimeout` Eigenschaft angegebenen Intervall reagiert, wird er neu gestartet.
`RequestLimit`	Ein Lese-/Schreib`sint32`-Wert, der die Anzahl der Anforderungen angibt, die zulässig sind, bevor ASP.NET automatisch einen neuen Arbeitsprozess startet, um den Platz des aktuellen zu übernehmen. Der Standardwert ist 2147483647.
`RequestQueueLimit`	Ein Lese-/Schreib`sint32`-Wert, der die Anzahl der Anforderungen angibt, die in der Warteschlange zulässig sind, bevor ASP.NET die Meldung "503 – Server zu beschäftigt" an neue Anforderungen zurückgibt. Der Standard ist 5.000.
`ResponseDeadlockInterval`	Ein Lese-/Schreib`datetime`-Wert, der das Zeitintervall angibt, nach dem der Prozess neu gestartet wird, wenn in die Warteschlange eingereihte Anforderungen vorhanden sind und während des angegebenen Intervalls keine Antwort aufgetreten ist. Der Standardwert ist 3 Minuten.
`ResponseRestartDeadlockInterval`	Ein Lese-/Schreib`datetime`-Wert , der aus Gründen der Abwärtskompatibilität bereitgestellt wird, das das Zeitintervall angibt, nach dem der Prozess neu gestartet wird, wenn in die Warteschlange eingereihte Anforderungen vorhanden sind und während des angegebenen Intervalls keine Antwort aufgetreten ist. Der Standardwert ist 3 Minuten. Hinweis: ASP.NET verwendet diese Eigenschaft nicht mehr; sie wird nur aus Gründen der Abwärtskompatibilität bereitgestellt. Diese Eigenschaft verursacht keinen Konfigurationsfehler, wenn sie bereits in einer Konfigurationsdatei vorhanden ist. Die `ResponseDeadlockInterval` Eigenschaft steuert nun den Neustart von Deadlocking-Prozessen.
`RestartQueueLimit`	Ein Lese-/Schreib`sint32`-Wert, der die maximale Anzahl von Anforderungen angibt, die IIS abfragt, während es darauf wartet, dass der Arbeitsprozesses nach einer nicht standardmäßigen Beendigung neu startet. Diese Einstellung gilt nicht für ein sauberes Herunterfahren oder einen Standardneustart. Der Standardwert ist 10.
`SectionInformation`	(Geerbt von `ConfigurationSection`.)
`ServerErrorMessageFile`	Ein Lese-/Schreib`string`-Wert, der den Inhalt einer zu verwendenden Datei anstelle der Standardmeldung "Server nicht verfügbar" angibt, wenn ein Server unerwartet nicht mehr reagiert. Der Dateispeicherort ist relativ zur Machine.config-Datei oder kann ein absoluter Pfad sein. Wenn Sie diesen Eigenschaftswert nicht angeben, verwendet IIS die Standardmeldung "Server Nicht verfügbar".
`ShutdownTimeout`	Ein Lese-/Schreib`datetime`-Wert, der die Zeit angibt, die für das Herunterfahren des Arbeitsprozesses zulässig ist. Der Standardwert lautet 5 Sekunden. Wenn der Timeout abläuft, wird ASP.NET den Arbeitsprozess herunterfahren.
`Timeout`	Ein Lese-/Schreib`datetime`-Wert, der die Anzahl der Minuten angibt, bis ASP.NET einen neuen Arbeitsprozess startet, um den Platz des aktuellen Vorgangs zu übernehmen. Der Standardwert ist unendlich.
`UserName`	Ein Lese-/Schreib`string`-Wert, der angibt, dass ASP.NET den Arbeitsprozess mit einer Windows-Identität ausführt, die sich von der Standardprozessidentität unterscheidet. Der Standardwert ist "Computer". Standardmäßig wird der Prozess unter einem Benutzerkonto und einem Kennwort ausgeführt, das automatisch erstellt wird, wenn ASP.NET installiert wird. Das Benutzerkonto heißt ASPNET, und das Kennwort wird kryptografisch generiert. Wenn gültige Anmeldeinformationen sowohl in den Eigenschaften `Password` als auch in den `UserName` Eigenschaften angezeigt werden, wird der Prozess mit dem angegebenen Konto ausgeführt. Wenn der `UserName` Wert "System" ist und der `Password` Wert "AutoGenerate" lautet, wird der Prozess mit vollständigen Administratorberechtigungen für alle ASP.NET Code ausgeführt, der den Prozess verwendet. Hinweis: Die Werte dieser Eigenschaft und die `Password` Eigenschaft werden in klartext in der Konfigurationsdatei gespeichert. Obwohl IIS KEINE CONFIG-Dateien als Reaktion auf eine Benutzer-Agent-Anforderung überträgt, können Konfigurationsdateien auf andere Weise gelesen werden. Beispielsweise kann ein authentifizierter Benutzer, der über die erforderlichen Anmeldeinformationen für die Domäne für den Server verfügt, eine Konfigurationsdatei lesen. Aus Sicherheitsgründen unterstützt die `ProcessModelSection`Klasse die Speicherung verschlüsselter `UserName` und `Password` Eigenschaften in der Registrierung. Weitere Informationen finden Sie unter processModel Element (ASP.NET Settings Schema).
`WebGarden`	Ein Lese-/Schreib`boolean`-Wert. `true` wenn die `CpuMask` Eigenschaft verwendet wird, um anzugeben, welche CPUs qualifiziert sind, um ASP.NET Prozesse auszuführen. `false` Wenn nur ein Arbeitsprozess ausgeführt wird und die CPU-Auslastung vom Windows-Betriebssystem geplant wird. Der Standardwert ist `false`. Hinweis: Ein Multiprozessorwebserver wird als Webgarten bezeichnet.

Unterklassen

Diese Klasse enthält keine Unterklassen.

Hinweise

Der <processModel> Abschnitt processModel kann nur innerhalb der Datei Machine.config festgelegt werden und wirkt sich auf alle ASP.NET-Anwendungen aus, die auf dem Server ausgeführt werden.

Hinweis

Änderungen an der ProcessModelSection Klasse werden nur wirksam, wenn der Arbeitsprozess neu gestartet wird, nicht unmittelbar nach der Änderung der Einstellung.

In der folgenden Tabelle sind die Attribute aufgeführt, die automatisch konfiguriert werden, wenn die AutoConfig Eigenschaft true.lautet Weitere Informationen finden Sie im Artikel 821268 "Contention, poor performance, and deadlocks when you make Web service requests from ASP.NET applications", in der Microsoft Knowledge Base unter https://support.microsoft.com.

Attribute	Beschreibung
`maxWorkerThreads`	Gibt die maximale Anzahl von Arbeitsthreads pro CPU an, die ASP.NET verwendet.
`maxIoThreads`	Gibt die maximale Anzahl von Abschlussthreads pro CPU an, die ASP.NET verwendet.
`minFreeThreads`	Entspricht der `MinFreeThreads` Eigenschaft der HttpRuntimeSection-Klasse .
`minLocalRequestFreeThreads`	Entspricht der `MinLocalRequestFreeThreads` Eigenschaft der `HttpRuntimeSection` Klasse.
`maxConnection`	Entspricht der `MaxConnection` Eigenschaft der ConnectionManagementElement-Klasse .

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die ComAuthenticationLevel Eigenschaft angezeigt. Der Standardwert ist 2 (Connect).

Wert	Schlüsselwort	Beschreibung
0	`None`	Gibt keine Authentifizierung an.
1	`Call`	Gibt an, dass DCOM die Anmeldeinformationen des Clients authentifiziert, wenn der Server die Anforderung zu Beginn eines Remoteprozeduraufrufs empfängt.
2	`Connect`	Gibt an, dass DCOM die Anmeldeinformationen des Clients nur dann authentifiziert, wenn der Client eine Beziehung mit dem Server herstellt.
3	`Default`	Gibt an, dass DCOM die Authentifizierungsebene mithilfe des normalen Algorithmus zur Sicherheitsaushandlung festlegt.
4	`Pkt`	Gibt an, dass DCOM überprüft, ob alle empfangenen Daten vom erwarteten Client stammen. Für Übertragungen von Datagrammen wird immer die `Pkt`Pkt-Authentifizierung verwendet.
5	`PktIntegrity`	Gibt an, dass DCOM eine Authentifizierung durchführt und sicherstellt, dass die zwischen Client und Server übertragenen Daten nicht verändert wurden.
6	`PktPrivacy`	Gibt an, dass DCOM alle vorherigen Ebenen authentifiziert und den Argumentwert jedes Remoteprozeduraufrufs verschlüsselt.

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die ComImpersonationLevel Eigenschaft angezeigt. Der Standardwert ist 4 (Impersonate).

Wert	Schlüsselwort	Beschreibung
0	`Default`	Gibt an, dass DCOM die Identitätsebene mithilfe des normalen Algorithmus zur Sicherheitsaushandlung festlegt.
1	`Anonymous`	Gibt an, dass der Client für den Server anonym ist. Der Server kann die Identität des Clients annehmen, doch das Identitätstoken enthält keine Informationen. In der .NET Framework-Version 1.1 wird `Anonymous` nicht unterstützt.
2	`Delegate`	Gibt an, dass der Serverprozess den Sicherheitskontext für den Client imitieren kann, wenn der Server im Auftrag des Clients fungiert. Der Serverprozess kann auch das Klonen verwenden, um ausgehende Anrufe an andere Server zu tätigen, wenn der Server im Auftrag des Clients fungiert. Der Server kann den Sicherheitskontext des Clients auf anderen Computern verwenden, um als Client auf lokale und Remoteressourcen zuzugreifen. Wenn der Prozess auf dieser Ebene die Identität des Clients annimmt, kann das Identitätstoken über beliebige viele Computer hinweg übermittelt werden.
3	`Identify`	Gibt an, dass der Server die Identität für den Client abrufen kann. Der Server kann die Identität des Clients annehmen, um eine ACL-Überprüfung (Überprüfung der Zugriffssteuerungsliste) durchzuführen. Er kann jedoch nicht als Client auf die Systemobjekte zugreifen.
4	`Impersonate`	Gibt an, dass der Serverprozess den Sicherheitskontext für den Client imitieren kann, wenn der Server im Auftrag des Clients fungiert. Der Server kann diese Identitätswechselstufe verwenden, um auf lokale Ressourcen zuzugreifen, z. B. Dateien. Wenn der Prozess auf dieser Ebene die Identität des Clients annimmt, kann das Identitätstoken über nur einen Computer hinweg übermittelt werden.

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die LogLevel Eigenschaft angezeigt. Der Standardwert ist 2 (Errors).

Wert	Schlüsselwort	Beschreibung
0	`None`	Gibt an, dass keine Ereignisse protokolliert werden.
1	`All`	Gibt an, dass alle Prozessereignisse protokolliert werden.
2	`Errors`	Gibt an, dass nur unerwartetes Herunterfahren, Speicherlimitherunterfahren und Deadlock-Herunterfahren protokolliert werden.

Vererbungshierarchie

ConfigurationSection

ProcessModelSection

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

ConfigurationSection-Klasse
processModel-Element (ASP.NET Settings Schema)
CIM_DATETIME

Freigeben über