Partager via

ApplicationPool, classe1

  • Article

Représente un pool d’applications IIS.

Syntaxe

class ApplicationPool : Object

Méthodes

Le tableau suivant répertorie les méthodes exposées par la classe ApplicationPool.

Nom Description
Créer Crée un pool d’applications.
GetState Retourne l’état d’exécution d’un pool d’applications.
Recyclage Recycle un pool d’applications.
RevertToParent Rétablit la valeur ou les valeurs de configuration d’un pool d’applications à celles de son pool d’applications parent.
Démarrer Démarre un pool d’applications.
Stop Arrête un pool d’applications.

Propriétés

Le tableau suivant répertorie les propriétés exposées par la classe ApplicationPool.

Nom Description
AutoStart Une valeur boolean en lecture/écriture. true si le service WWW (World Wide Web Publishing Service) démarre automatiquement le pool d’applications lors de la création du pool d’applications ou lors du démarrage d’IIS ; sinon, false. Par défaut, il s’agit de true.
Cpu Objet ApplicationPoolProcessorSettings qui contient les paramètres processeur d’un pool d’applications.
Enable32BitAppOnWin64 Une valeur boolean en lecture/écriture. true si les applications 32 bits (gérées et natives) peuvent s’exécuter sur des versions 64 bits de Windows ; sinon, false. Par défaut, il s’agit de false.
Failure Objet ApplicationPoolFailureSettings qui définit les propriétés qui déterminent les actions à entreprendre lorsqu’un pool d’applications ou un processus de travail échoue.
ManagedPipelineMode Valeur de sint32 en lecture/écriture qui indique le mode de pipeline managé. Les valeurs possibles sont répertoriées dans la section Remarques.
ManagedRuntimeVersion Valeur de string en lecture/écriture qui contient la version du Common Language Runtime (CLR) préchargée par le pool d’applications. La valeur par défaut est « v2.0 ». Si la propriété est écrite, IIS recycle le pool d’applications et charge la version nouvellement spécifiée du .NET Framework pour celle-ci.
Name Valeur string en lecture seule qui contient le nom unique du pool d’applications. Propriété de clé. La longueur maximale est de 64 caractères. Les espaces et les périodes sont autorisés, mais les caractères suivants ne peuvent pas être utilisés :

& / \ : * ? | " <> [ ] + = ; , @
PassAnonymousToken Une valeur boolean en lecture/écriture. true si le service d’activation des processus Windows (WAS) crée et transmet un jeton pour le compte d’utilisateur anonyme IUSR intégré au module d’authentification anonyme ; sinon, false. Par défaut, il s’agit de true.

Le module d’authentification anonyme utilise le jeton pour emprunter l’identité du compte intégré. Lorsque PassAnonymousToken est false, le jeton ne sera pas passé. Remarque : le compte d’utilisateur anonyme IUSR remplace le compte anonyme IIS_MachineName. Le compte IUSR peut être utilisé par IIS ou d’autres applications. Il n’a pas de privilèges qui lui sont attribués pendant l’installation.
ProcessModel Objet ProcessModelSettings qui définit les paramètres de configuration pour les processus de travail IIS.
QueueLength Valeur de uint32 en lecture/écriture qui indique le nombre de demandes que HTTP.sys met en file d’attente pour un pool d’applications avant de rejeter d’autres demandes. La valeur par défaut est 1000. Lorsque la limite est dépassée, HTTP.sys rejette des requêtes supplémentaires avec une erreur 503 (service indisponible).
Recycling Objet RecyclingSettings qui définit les paramètres de configuration de recyclage pour les pools d’applications et les processus de travail.

Sous-classes

Cette classe ne contient aucune sous-classe.

Notes

Un pool d’applications est un groupe d’une ou plusieurs URL qui sont prises en charge par un processus de travail ou un ensemble de processus de travail. Les pools d’applications définissent des limites pour les applications qu’ils contiennent, ce qui signifie que toutes les applications qui s’exécutent en dehors d’un pool d’applications spécifié ne peuvent pas affecter les applications au sein de ce pool d’applications.

Si une application managée s’exécute dans un pool d’applications en mode intégré, le serveur utilise les pipelines de traitement des requêtes intégrés d’IIS et ASP.NET pour traiter la requête. Toutefois, si une application managée s’exécute dans un pool d’applications en mode ISAPI, le serveur continue d’acheminer les demandes de code managé via Aspnet_isapi.dll et de traiter les demandes comme s’ils étaient en cours d’exécution dans IIS 6.0.

La plupart des applications managées doivent s’exécuter correctement dans des pools d’applications en mode intégré, mais vous devrez peut-être exécuter des applications en mode ISAPI pour des raisons de compatibilité. Testez d’abord les applications en mode intégré pour déterminer si vous avez vraiment besoin du mode ISAPI.

Le tableau suivant répertorie les valeurs possibles pour la propriété ManagedPipelineMode. La valeur par défaut est 0 (Integrated).

Valeur Mot clé Description
0 Integrated Le pipeline managé s’exécute en mode intégré.
1 Classic Le pipeline managé s’exécute en mode ISAPI.

Exemple

L’exemple suivant affiche le nom et le mode (intégré ou ISAPI) des pools d’applications sur un serveur.

' 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

Hiérarchie d'héritage

Object

Application Pool

Spécifications

Type Description
Client - IIS 7.0 sur Windows Vista
- IIS 7.5 sous Windows 7
- IIS 8.0 sous Windows 8
- IIS 10.0 sous Windows 10
Serveur - IIS 7.0 sur Windows Server 2008
- IIS 7.5 sur Windows Server 2008 R2
- IIS 8.0 sur Windows Server 2012
- IIS 8.5 sur 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 d’objets
Configuration des pools d’applications dans IIS 7.0