Standardeinstellungen virtueller Verzeichnisse für alle Sites <virtualDirectoryDefaults>

Übersicht

Das <virtualDirectoryDefaults>-Element des <sites>-Elements gibt die Standardeinstellungen für alle virtuellen Verzeichnisse auf dem Server an. Das <virtualDirectoryDefaults>-Element ist nützlich zum Definieren der allgemeinen Attribute, die alle virtuellen Verzeichnisse auf dem Server implizit freigeben sollen, wenn sie keine explizit definierten Attribute besitzen.

Hinweis

Wenn dasselbe Attribut oder untergeordnete Element sowohl im Abschnitt <virtualDirectoryDefaults> als auch im Abschnitt <virtualDirectory> für ein bestimmtes virtuelles Verzeichnis konfiguriert ist, wird die Konfiguration im Abschnitt <virtualDirectory> für dieses virtuelle Verzeichnis verwendet.

Kompatibilität

Version	Hinweise
IIS 10.0	Das <virtualDirectoryDefaults>-Element wurde in IIS 10.0 nicht geändert.
IIS 8.5	Das <virtualDirectoryDefaults>-Element wurde in IIS 8.5 nicht geändert.
IIS 8.0	Das <virtualDirectoryDefaults>-Element wurde in IIS 8.0 nicht geändert.
IIS 7.5	Das <virtualDirectoryDefaults>-Element wurde in IIS 7.5 nicht geändert.
IIS 7.0	Das <virtualDirectoryDefaults>-Element des <sites>-Elements wurde in IIS 7.0 eingeführt.
IIS 6.0	N/V

Setup

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

Gewusst wie

Konfigurieren der Standardanmeldeinformationen für ein virtuelles Verzeichnis eines Servers

1. Öffnen Sie Internetinformationsdienste-Manager (IIS-Manager):

   • Vorgehensweise unter Windows Server 2012 oder Windows Server 2012 R2:

     • Klicken Sie auf der Taskleiste auf Server-Manager > Tools > Internetinformationsdienste-Manager (IIS-Manager).

   • Vorgehensweise unter Windows 8 oder Windows 8.1:

     • Halten Sie die WINDOWS-TASTE gedrückt, drücken Sie den Buchstaben X, und klicken Sie dann auf Systemsteuerung.
     • Klicken Sie auf Verwaltung, und doppelklicken Sie dann auf Internetinformationsdienste-Manager (IIS-Manager).

   • Vorgehensweise unter Windows Server 2008 oder Windows Server 2008 R2:

     • Klicken Sie auf der Taskleiste auf Start, zeigen Sie auf Verwaltung, und klicken Sie dann auf Internetinformationsdienste-Manager (IIS-Manager).

   • Vorgehensweise unter Windows Vista oder Windows 7:

     • Klicken Sie auf der Taskleiste auf Start und dann auf Systemsteuerung.
     • Doppelklicken Sie auf Verwaltung und dann auf Internetinformationsdienste-Manager (IIS-Manager).

2. Erweitern Sie im Bereich Verbindungen den Servernamen, und klicken Sie dann auf den Knoten Sites.

3. Klicken Sie im Bereich Sites des Servers im Bereich Aktionen auf Websitestandardwerte festlegen.
   

4. Geben Sie im Dialogfeld Websitestandardwerte Ihre Standardanmeldeinformationen für das virtuelle Verzeichnis für alle Websites an, und klicken Sie dann auf OK.
   

Konfiguration

Attribute

