Classe d’application1

Article
03/19/2024

Représente une application Web IIS.

Syntaxe

class Application : ConfiguredObject

Méthodes

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

Nom	Description
Créer	Crée une application Web.
GetSection	(Hérité de ConfigureObject.)
GetAllSections	(Hérité de ConfigureObject.)
RevertToParent	Rétablit la valeur ou les valeurs de configuration d’une application par défaut.

Propriétés

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

Nom	Description
`ApplicationPool`	Valeur de `string` en lecture/écriture qui spécifie un nom sensible à la casse pour le pool d’applications d’une application. La valeur par défaut est« DefaultAppPool ».
`EnabledProtocols`	Tableau de `string` en lecture/écriture qui spécifie les protocoles que les demandes peuvent utiliser pour accéder à une application. La valeur« HTTP » ou« HTTPS » active HTTP et HTTPS. Si ni« HTTP » ni« HTTPS » n’est spécifié, aucune n’est activée pour l’application. La valeur par défaut est « HTTP ». Pour accepter uniquement les requêtes HTTPS, configurez la fonctionnalité SSL (Secure Sockets Layer) pour le site.
`Path`	Valeur `string` en lecture seule qui spécifie le chemin d’accès virtuel de l’application après l’en-tête de l’hôte. Par exemple, si vous avez une application à http://www.alpineskihouse.com/Skis/Downhill, la propriété `Path` est /Skis/Downhill. Une propriété clé.
`SiteName`	Valeur `string` en lecture seule qui spécifie le nom unique du site Web. Une propriété clé.
`VirtualDirectoryDefaults`	Un objet VirtualDirectoryElementDefaults dont les propriétés en lecture/écriture spécifient des valeurs par défaut pour les répertoires virtuels sous l’application.

Sous-classes

Cette classe ne contient aucune sous-classe.

Notes

Une application Web est un regroupement de contenu au niveau racine d'un site Web ou un regroupement de contenu dans un dossier séparé sous le répertoire racine du site Web. La classe Application vous permet de spécifier des propriétés spécifiques à une application particulière, telles que le pool d’applications dans lequel l’application s’exécutera.

Exemple

L’exemple suivant affecte l’application Northwind à un pool d’applications nommé NewAppPool.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Retrieve the application and display its Web site name and path.  
Set oApp = oWebAdmin.Get(_   
"Application.SiteName='Default Web Site',Path='/Northwind'")  
WScript.Echo "Web site and path: '" & oApp.SiteName & oApp.Path & "'"  
WScript.Echo "Old application pool: " & oApp. ApplicationPool  
  
' Specify a new application pool name and save it.  
' Note that the name is case-sensitive.  
oApp.ApplicationPool = "NewAppPool"  
oApp.Put_  
  
' Display the new application pool name.  
WScript.Echo "New application pool: " & oApp.ApplicationPool

Remarque

Le nom du pool d’applications respecte la casse.

IIS ne vérifie pas si le pool d’applications spécifié existe réellement. Si le pool d’applications n’existe pas, l’utilisateur reçoit une erreur HTTP 403.18 avec le message« Impossible d’exécuter la requête spécifiée dans le pool d’applications configuré pour cette ressource sur le serveur Web ».

Pour définir le pool d’applications par défaut pour toutes les applications d’un site Web, utilisez la propriété ApplicationDefaults de la classe Site.

Hiérarchie d'héritage

ConfigureObject

Application

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

ApplicationElementDefaults Class
Classe ConfigureObject
Classe de site
VirtualDirectoryElementDefaults Class

Partager via