Standardeinstellungen virtueller Verzeichnisse für eine Site <virtualDirectoryDefaults>
Übersicht
Das <virtualDirectoryDefaults>-Element der <site>-Elements gibt die Standardeinstellungen für alle virtuellen Verzeichnisse in der übergeordneten Site an. Das <virtualDirectoryDefaults>-Element ist nützlich, um die allgemeinen Attribute zu definieren, die alle virtuellen Verzeichnisse auf der übergeordneten Website 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 <site>-Elements wurde in IIS 7.0 eingeführt. |
| IIS 6.0 | N/V |
Setup
Das <virtualDirectoryDefaults>-Element des <site>-Elements ist in der Standardinstallation von IIS 7 enthalten.
Gewusst wie
So konfigurieren Sie die Standardanmeldeinformationen für ein virtuelles Verzeichnis einer Site
Öffnen Sie den Internet Information Services (IIS) Manager:
Wenn Sie Windows Server 2012 oder Windows Server 2012 R2 verwenden:
- Klicken Sie 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, erweitern Sie 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 Standardanmeldeinformationen für das virtuelle Verzeichnis für die Site 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 in der Verzeichnishierarchie 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 Standardwebsite angegeben.
<sites>
<site name="Default Web Site" id="1">
<application path="/">
<virtualDirectory path="/" physicalPath="C:\Inetpub\wwwroot" />
</application>
<bindings>
<binding protocol="http" bindingInformation="*:80:" />
</bindings>
<virtualDirectoryDefaults logonMethod="Network" />
</site>
</sites>
Beispielcode
Im folgenden Codebeispiel wird die Standardanmeldungsmethode für virtuelle Verzeichnisse in der Standardwebsite angegeben.
AppCmd.exe
appcmd.exe set config -section:system.applicationHost/sites "/[name='Default Web Site'].virtualDirectoryDefaults.logonMethod:Network" /commit:apphost
Hinweis
Sie müssen unbedingt den Commitparameterapphost 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 virtualDirectoryDefaultsElement = siteElement.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 virtualDirectoryDefaultsElement As ConfigurationElement = siteElement.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 virtualDirectoryDefaultsElement = siteElement.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 virtualDirectoryDefaultsElement = siteElement.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