Hinzufügen von Anwendungspools <hinzufügen>

Übersicht

Das <add> Element des <applicationPools> Elements steuert die Konfigurationseinstellungen für einen IIS 7- und höher-Anwendungspool. Sie erstellen ein <add> Element in der ApplicationHost.config-Datei für jeden Anwendungspool, den Sie auf Ihrem IIS-Server ausführen möchten.

Das <add> Element kann Attribute und untergeordnete Elemente enthalten, die den Pipelineverarbeitungsmodus und die Version von .NET Framework konfigurieren, die die Arbeitsprozesse im Anwendungspool für eingehende Anforderungen verwenden. Dieses Element enthält auch untergeordnete Elemente, die Anwendungspool-Identitäts-, Leistungs- und Integritäts- und Recycling-Anwendungspooleinstellungen konfigurieren.

Wenn Sie einen neuen Anwendungspool in IIS 7 und höher erstellen, müssen Sie mindestens dem Anwendungspool einen eindeutigen Namen zuweisen. Konfigurieren Sie alle anderen Eigenschaften nach Bedarf für die Anwendungen, die den Anwendungspool verwenden.

Neu in IIS 7.5 und höher

Ab IIS 7.5 können Sie eine Anwendung so konfigurieren, dass sie automatisch gestartet wird, indem Sie die Attribute managedRuntimeLoader, CLRConfigFile und startMode des <add> Elements verwenden. Diese Attribute konfigurieren den Namen der verwalteten DLL, die das Laden der Laufzeit für Ihre Anwendung, die Konfigurationsdatei für die Common Language Runtime für die Anwendung und den Starttyp für die Anwendung bereitstellt.

Auch neu in IIS 7.5 und höher ist ein neuer ApplicationPoolIdentity Typ für das Attribut IdentityType des <processModel> Elements. Dieser neue Identitätstyp ist jetzt die Standardprozessidentität für Anwendungen und ermöglicht es, die Sicherheit für Ihre Inhaltsbereiche festzulegen, um den Zugriff für einen bestimmten Anwendungspool zu ermöglichen. Dazu legen Sie Ihre Sicherheit mithilfe des Namens eines Anwendungspools mithilfe von Syntax wie „IIS AppPool\DefaultAppPool“ fest. Diese Identität wird dynamisch erstellt, wodurch der Angriffsbereich des Servers erheblich reduziert wird.

Kompatibilität

Setup

Die Sammlung <applicationPools> ist in der Standardinstallation von IIS 7 und höher enthalten.

Gewusst wie

Erstellen eines neuen Anwendungspools

1. Öffnen Sie den Internet Information Services (IIS) Manager:

   • Wenn Sie Windows Server 2012 oder Windows Server 2012 R2 verwenden:

     • Klicken Sie der der Taskleiste auf Server-Managerdann auf Toolsund dann auf den Internet Information Services (IIS) Manager.

   • Wenn Sie Windows 8 oder Windows 8.1 verwenden:

     • Halten Sie die Windows-Taste gedrückt, drücken Sie den Buchstaben X, und klicken Sie dann auf "Systemsteuerung".
     • Klicken Sie auf Verwaltungund doppelklicken Sie dann auf den Internet Information Services (IIS) Manager.

   • Wenn Sie Windows Server 2008 oder Windows Server 2008 R2 verwenden:

     • Klicken Sie auf der Taskleiste auf Start, zeigen Sie auf Verwaltungund dann auf den Internet Information Services (IIS) Manager.

   • Wenn Sie Windows Vista oder Windows 7 verwenden:

     • Klicken Sie auf der Taskleiste auf "Start" und dann auf "Systemsteuerung".
     • Doppelklicken Sie auf Verwaltungund doppelklicken Sie dann auf den Internet Information Services (IIS) Manager.

2. Erweitern Sie im Bereich Verbindungen den Servernamen und klicken Sie dann auf Anwendungspools.

3. Klicken Sie im Bereich Aktionen auf Anwendungspool hinzufügen ....

4. Geben Sie im Dialogfeld Anwendungspool hinzufügen den Namen des Anwendungspools in das Feld Name: ein, wählen Sie in der Dropdownliste .NET Framework-Version: die .NET Framework-Version aus, die Ihre Website oder Anwendung verwendet, wählen Sie in der Dropdownliste Verwendete-Pipeline-Modus: Integriert oder Klassisch aus, und klicken Sie dann auf "OK".
   

Konfigurieren des Anwendungspools für eine vorhandene Site oder eine vorhandene Anwendung

1. Erweitern Sie im Bereich VerbindungenSites, und navigieren Sie dann zur Site oder Anwendung, die Sie dem Anwendungspool hinzufügen möchten.
2. Klicken Sie im Bereich Aktionen auf Erweiterte Einstellungen ...
3. Klicken Sie im Abschnitt Allgemein des Dialogfelds Erweiterte Einstellungen auf den Eintrag Anwendungspool, und klicken Sie dann auf die Schaltfläche mit den Auslassungspunkten.
   
4. Wählen Sie im Dialogfeld Anwendungspool auswählen den Anwendungspool aus dem Dropdownfeld Anwendungspool:, klicken Sie auf OK, und klicken Sie dann erneut auf OK ".
   

Konfiguration

Das Element <add> der Sammlung <applicationPools> kann auf Serverebene in der Datei ApplicationHost.config konfiguriert werden.