Attribut	Beschreibung
allowSubDirConfig	Optionales boolesches Attribut. Gibt an, ob IIS nach Dateien vom Typ „Web.config“ in Inhaltsverzeichnissen, die in der Verzeichnishierarchie niedriger sind als die aktuelle Ebene (true), oder nicht nach Dateien vom Typ „Web.config“ in Inhaltsverzeichnissen unter der aktuellen Ebene sucht (false). Der Standardwert ist true.
logonMethod	Optionales Enumerationsattribut. Gibt die Standardanmeldemethode für alle virtuellen Verzeichnisse auf dem Server an. Das logonMethod-Attribut kann einen der folgenden möglichen Werte haben. Der Standardwert ist ClearText. Wert Beschreibung Batch Dieser Anmeldetyp ist für Batchserver vorgesehen, bei denen Prozesse im Auftrag eines Benutzers ohne direkten Eingriff durch den Benutzer ausgeführt werden können. Der numerische Wert ist 1. ClearText Dieser Anmeldetyp behält den Namen und das Kennwort im Authentifizierungspaket bei. Auf diese Weise kann der Server Verbindungen mit anderen Netzwerkservern herstellen, während der Identitätswechsel für den Client erfolgt. Der numerische Wert ist 3. Interactive Dieser Anmeldetyp ist für Benutzer vorgesehen, die den Computer interaktiv verwenden. Der numerische Wert ist 0. Network Dieser Anmeldetyp ist für Hochleistungsserver zur Authentifizierung von Klartext-Kennwörtern vorgesehen. Anmeldeinformationen werden für diesen Anmeldetyp nicht zwischengespeichert. Der numerische Wert ist 2. Weitere Informationen zu diesen Werten finden Sie unter LogonUser.
password	Optionales Zeichenfolgeattribut. Gibt das dem Benutzernamen zugeordnete Kennwort an. Hinweis: Um die Speicherung nicht verschlüsselter Kennwortzeichenfolgen in Konfigurationsdateien zu vermeiden, verwenden Sie immer „AppCmd.exe“ oder IIS-Manager für die Eingabe von Kennwörtern. Wenn Sie diese Verwaltungstools verwenden, werden die Kennwortzeichenfolgen automatisch verschlüsselt, bevor sie in die XML-Konfigurationsdateien geschrieben werden. Dies bietet eine höhere Kennwortsicherheit als das Speichern unverschlüsselter Kennwörter.
path	Optionales Zeichenfolgeattribut. Gibt den standardmäßigen virtuellen Pfad für alle virtuellen Verzeichnisse auf dem Server an.
physicalPath	Optionales Zeichenfolgeattribut. Gibt den standardmäßigen physischen Pfad für alle virtuellen Verzeichnisse auf dem Server an.
userName	Optionales Zeichenfolgeattribut. Gibt den Standardbenutzernamen eines Kontos an, das auf Konfigurationsdateien und -inhalte für alle virtuellen Verzeichnisse auf dem Server zugreifen kann.

Untergeordnete Elemente

Keine.

Konfigurationsbeispiel

Im folgenden Konfigurationsbeispiel wird die Standardanmeldemethode für alle virtuellen Verzeichnisse auf dem Server angegeben.

<sites>
   <virtualDirectoryDefaults logonMethod="Network" />
</sites>

Beispielcode

In den folgenden Konfigurationsbeispielen wird die Standardanmeldemethode für alle virtuellen Verzeichnisse auf dem Server angegeben.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites /virtualDirectoryDefaults.logonMethod:"Network" /commit:apphost

Hinweis

Legen Sie den commit-Parameter auf apphost fest, 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");

         ConfigurationElement virtualDirectoryDefaultsElement = sitesSection.GetChildElement("virtualDirectoryDefaults");
         virtualDirectoryDefaultsElement["logonMethod"] = @"Network";

         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 virtualDirectoryDefaultsElement As ConfigurationElement = sitesSection.GetChildElement("virtualDirectoryDefaults")
      virtualDirectoryDefaultsElement("logonMethod") = "Network"

      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 virtualDirectoryDefaultsElement = sitesSection.ChildElements.Item("virtualDirectoryDefaults");
virtualDirectoryDefaultsElement.Properties.Item("logonMethod").Value = "Network";

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 virtualDirectoryDefaultsElement = sitesSection.ChildElements.Item("virtualDirectoryDefaults")
virtualDirectoryDefaultsElement.Properties.Item("logonMethod").Value = "Network"

adminManager.CommitChanges()