Freigeben über

Anwendungen für die Anwendung <ApplicationDependencies>

Übersicht

Das <application>-Element des Elements <applicationDependencies> gibt eine Anwendung an, die Abhängigkeiten von einer oder mehreren CGI- oder ISAPI-Erweiterungseinschränkungen aufweist. Insbesondere gibt das GroupID-Attribut des <application>-Elements die primäre Anwendungsabhängigkeit an, und das Element kann ein oder mehrere <Add-Elemente>enthalten, die zusätzliche Abhängigkeiten angeben.

Kompatibilität

Version Hinweise
IIS 10.0 Das <application> Element wurde in IIS 10.0 nicht geändert.
IIS 8.5 Das <application> Element wurde in IIS 8.5 nicht geändert.
IIS 8.0 Das <application> Element wurde in IIS 8.0 nicht geändert.
IIS 7.5 Das <application>-Element wurde in IIS 7.5 nicht geändert.
IIS 7.0 Das <application>-Element des <applicationDependencies>-Elements wurde in IIS 7.0 eingeführt.
IIS 6.0 Das <applicationDependencies>-Element ersetzt das IIS 6.0-Attribut ApplicationDependencies des Metabasisobjekts IIsWebService.

Setup

Das <application>-Element des <applicationDependencies>-Elements ist in der Standardinstallation von IIS 7 enthalten.

Gewusst wie

Es gibt keine Benutzeroberfläche zum Konfigurieren des <applicationDependencies>-Elements für IIS 7. Beispiele zum programmgesteuerten Konfigurieren des <applicationDependencies>-Elements finden Sie im Abschnitt Codebeispiele dieses Dokuments.

Konfiguration

Attribute

Attribut Beschreibung
groupID Optionales Zeichenfolgeattribut.

Gibt die GroupID der Anwendung an, die eine Abhängigkeit von einer Erweiterungseinschränkung aufweist.

Im folgenden Abschnitt „Standardkonfiguration“ finden Sie die vollständige Liste der Standardwerte.
Name Erforderliches Zeichenfolgenattribut.

Gibt den eindeutigen Namen der Anwendung an, die eine Abhängigkeit von einer Erweiterungseinschränkung aufweist.

Im folgenden Abschnitt „Standardkonfiguration“ finden Sie die vollständige Liste der Standardwerte.

Untergeordnete Elemente

Element Beschreibung
add Optionales Element.

Fügt der übergeordneten Anwendung zusätzliche GroupIDs hinzu.
clear Optionales Element.

Entfernt alle Verweise auf zusätzliche GroupIDs aus der Add-Auflistung.

Konfigurationsbeispiel

Das folgende Konfigurationsbeispiel veranschaulicht die Anwendungsabhängigkeiten im <applicationDependencies> Element für die Standardwebsite und die zugehörigen Einträge in der <isapiCgiRestriction> Nachinstallation von Active Server Pages (ASP) und einer benutzerdefinierten Anwendung in IIS 7:

  • Die Anwendung „Active Server Pages“ hat eine Abhängigkeit von der Einschränkungsgruppe „ASP“ ISAPI/CGI.
  • Die benutzerdefinierte Anwendung verfügt über eine Abhängigkeit von der ISAPI/CGI-Einschränkungsgruppe „MyCustomGroup“ und einer zusätzlichen Abhängigkeit von der ASP ISAPI/CGI-Einschränkungsgruppe.
<system.webServer>
   <security>
      <isapiCgiRestriction notListedIsapisAllowed="false" notListedCgisAllowed="false">
         <clear />
         <add allowed="true" groupId="ASP"
            path="C:\Windows\system32\inetsrv\asp.dll" 
            description="Active Server Pages" />
         <add allowed="true" groupId="MyCustomGroup"
            path="C:\Windows\system32\inetsrv\mycustom.dll"
            description="My Custom Application" />
      </isapiCgiRestriction>
   </security>
</system.webServer>

<location path="Default Web Site">
   <system.webServer>
      <security>
         <applicationDependencies>
            <application name="My Custom Application" groupId="MyCustomGroup">
               <add groupId="ASP" />
            </application>
         </applicationDependencies>
      </security>
   </system.webServer>