Attribute

Untergeordnete Elemente

Konfigurationsbeispiel

Im folgenden Konfigurationsbeispiel wird das Anwendungspoolelement <add> verwendet, um einen neuen Anwendungspool namens Contoso zu erstellen. Das Element <recycling> konfiguriert die Protokollierung für den Neustart des Anwendungspools, das Element <periodicRestart> konfiguriert, wann der Anwendungspool neu gestartet wird, und das Element <processModel> konfiguriert die Attribute shutdownTimeLimit und startupTimeLimit für das Herunterfahren und Starten der Arbeitsprozesse im Anwendungspool für jeweils 30 Sekunden. Wenn diese Zeitlimits überschritten werden, beendet IIS den Arbeitsprozess.

<add name="Contoso">
   <recycling logEventOnRecycle="Schedule">
      <periodicRestart>
         <schedule>
            <clear />
            <add value="03:00:00" />
         </schedule>
      </periodicRestart>
   </recycling>
   <processModel identityType="NetworkService" shutdownTimeLimit="00:00:30" startupTimeLimit="00:00:30" />
</add>

Beispielcode

Die folgenden Codebeispiele fügen einen Anwendungspool namens Contoso zu Ihrem IIS 7- und höher-Server hinzu, und legen dann den Anwendungspool zum täglichen Wiederverwenden um 3:00 Uhr fest.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/applicationPools /+"[name='Contoso']" /commit:apphost

appcmd.exe set config -section:system.applicationHost/applicationPools /+"[name='Contoso'].recycling.periodicRestart.schedule.[value='03:00:00']" /commit:apphost

Sie können auch die folgende Syntax verwenden:

appcmd.exe add apppool /name:"Contoso"

appcmd.exe set config -section:system.applicationHost/applicationPools /+"[name='Contoso'].recycling.periodicRestart.schedule.[value='03:00:00']" /commit:apphost

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 applicationPoolsSection = config.GetSection("system.applicationHost/applicationPools");
         ConfigurationElementCollection applicationPoolsCollection = applicationPoolsSection.GetCollection();
         ConfigurationElement addElement = applicationPoolsCollection.CreateElement("add");
         addElement["name"] = @"Contoso";
         ConfigurationElement recyclingElement = addElement.GetChildElement("recycling");
         ConfigurationElement periodicRestartElement = recyclingElement.GetChildElement("periodicRestart");
         ConfigurationElementCollection scheduleCollection = periodicRestartElement.GetCollection("schedule");
         ConfigurationElement addElement1 = scheduleCollection.CreateElement("add");
         addElement1["value"] = TimeSpan.Parse("03:00:00");
         scheduleCollection.Add(addElement1);
         applicationPoolsCollection.Add(addElement);
         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 applicationPoolsSection As ConfigurationSection = config.GetSection("system.applicationHost/applicationPools")
      Dim applicationPoolsCollection As ConfigurationElementCollection = applicationPoolsSection.GetCollection
      Dim addElement As ConfigurationElement = applicationPoolsCollection.CreateElement("add")
      addElement("name") = "Contoso"
      Dim recyclingElement As ConfigurationElement = addElement.GetChildElement("recycling")
      Dim periodicRestartElement As ConfigurationElement = recyclingElement.GetChildElement("periodicRestart")
      Dim scheduleCollection As ConfigurationElementCollection = periodicRestartElement.GetCollection("schedule")
      Dim addElement1 As ConfigurationElement = scheduleCollection.CreateElement("add")
      addElement1("value") = TimeSpan.Parse("03:00:00")
      scheduleCollection.Add(addElement1)
      applicationPoolsCollection.Add(addElement)
      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var applicationPoolsSection = adminManager.GetAdminSection("system.applicationHost/applicationPools", "MACHINE/WEBROOT/APPHOST");
var applicationPoolsCollection = applicationPoolsSection.Collection;

var addElement = applicationPoolsCollection.CreateNewElement("add");
addElement.Properties.Item("name").Value = "Contoso";
var recyclingElement = addElement.ChildElements.Item("recycling");
var periodicRestartElement = recyclingElement.ChildElements.Item("periodicRestart");
var scheduleCollection = periodicRestartElement.ChildElements.Item("schedule").Collection;
var addElement1 = scheduleCollection.CreateNewElement("add");
addElement1.Properties.Item("value").Value = "03:00:00";
scheduleCollection.AddElement(addElement1);
applicationPoolsCollection.AddElement(addElement);

adminManager.CommitChanges();

VBScript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set applicationPoolsSection = adminManager.GetAdminSection("system.applicationHost/applicationPools", "MACHINE/WEBROOT/APPHOST")
Set applicationPoolsCollection = applicationPoolsSection.Collection

Set addElement = applicationPoolsCollection.CreateNewElement("add")
addElement.Properties.Item("name").Value = "Contoso"
Set recyclingElement = addElement.ChildElements.Item("recycling")
Set periodicRestartElement = recyclingElement.ChildElements.Item("periodicRestart")
Set scheduleCollection = periodicRestartElement.ChildElements.Item("schedule").Collection
Set addElement1 = scheduleCollection.CreateNewElement("add")
addElement1.Properties.Item("value").Value = "03:00:00"
scheduleCollection.AddElement(addElement1)
applicationPoolsCollection.AddElement(addElement)

adminManager.CommitChanges()