Application Defaults IIS <applicationDefaults>

Article
03/20/2024

Vue d’ensemble

L’élément <applicationDefaults> de <sites> spécifie les paramètres d’application par défaut pour toutes les applications sur le serveur.

Remarque

Si le même attribut ou élément enfant est configuré à la fois dans la section <applicationDefaults> et dans la section <application> d’une application spécifique, la configuration de la section <application> est utilisée pour cette application.

Compatibilité

Version	Notes
IIS 10.0	L’élément `<applicationDefaults>` n’a fait l’objet d’aucune modification dans IIS 10.0.
IIS 8.5	L’élément `<applicationDefaults>` n’a fait l’objet d’aucune modification dans IIS 8.5.
IIS 8.0	L’élément `<applicationDefaults>` n’a fait l’objet d’aucune modification dans IIS 8.0.
IIS 7.5	L’élément `<applicationDefaults>` n’a fait l’objet d’aucune modification dans IIS 7.5.
IIS 7.0	L’élément `<applicationDefaults>` de l’élément `<sites>` a été introduit dans IIS 7.0.
IIS 6.0	L’élément `<applicationDefaults>` est analogue à la définition des options d’application au niveau W3SVC dans la métabase IIS 6.0.

Programme d’installation

L’élément <applicationDefaults> de l’élément <sites> est inclus dans l’installation par défaut d’IIS 7 et versions ultérieures.

Procédure

Comment configurer les paramètres d’application par défaut pour un serveur

Ouvrez le Gestionnaire des services Internet (IIS) :
- Si vous utilisez Windows Server 2012 ou Windows Server 2012 R2 :
  - Dans la barre des tâches, cliquez sur Gestionnaire de serveur, cliquez sur Outils, puis sur Gestionnaire Internet Information Services (IIS).
- Si vous utilisez Windows 8 ou Windows 8.1 :
  - Maintenez la touche Windows enfoncée, appuyez sur la lettre X, puis cliquez sur Panneau de configuration.
  - Cliquez sur Outils d'administration, puis double-cliquez sur Gestionnaire des services Internet (IIS).
- Si vous utilisez Windows Server 2008 ou Windows Server 2008 R2 :
  - Cliquez sur Démarrer, placez le curseur sur Outils d'administration, puis cliquez sur Gestionnaire Internet Information Services (IIS).
- Si vous utilisez Windows Vista ou Windows 7 :
  - Dans la barre des tâches, cliquez sur Démarrer, puis sur Panneau de configuration.
  - Double-cliquez sur Outils d'administration, puis double-cliquez sur Gestionnaire des services Internet (IIS).
Dans le volet Connexions, développez le nom du serveur, puis cliquez sur le nœud Sites .
Dans le volet Sites du serveur, cliquez sur Définir les valeurs par défaut du site web... dans le volet Actions.
Dans la boîte de dialogue Paramètres par défaut du site web, spécifiez les paramètres d’application par défaut pour tous les sites Web, puis cliquez sur OK.

Configuration

Attributs

Attribut	Description
`applicationPool`	Attribut de chaîne facultatif. Spécifie le pool d’applications par défaut auquel toutes les applications sur le serveur sont affectées.
`enabledProtocols`	Attribut de chaîne facultatif. Spécifie les protocoles à utiliser pour communiquer avec toutes les applications sur le serveur.
`path`	Attribut de chaîne facultatif. Spécifie le chemin d’accès virtuel par défaut de toutes les applications sur le serveur.

Éléments enfants

Aucune.

Exemple Configuration

L’exemple de configuration suivant définit le pool d’applications par défaut pour tous les sites Web sur « DefaultAppPool ».

<system.applicationHost>
   <sites>
     <applicationDefaults applicationPool="DefaultAppPool" />
   </sites>
</system.applicationHost>

Exemple de code

Les exemples de code suivants définissent le pool d’applications par défaut pour tous les sites Web sur « DefaultAppPool ».

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites /applicationDefaults.applicationPool:"DefaultAppPool" /commit:apphost

Remarque

Vous devez veiller à définir le paramètre commit sur apphost quand vous utilisez AppCmd.exe pour configurer ces paramètres. Cela valide les paramètres de configuration dans la section d’emplacement appropriée dans le fichier ApplicationHost.config.

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetApplicationHostConfiguration();
         ConfigurationSection sitesSection = config.GetSection("system.applicationHost/sites");

         ConfigurationElement applicationDefaultsElement = sitesSection.GetChildElement("applicationDefaults");
         applicationDefaultsElement["applicationPool"] = @"DefaultAppPool";

         serverManager.CommitChanges();
     }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample

   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration
      Dim sitesSection As ConfigurationSection = config.GetSection("system.applicationHost/sites")

      Dim applicationDefaultsElement As ConfigurationElement = sitesSection.GetChildElement("applicationDefaults")
      applicationDefaultsElement("applicationPool") = "DefaultAppPool"

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST");

var applicationDefaultsElement = sitesSection.ChildElements.Item("applicationDefaults");
applicationDefaultsElement.Properties.Item("applicationPool").Value = "DefaultAppPool";

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST")

Set applicationDefaultsElement = sitesSection.ChildElements.Item("applicationDefaults")
applicationDefaultsElement.Properties.Item("applicationPool").Value = "DefaultAppPool"

adminManager.CommitChanges()

Partager via