App-Standardwerte <applicationDefaults>
Übersicht
Das Element <applicationDefaults> des Elements <site> Elements gibt die Standard-Anwendungseinstellungen für alle Anwendungen auf der übergeordneten Site an.
Hinweis
Wenn dasselbe Attribut oder untergeordnete Element sowohl im Abschnitt <applicationDefaults> als auch im Abschnitt <application> für eine bestimmte Anwendung konfiguriert ist, wird die Konfiguration im Abschnitt <application> für diese Anwendung verwendet.
Kompatibilität
| Version | Hinweise |
|---|---|
| IIS 10.0 | Das <applicationDefaults> Element wurde in IIS 10.0 nicht geändert. |
| IIS 8.5 | Das <applicationDefaults> Element wurde in IIS 8.5 nicht geändert. |
| IIS 8.0 | Das Attribut preLoadEnabled wurde in IIS 8.0 hinzugefügt. |
| IIS 7.5 | Das Element <applicationDefaults> wurde aktualisiert, um die Attribute serviceAutoStartEnabled und serviceAutoStartProvider einzuschließen. |
| IIS 7.0 | Das Element <applicationDefaults> der Sammlung <site> wurde in IIS 7.0 eingeführt. |
| IIS 6.0 | Das Element <applicationDefaults> entspricht dem Festlegen von Anwendungsoptionen auf Site-Ebene in der IIS 6.0-Metabasis. |
Setup
Das Element <applicationDefaults> des Elements <site> ist in der Standardinstallation von IIS 7 und höher enthalten.
Gewusst wie
Konfigurieren der Standard-Anwendungseinstellungen für eine Site
Ö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.
Erweitern Sie im Bereich Verbindungen den Servernamen, den Knoten Sites, und klicken Sie dann auf den Namen der Site.
Klicken Sie im Bereich Start der Site auf Anwendungen anzeigen im Bereich Aktionen.
Klicken Sie im Bereich Anwendung der Site auf Anwendungs-Standardwerte festlegen ... im Bereich Aktionen.
Geben Sie im Dialogfeld Anwendungs-Standardwerte Ihre Standard-Anwendungseinstellungen für die Site an, und klicken Sie dann auf OK.
Konfiguration
Attribute
| Attribut | Beschreibung |
|---|---|
applicationPool |
Optionales Zeichenfolgeattribut. Gibt den Standard-Anwendungspool an, dem alle Anwendungen der übergeordneten Site zugewiesen sind. |
enabledProtocols |
Optionales Zeichenfolgeattribut. Gibt die Protokolle an, die für die Kommunikation mit allen Anwendungen auf der übergeordneten Site verwendet werden sollen. |
path |
Optionales Zeichenfolgeattribut. Gibt den standardmäßigen virtuellen Pfad aller Anwendungen auf der übergeordneten Site an. |
preLoadEnabled |
Optionales boolesches Attribut. Gibt an, dass IIS eine Benutzeranforderung auf die Standardseite einer Anwendung oder eines virtuellen Verzeichnisses simuliert, sodass sie initialisiert wird. In der Tat startet IIS die Anwendung, wenn der Anwendungspool gestartet wird, ohne eine Anforderung erhalten zu haben. Dies erhöht die Leistung, indem Initialisierungsaufgaben ausgeführt werden, z. B. das Laden von verwalteten Modulen und das Kompilieren von verwaltetem Code. In den IIS-Protokollen wird kein Protokoll generiert. Die StartMode-Einstellung des Anwendungspools muss auf AlwaysRunning eingestellt sein.Der Standardwert ist False. |
serviceAutoStartEnabled |
Optionales boolesches Attribut. true, wenn der Autostart für diese Anwendung aktiviert ist; andernfalls false. Der Standardwert ist false. |
serviceAutoStartProvider |
Optionales Zeichenfolgeattribut. Gibt den Namen des Autostartanbieters an, den der Windows-Prozessaktivierungsdienst (WAS) verwendet, wenn serviceAutoStartEnabled auf true festgelegt ist.Es ist kein Standardwert vorhanden. |
Untergeordnete Elemente
Keine.
Konfigurationsbeispiel
Im folgenden Konfigurationsbeispiel wird der Standard-Anwendungspool für die Standard-Website auf „DefaultAppPool“ festgelegt.
<sites>
<site name="Default Web Site" id="1" serverAutoStart="true">
<application path="/" applicationPool="Classic .NET AppPool">
<virtualDirectory path="/" physicalPath="%SystemDrive%\inetpub\wwwroot" />
</application>
<bindings>
<binding protocol="http" bindingInformation="*:80:" />
</bindings>
<applicationDefaults applicationPool="DefaultAppPool" />
</site>
</sites>
Beispielcode
Die folgenden Codebeispiele legen den Standard-Anwendungspool für die Standard-Website auf „DefaultAppPool“ fest.
AppCmd.exe
appcmd.exe set config -section:system.applicationHost/sites "/[name='Default Web Site'].applicationDefaults.applicationPool:DefaultAppPool" /commit:apphost
Hinweis
Sie müssen unbedingt den Parameter commit auf apphost festlegen, wenn Sie AppCmd.exe verwenden, um diese Einstellungen zu konfigurieren. Dadurch werden die Konfigurationseinstellungen auf den entsprechenden Speicherortabschnitt in der Datei ApplicationHost.config festgelegt.
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");
ConfigurationElementCollection sitesCollection = sitesSection.GetCollection();
ConfigurationElement siteElement = FindElement(sitesCollection, "site", "name", @"Default Web Site");
if (siteElement == null) throw new InvalidOperationException("Element not found!");
ConfigurationElement applicationDefaultsElement = siteElement.GetChildElement("applicationDefaults");
applicationDefaultsElement["applicationPool"] = @"DefaultAppPool";
serverManager.CommitChanges();
}
}
private static ConfigurationElement FindElement(ConfigurationElementCollection collection, string elementTagName, params string[] keyValues)
{
foreach (ConfigurationElement element in collection)
{
if (String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase))
{
bool matches = true;
for (int i = 0; i < keyValues.Length; i += 2)
{
object o = element.GetAttributeValue(keyValues[i]);
string value = null;
if (o != null)
{
value = o.ToString();
}
if (!String.Equals(value, keyValues[i + 1], StringComparison.OrdinalIgnoreCase))
{
matches = false;
break;
}
}
if (matches)
{
return element;
}
}
}
return null;
}
}
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 sitesCollection As ConfigurationElementCollection = sitesSection.GetCollection
Dim siteElement As ConfigurationElement = FindElement(sitesCollection, "site", "name", "Default Web Site")
If (siteElement Is Nothing) Then
Throw New InvalidOperationException("Element not found!")
End If
Dim applicationDefaultsElement As ConfigurationElement = siteElement.GetChildElement("applicationDefaults")
applicationDefaultsElement("applicationPool") = "DefaultAppPool"
serverManager.CommitChanges()
End Sub
Private Function FindElement(ByVal collection As ConfigurationElementCollection, ByVal elementTagName As String, ByVal ParamArray keyValues() As String) As ConfigurationElement
For Each element As ConfigurationElement In collection
If String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase) Then
Dim matches As Boolean = True
Dim i As Integer
For i = 0 To keyValues.Length - 1 Step 2
Dim o As Object = element.GetAttributeValue(keyValues(i))
Dim value As String = Nothing
If (Not (o) Is Nothing) Then
value = o.ToString
End If
If Not String.Equals(value, keyValues((i + 1)), StringComparison.OrdinalIgnoreCase) Then
matches = False
Exit For
End If
Next
If matches Then
Return element
End If
End If
Next
Return Nothing
End Function
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 sitesCollection = sitesSection.Collection;
var siteElementPos = FindElement(sitesCollection, "site", ["name", "Default Web Site"]);
if (siteElementPos == -1) throw "Element not found!";
var siteElement = sitesCollection.Item(siteElementPos);
var applicationDefaultsElement = siteElement.ChildElements.Item("applicationDefaults");
applicationDefaultsElement.Properties.Item("applicationPool").Value = "DefaultAppPool";
adminManager.CommitChanges();
function FindElement(collection, elementTagName, valuesToMatch) {
for (var i = 0; i < collection.Count; i++) {
var element = collection.Item(i);
if (element.Name == elementTagName) {
var matches = true;
for (var iVal = 0; iVal < valuesToMatch.length; iVal += 2) {
var property = element.GetPropertyByName(valuesToMatch[iVal]);
var value = property.Value;
if (value != null) {
value = value.toString();
}
if (value != valuesToMatch[iVal + 1]) {
matches = false;
break;
}
}
if (matches) {
return i;
}
}
}
return -1;
}
VBScript
Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST")
Set sitesCollection = sitesSection.Collection
siteElementPos = FindElement(sitesCollection, "site", Array("name", "Default Web Site"))
If (siteElementPos = -1) Then
WScript.Echo "Element not found!"
WScript.Quit
End If
Set siteElement = sitesCollection.Item(siteElementPos)
Set applicationDefaultsElement = siteElement.ChildElements.Item("applicationDefaults")
applicationDefaultsElement.Properties.Item("applicationPool").Value = "DefaultAppPool"
adminManager.CommitChanges()
Function FindElement(collection, elementTagName, valuesToMatch)
For i = 0 To CInt(collection.Count) - 1
Set element = collection.Item(i)
If element.Name = elementTagName Then
matches = True
For iVal = 0 To UBound(valuesToMatch) Step 2
Set property = element.GetPropertyByName(valuesToMatch(iVal))
value = property.Value
If Not IsNull(value) Then
value = CStr(value)
End If
If Not value = CStr(valuesToMatch(iVal + 1)) Then
matches = False
Exit For
End If
Next
If matches Then
Exit For
End If
End If
Next
If matches Then
FindElement = i
Else
FindElement = -1
End If
End Function