Classe ProcessModelSection
Configure les paramètres du modèle de processus ASP.NET sur un serveur web qui exécute IIS.
Syntaxe
class ProcessModelSection : ConfigurationSection
Méthodes
Le tableau suivant répertorie les méthodes exposées par la classe ProcessModelSection.
| Nom | Description |
|---|---|
| GetAllowDefinition | (Hérité de ConfigurationSection.) |
| GetAllowLocation | (Hérité de ConfigurationSection.) |
| 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 ProcessModelSection.
| Nom | Description |
|---|---|
AutoConfig |
Une valeur boolean de lecture/écriture. true si ASP.NET configure automatiquement certains attributs pour obtenir des performances optimales basées sur la configuration de l'ordinateur ; false si ASP.NET utilise les valeurs définies explicitement pour les attributs. Par défaut, il s’agit de false. Les attributs configurés sont répertoriés plus loin dans la section Remarques. Remarque : ces attributs affectent uniquement les applications ASP.NET, et non les applications clientes .NET Framework. Remarque : la valeur par défaut de cette propriété dans le fichier Machine.config est true, ce qui remplace les paramètres dans les fichiers de configuration inférieurs. Si vous supprimez l'entrée autoConfig de Machine.config, la valeur par défaut est rétablie sur false. |
ClientConnectedCheck |
Valeur datetime de lecture/écriture qui spécifie la durée pendant laquelle une requête est laissée dans la file d'attente avant ASP.NET effectue une vérification pour déterminer si le client est connecté. La valeur par défaut est 5 secondes. |
ComAuthenticationLevel |
Valeur sint32 de lecture/écriture qui spécifie le niveau d'authentification pour la sécurité DCOM. Les valeurs possibles sont répertoriées plus loin dans la section Remarques. |
ComImpersonationLevel |
Valeur sint32 de lecture/écriture qui spécifie le niveau d'authentification pour la sécurité COM. Les valeurs possibles sont répertoriées plus loin dans la section Remarques. |
CpuMask |
Valeur sint32 de lecture/écriture qui spécifie les processeurs (CPU) sur un serveur multiprocesseur qui sont qualifiés pour exécuter des processus ASP.NET. La valeur par défaut est 0xffffffff.Cette valeur spécifie un modèle de bit qui indique les processeurs qualifiés pour exécuter les threads ASP.NET. Par exemple, la valeur hexadécimale 0x0d représente le modèle de bit 1101. Sur un ordinateur doté de quatre processeurs, les processus ASP.NET peuvent être planifiés sur les processeurs 0, 2 et 3, mais pas sur le processeur 1. ASP.NET démarre un processus de travail pour chaque processeur qualifié. Si la propriété WebGarden est true, CpuMask limite les processus de travail au nombre de processeurs qualifiés. Le nombre maximal de processus de travail est égal au nombre de processeurs. Si la propriété WebGarden est false (la valeur par défaut), CpuMask est ignorée et un seul processus de travail s'exécute. |
Enable |
Une valeur boolean de lecture/écriture. true si le modèle de processus est activé. Sinon, false. Par défaut, il s’agit de true. |
IdleTimeout |
Valeur datetime de lecture/écriture qui spécifie la période d'inactivité après laquelle ASP.NET met automatiquement fin au processus de travail. La valeur par défaut est infini. |
Location |
(Hérité de ConfigurationSection.) Une propriété clé. |
LogLevel |
Valeur sint32 de lecture/écriture qui spécifie les types d'événements à écrire dans le journal des événements. Les valeurs possibles sont répertoriées plus loin dans la section Remarques. |
MaxAppDomains |
Valeur sint32 de lecture/écriture qui spécifie le nombre maximal de domaines d'application autorisés dans un processus. Cet attribut doit être inférieur ou égal à 2 000. La valeur par défaut est 2000. |
MaxIOThreads |
Valeur sint32 de lecture/écriture qui spécifie le nombre maximal de threads d'E/S (de 5 à 100) à utiliser pour le processus par processeur. Valeur par défaut : 20.Par exemple, si cette valeur est de 25 sur un serveur à processeur unique, ASP.NET fixe la limite de processus à 25. Sur un serveur à deux processeurs, ASP.NET définit la limite de 50. La valeur de cette propriété doit être égale ou supérieure à la propriété MinFreeThread de la classe HttpRuntimeSection. |
MaxWorkerThreads |
Valeur sint32 de lecture/écriture qui spécifie le nombre maximal de threads de travail (de 5 à 100) à utiliser pour le processus par processeur. Valeur par défaut : 20.Par exemple, si cette valeur est de 25 sur un serveur à processeur unique, ASP.NET utilise les API d'exécution pour fixer la limite de processus à 25. Sur un serveur à deux processeurs, ASP.NET définit la limite de 50. La valeur de cette propriété doit être égale ou supérieure à la MinFreeThread propriété de la HttpRuntimeSection classe. |
MemoryLimit |
Valeur sint32 de lecture/écriture qui spécifie la taille de mémoire maximale autorisée, sous la forme d'un pourcentage de mémoire système totale, que le processus de travail peut consommer avant que ASP.NET démarre un nouveau processus et réaffecte les requêtes existantes. La valeur par défaut est 60. |
MinIOThreads |
Valeur sint32 de lecture/écriture qui spécifie le nombre minimal de threads d'E/S à utiliser pour le processus par processeur. La valeur par défaut est 1. |
MinWorkerThreads |
Valeur sint32 de lecture/écriture qui spécifie le nombre maximal de threads de travail à utiliser pour le processus par processeur. La valeur par défaut est 1. |
Password |
Valeur string de lecture/écriture (le cas échéant) qui permet, avec la propriété UserName, au processus de travail de s'exécuter avec l'identité Microsoft Windows configurée. La valeur par défaut est « AutoGenerate ». Remarque : consultez la propriété UserName pour plus d'informations à propos des noms spéciaux « System » et « Machine », qui ne nécessitent pas de mot de passe et pour plus d'informations à propos du stockage des informations d'identification de processus de travail chiffrées dans le Registre. |
Path |
(Hérité de ConfigurationSection.) Une propriété clé. |
PingFrequency |
Valeur datetime de lecture/écriture qui spécifie l'intervalle de temps auquel l'extension ISAPI effectue un test ping sur le processus de travail pour déterminer si le processus est en cours d'exécution. La valeur par défaut est infini.Si le processus de travail ne répond pas à l'intervalle spécifié par la propriété PingTimeout, il est redémarré. |
PingTimeout |
Valeur datetime de lecture/écriture qui spécifie l'intervalle de temps après lequel un processus de travail qui a cessé de répondre est redémarré. La valeur par défaut est infini.Les extensions ISAPI effectuent un test ping sur le processus de travail à l'intervalle spécifié par la propriété PingFrequency. Si le processus de travail ne répond pas à l'intervalle spécifié par la propriété PingTimeout, il est redémarré. |
RequestLimit |
Valeur sint32 de lecture/écriture qui spécifie le nombre de requêtes autorisées avant que ASP.NET démarre automatiquement un nouveau processus de travail à la place de celui en cours. La valeur par défaut est 2147483647. |
RequestQueueLimit |
Valeur sint32 de lecture/écriture qui spécifie le nombre de requêtes autorisées dans la file d'attente avant que ASP.NET retourne le message « 503 – Serveur trop occupé » aux nouvelles requêtes. L'option par défaut est 5 000. |
ResponseDeadlockInterval |
Valeur datetime de lecture/écriture qui spécifie l'intervalle de temps après lequel le processus est redémarré s'il existe des requêtes en file d'attente et en cas de réponse pendant l'intervalle spécifié. La valeur par défaut est 3 minutes. |
ResponseRestartDeadlockInterval |
Valeur datetime de lecture/écriture, fournie pour la compatibilité descendante, qui spécifie l'intervalle de temps après lequel le processus est redémarré s'il existe des requêtes en file d'attente et en cas de réponse pendant l'intervalle spécifié. La valeur par défaut est 3 minutes. Remarque : ASP.NET n'utilise plus cette propriété ; elle est fournie uniquement pour la compatibilité descendante. Cette propriété n'entraîne pas d'erreur de configuration si elle est déjà présente dans un fichier de configuration. La propriété ResponseDeadlockInterval contrôle désormais le redémarrage des processus bloqués. |
RestartQueueLimit |
Valeur sint32 de lecture/écriture qui spécifie le nombre maximal de requêtes que IIS met en file d'attente pendant qu'elle attend que le processus de travail redémarre après un arrêt non standard. Ce paramètre ne s'applique pas à un arrêt propre ou à un redémarrage standard. La valeur par défaut est de 10. |
SectionInformation |
(Hérité de ConfigurationSection.) |
ServerErrorMessageFile |
Valeur string de lecture/écriture qui spécifie le contenu d'un fichier à utiliser au lieu du message par défaut « Serveur indisponible » si un serveur cesse de répondre de façon inattendue. L'emplacement du fichier est relatif au fichier Machine.config, ou il peut s'agir d'un chemin d'accès absolu. Si vous ne spécifiez pas cette valeur de propriété, IIS utilise le message par défaut « Serveur indisponible ». |
ShutdownTimeout |
Valeur datetime de lecture/écriture qui spécifie la durée d'arrêt du processus de travail. La valeur par défaut est 5 secondes. À l'expiration du délai, ASP.NET ferme le processus de travail. |
Timeout |
Valeur datetime de lecture/écriture qui spécifie le nombre de minutes jusqu'à ce que ASP.NET démarre un nouveau processus de travail à la place de celui en cours. La valeur par défaut est infini. |
UserName |
Valeur string de lecture/écriture qui spécifie que ASP.NET exécutera le processus de travail avec une identité Windows qui diffère de l'identité de processus par défaut. La valeur par défaut est « Machine ». Par défaut, le processus s'exécute sous un compte d'utilisateur et un mot de passe créés automatiquement à l'installation de ASP.NET. Le compte d'utilisateur est nommé ASPNET et le mot de passe est généré par chiffrement.Si des informations d'identification valides sont présentées dans les propriétés UserName et Password, le processus est exécuté avec le compte donné. Si la valeur UserName est « System » et que la valeur Password est « AutoGenerate », le processus s'exécute avec des autorisations d'administration complètes pour tous les codes ASP.NET qui utilisent le processus. Remarque : les valeurs de cette propriété et de la propriété Password sont stockées en texte clair dans le fichier de configuration. Bien que IIS ne transmette pas de fichiers .config en réponse à une requête de l'agent utilisateur, les fichiers de configuration peuvent être lus d'autres manières. Par exemple, un utilisateur authentifié disposant des informations d'identification requises sur le domaine du serveur peut lire un fichier de configuration. Pour des raisons de sécurité, la classe ProcessModelSection prend en charge le stockage des propriétés chiffréesUserName et Password dans le Registre. Pour plus d'informations, consultez l'Élément processModel (schéma de paramètres ASP.NET). |
WebGarden |
Une valeur boolean de lecture/écriture. true si la propriété CpuMask est utilisée pour spécifier les processeurs qualifiés pour exécuter des processus ASP.NET ; false si un seul processus de travail est exécuté et que l'utilisation du processeur est planifiée par le système d'exploitation Windows. Par défaut, il s’agit de false. Remarque : un serveur web multiprocesseur est appelé jardin web. |
Sous-classes
Cette classe ne contient aucune sous-classe.
Notes
Cette section <processModel> ne peut être définie que dans le fichier Machine.config et affecte toutes les applications ASP.NET exécutées sur le serveur.
Remarque
Les modifications apportées à la classe ProcessModelSection prennent effet uniquement lorsque le processus de travail est redémarré, et non immédiatement après la modification du paramètre.
Le tableau suivant répertorie les attributs qui sont automatiquement configurés lorsque la propriété AutoConfig est true. Pour plus d'informations, consultez l'article 821268, « Contention, performances médiocres et blocages lorsque vous initiez des requêtes de service web à partir d'applications ASP.NET », dans la Base de connaissances Microsoft à https://support.microsoft.com.
| Attribut | Description |
|---|---|
maxWorkerThreads |
Spécifie le nombre maximal de threads de travail par processeur que ASP.NET utilise. |
maxIoThreads |
Spécifie le nombre maximal de threads d'achèvement par processeur que ASP.NET utilise. |
minFreeThreads |
Correspond à la propriété MinFreeThreads de la classe HttpRuntimeSection. |
minLocalRequestFreeThreads |
Correspond à la propriété MinLocalRequestFreeThreads de la classe HttpRuntimeSection. |
maxConnection |
Correspond à la propriété MaxConnection de la classe ConnectionManagementElement. |
Le tableau suivant répertorie les valeurs possibles pour la propriété ComAuthenticationLevel. La valeur par défaut est 2 (Connect).
| Valeur | Mot clé | Description |
|---|---|---|
| 0 | None |
Spécifie l'absence d'authentification. |
| 1 | Call |
Spécifie que DCOM authentifie les informations d’identification du client quand le serveur reçoit la demande au début de chaque appel de procédure distante. |
| 2 | Connect |
Spécifie que DCOM n'authentifie les informations d'identification du client que lorsque celui-ci établit une connexion avec le serveur. |
| 3 | Default |
Spécifie que DCOM détermine le niveau d'authentification en utilisant son algorithme de négociation de sécurité standard. |
| 4 | Pkt |
Spécifie que DCOM authentifie que toutes les données reçues proviennent du client attendu. Les transports de datagrammes utilisent toujours l'authentification Pkt. |
| 5 | PktIntegrity |
Spécifie que DCOM authentifie et vérifie qu'aucune des données transférées entre le client et le serveur n'est modifiée. |
| 6 | PktPrivacy |
Spécifie que DCOM authentifie tous les niveaux précédents et chiffre la valeur d’argument de chaque appel de procédure distante. |
Le tableau suivant répertorie les valeurs possibles pour la propriété ComImpersonationLevel. La valeur par défaut est 4 (Impersonate).
| Valeur | Mot clé | Description |
|---|---|---|
| 0 | Default |
Spécifie que DCOM détermine le niveau d'emprunt d'identité en utilisant son algorithme de négociation de sécurité standard. |
| 1 | Anonymous |
Spécifie que le client est anonyme sur le serveur. Le serveur peut emprunter l’identité du client, mais le jeton d’emprunt d’identité ne contiendra pas d’informations. Anonymous n'est pas pris en charge dans la version 1.1 de .NET Framework. |
| 2 | Delegate |
Spécifie que le processus serveur peut emprunter l'identité du contexte de sécurité du client lorsque le serveur agit au nom du client. Le processus serveur peut également utiliser le masquage pour effectuer des appels sortants vers d'autres serveurs lorsque le serveur agit au nom du client. Le serveur peut utiliser le contexte de sécurité du client sur d'autres ordinateurs pour accéder aux ressources locales et distantes en tant que client. Lorsque le serveur emprunte une identité à ce niveau, le jeton d'emprunt d'identité peut être transmis à travers n'importe quel nombre de limites informatiques. |
| 3 | Identify |
Spécifie que le serveur peut obtenir l'identité du client. Le serveur peut emprunter l’identité du client pour vérifier la liste de contrôle d’accès (ACL), mais il ne peut pas accéder aux objets système en tant que client. |
| 4 | Impersonate |
Spécifie que le processus serveur peut emprunter l'identité du contexte de sécurité du client lorsque le serveur agit au nom du client. Le serveur peut utiliser ce niveau d'emprunt d'identité pour accéder aux ressources locales, comme les fichiers. Lorsque le serveur procède à un emprunt d'identité à ce niveau, le jeton d'emprunt d'identité ne peut être transmis qu'à travers une seule limite informatique. |
Le tableau suivant répertorie les valeurs possibles pour la propriété LogLevel. La valeur par défaut est 2 (Errors).
| Valeur | Mot clé | Description |
|---|---|---|
| 0 | None |
Spécifie qu'aucun événement n'est enregistré. |
| 1 | All |
Spécifie que tous les événements de processus sont enregistrés. |
| 2 | Errors |
Spécifie que seuls les arrêts inattendus, les arrêts de limite de mémoire et les arrêts de blocage sont enregistrés. |
Hiérarchie d'héritage
ProcessModelSection
Spécifications
| Type | Description |
|---|---|
| Client | - IIS 7.0 sous 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 sous Windows Server 2012 - IIS 8.5 sous 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 |