</location>

Beispielcode

Das folgende Konfigurationsbeispiel veranschaulicht die Anwendungsabhängigkeiten im <applicationDependencies>-Element für die Standardwebsite. Die benutzerdefinierte Anwendung verfügt über eine Abhängigkeit von der ISAPI/CGI-Einschränkungsgruppe „MyCustomGroup“ und einer zusätzlichen Abhängigkeit von der ASP ISAPI/CGI-Einschränkungsgruppe.

AppCmd.exe

appcmd.exe set config "Default Web Site" -section:system.webServer/security/applicationDependencies /+"[name='My Custom Application',groupId='MyCustomGroup']" /commit:apphost

appcmd.exe set config "Default Web Site" -section:system.webServer/security/applicationDependencies /+"[name='My Custom Application',groupId='MyCustomGroup'].[groupId='ASP']" /commit:apphost

Hinweis

Sie müssen unbedingt den Commitparameter 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 applicationDependenciesSection = config.GetSection("system.webServer/security/applicationDependencies", "Default Web Site");

         ConfigurationElementCollection applicationDependenciesCollection = applicationDependenciesSection.GetCollection();
         ConfigurationElement applicationElement = applicationDependenciesCollection.CreateElement("application");
         applicationElement["name"] = @"My Custom Application";
         applicationElement["groupId"] = @"MyCustomGroup";

         ConfigurationElementCollection applicationCollection = applicationElement.GetCollection();
         ConfigurationElement addElement = applicationCollection.CreateElement("add");
         addElement["groupId"] = @"ASP";
         applicationCollection.Add(addElement);
         applicationDependenciesCollection.Add(applicationElement);

         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 applicationDependenciesSection As ConfigurationSection = config.GetSection("system.webServer/security/applicationDependencies", "Default Web Site")

      Dim applicationDependenciesCollection As ConfigurationElementCollection = applicationDependenciesSection.GetCollection
      Dim applicationElement As ConfigurationElement = applicationDependenciesCollection.CreateElement("application")
      applicationElement("name") = "My Custom Application"
      applicationElement("groupId") = "MyCustomGroup"

      Dim applicationCollection As ConfigurationElementCollection = applicationElement.GetCollection
      Dim addElement As ConfigurationElement = applicationCollection.CreateElement("add")
      addElement("groupId") = "ASP"
      applicationCollection.Add(addElement)
      applicationDependenciesCollection.Add(applicationElement)

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var applicationDependenciesSection = adminManager.GetAdminSection("system.webServer/security/applicationDependencies", "MACHINE/WEBROOT/APPHOST/Default Web Site");

var applicationDependenciesCollection = applicationDependenciesSection.Collection;
var applicationElement = applicationDependenciesCollection.CreateNewElement("application");
applicationElement.Properties.Item("name").Value = "My Custom Application";
applicationElement.Properties.Item("groupId").Value = "MyCustomGroup";

var applicationCollection = applicationElement.Collection;
var addElement = applicationCollection.CreateNewElement("add");
addElement.Properties.Item("groupId").Value = "ASP";
applicationCollection.AddElement(addElement);
applicationDependenciesCollection.AddElement(applicationElement);

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set applicationDependenciesSection = adminManager.GetAdminSection("system.webServer/security/applicationDependencies", "MACHINE/WEBROOT/APPHOST/Default Web Site")

Set applicationDependenciesCollection = applicationDependenciesSection.Collection
Set applicationElement = applicationDependenciesCollection.CreateNewElement("application")
applicationElement.Properties.Item("name").Value = "My Custom Application"
applicationElement.Properties.Item("groupId").Value = "MyCustomGroup"

Set applicationCollection = applicationElement.Collection
Set addElement = applicationCollection.CreateNewElement("add")
addElement.Properties.Item("groupId").Value = "ASP"
applicationCollection.AddElement(addElement)
applicationDependenciesCollection.AddElement(applicationElement)

adminManager.CommitChanges()
  • Last updated on