Standardeinstellungen virtueller Verzeichnisse <virtualDirectoryDefaults>
Übersicht
Das <virtualDirectoryDefaults>-Element der <application>-Elements gibt die Standardeinstellungen für alle virtuellen Verzeichnisse in der übergeordneten Anwendung an. Das <virtualDirectoryDefaults>-Element ist nützlich, um die allgemeinen Attribute zu definieren, die alle virtuellen Verzeichnisse auf der übergeordneten Anwendung 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 <application>-Elements wurde in IIS 7.0 eingeführt. |
| IIS 6.0 | N/V |
Setup
Das <virtualDirectoryDefaults>-Element des <application>-Elements ist in der Standardinstallation von IIS 7 enthalten.
Gewusst wie
So konfigurieren Sie die Standardanmeldeinformationen für ein virtuelles Verzeichnis einer Anwendung
Öffnen Sie den Internet Information Services (IIS) Manager:
Wenn Sie Windows Server 2012 oder Windows Server 2012 R2 verwenden:
- Klicken Sie auf der Taskleiste auf Server-Manager, dann auf Tools und danach auf Internetinformationsdienste-Manager (IIS).
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 Verwaltung, und doppelklicken Sie dann auf Internetinformationsdienste-Manager (IIS).
Wenn Sie Windows Server 2008 oder Windows Server 2008 R2 verwenden:
- Klicken Sie in der Taskleiste auf Start, zeigen Sie auf Verwaltungstools, und klicken Sie dann auf Manager für Internetinformationsdienste(IIS).
Wenn Sie Windows Vista oder Windows 7 verwenden:
- Klicken Sie auf der Taskleiste auf Start und dann auf Systemsteuerung.
- Doppelklicken Sie auf Verwaltung und doppelklicken Sie dann auf den Internet Information Services (IIS) Manager.
Erweitern Sie im Bereich Verbindungen den Servernamen, erweitern Sie den Knoten Sites, erweitern Sie den Knoten für Ihre Site, und klicken Sie dann auf den Namen der Anwendung.
Klicken Sie im Bereich Start der Site auf Virtuelle Verzeichnisse anzeigen im Bereich Aktionen.
Klicken Sie im Bereich virtuelle Verzeichnisse auf Standardeinstellungen für virtuelle Verzeichnisse festlegen... im Bereich Aktionen.
Geben Sie im Dialogfeld Standardwerte für virtuelle Verzeichnisse Ihre Standardanmeldeinformationen für das virtuelle Verzeichnis für die Anwendung an, und klicken Sie dann auf OK.
Konfiguration
Attribute
| Attribut | Beschreibung | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
allowSubDirConfig |
Optionales boolesches Attribut. Gibt an, ob IIS nach Web.config-Dateien in Inhaltsverzeichnissen sucht, die niedriger sind als die aktuelle Ebene (true) oder nicht nach Web.config-Dateien in Inhaltsverzeichnissen unter der aktuellen Ebene sucht (false). Der Standardwert ist true. |
||||||||||
logonMethod |
Optionales Enumerationsattribut. Gibt die Standard-Anmeldemethode für alle virtuellen Verzeichnisse in Anwendungen der übergeordneten Site an. Das logonMethod-Attribut kann einer der folgenden möglichen Werte sein. Der Standardwert ist ClearText.
|
||||||||||
password |
Optionales Zeichenfolgeattribut. Gibt das dem Benutzernamen zugeordnete Kennwort an. Hinweis: Um nicht verschlüsselte Kennwortzeichenfolgen in Konfigurationsdateien zu speichern, verwenden Sie immer AppCmd.exe oder den IIS-Manager, um Kennwörter einzugeben. Wenn Sie diese Verwaltungstools verwenden, werden die Kennwortzeichenfolgen automatisch verschlüsselt, bevor sie in die XML-Konfigurationsdateien geschrieben werden. Dies bietet eine bessere Kennwortsicherheit als das Speichern unverschlüsselter Kennwörter. |
||||||||||
path |
Optionales Zeichenfolgeattribut. Gibt den virtuellen Standardpfad für alle virtuellen Verzeichnisse in Anwendungen der übergeordneten Site an. |
||||||||||
physicalPath |
Optionales Zeichenfolgeattribut. Gibt den physischen Standardpfad für alle virtuellen Verzeichnisse in Anwendungen der übergeordneten Site an. |
||||||||||
userName |
Optionales Zeichenfolgeattribut. Gibt den Standardbenutzernamen eines Kontos an, das auf Konfigurationsdateien und -inhalte für alle virtuellen Verzeichnisse in Anwendungen auf der übergeordneten Website zugreifen kann. |
Untergeordnete Elemente
Keine.
Konfigurationsbeispiel
Im folgenden Konfigurationsbeispiel wird die Standardanmeldungsmethode für virtuelle Verzeichnisse in der Anwendung „/MyApp“ der Standardwebsite angegeben.
<sites>
<site name="Default Web Site" id="1">
<application path="/">
<virtualDirectory path="/" physicalPath="C:\Inetpub\wwwroot" />
</application>
<application path="/MyApp" applicationPool="DefaultAppPool">
<virtualDirectory path="/" physicalPath="C:\inetpub\myapp" />
<virtualDirectoryDefaults logonMethod="Network" />
</application>
<bindings>
<binding protocol="http" bindingInformation="*:80:" />
</bindings>
</site>
</sites>
Beispielcode
Im folgenden Codebeispiel wird die Standardanmeldungsmethode für virtuelle Verzeichnisse in der Anwendung „/MyApp“ der Standardwebsite angegeben.
AppCmd.exe
appcmd.exe set config -section:system.applicationHost/sites "/[name='Default Web Site'].[path='/MyApp'].virtualDirectoryDefaults.logonMethod:Network" /commit:apphost
Hinweis
Sie müssen den commit-Parameter 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!");
ConfigurationElementCollection siteCollection = siteElement.GetCollection();
ConfigurationElement applicationElement = FindElement(siteCollection, "application", "path", @"/MyApp");
if (applicationElement == null) throw new InvalidOperationException("Element not found!");
ConfigurationElement virtualDirectoryDefaultsElement = applicationElement.GetChildElement("virtualDirectoryDefaults");
virtualDirectoryDefaultsElement["logonMethod"] = @"Network";
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 siteCollection As ConfigurationElementCollection = siteElement.GetCollection
Dim applicationElement As ConfigurationElement = FindElement(siteCollection, "application", "path", "/MyApp")
If (applicationElement Is Nothing) Then
Throw New InvalidOperationException("Element not found!")
End If
Dim virtualDirectoryDefaultsElement As ConfigurationElement = applicationElement.GetChildElement("virtualDirectoryDefaults")
virtualDirectoryDefaultsElement("logonMethod") = "Network"
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 siteCollection = siteElement.Collection;
var applicationElementPos = FindElement(siteCollection, "application", ["path", "/MyApp"]);
if (applicationElementPos == -1) throw "Element not found!";
var applicationElement = siteCollection.Item(applicationElementPos);
var virtualDirectoryDefaultsElement = applicationElement.ChildElements.Item("virtualDirectoryDefaults");
virtualDirectoryDefaultsElement.Properties.Item("logonMethod").Value = "Network";
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 siteCollection = siteElement.Collection
applicationElementPos = FindElement(siteCollection, "application", Array("path", "/MyApp"))
If (applicationElementPos = -1) Then
WScript.Echo "Element not found!"
WScript.Quit
End If
Set applicationElement = siteCollection.Item(applicationElementPos)
Set virtualDirectoryDefaultsElement = applicationElement.ChildElements.Item("virtualDirectoryDefaults")
virtualDirectoryDefaultsElement.Properties.Item("logonMethod").Value = "Network"
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