Konfigurationsumleitung <configurationRedirection>

Übersicht

Mit dem <configurationRedirection>-Element können Sie Konfigurationsdateien von einem zentralen Speicherort an mehrere Internetinformationsdienste (IIS) 7-Servercomputer in einer Webfarm freigeben. Auf diese Weise können Sie einen IIS 7-Server in Ihrer Webfarm konfigurieren und die resultierenden Konfigurationseinstellungen auf allen IIS 7-Servern in der Webfarm freigeben. Mit diesem Element können Sie auch Konfigurationseinstellungen auf einem UNC-Server speichern, auf den alle Webservercomputer in der Webfarm zugreifen können.

Änderungen in IIS 7.5

In IIS 7.5 wurden zwei neue Attribute hinzugefügt, die steuern, ob IIS Änderungsbenachrichtigungen oder UNC-Abrufe verwendet, um festzustellen, ob sich die Konfigurationsdateien geändert haben. Zu diesen Attributen zählen folgende:

• enableUncPolling:

  • Wenn dieser Wert auf true festgelegt ist, überprüft IIS regelmäßig die UNC-Freigabe, um zu testen, ob die Konfigurationsdateien aktualisiert wurden.
  • Wenn dieser Wert auf false festgelegt ist, werden Änderungsbenachrichtigungen weiterhin wie in IIS 7.0 verwendet.

• pollingPeriod: Gibt das Zeitintervall zwischen UNC-Prüfungen an, die IIS verwendet.

Kompatibilität

Version	Hinweise
IIS 10.0	Das <configurationRedirection> Element wurde in IIS 10.0 nicht geändert.
IIS 8.5	Das <configurationRedirection> Element wurde in IIS 8.5 nicht geändert.
IIS 8.0	Das <configurationRedirection> Element wurde in IIS 8.0 nicht geändert.
IIS 7.5	In IIS 7.5 wurden die enableUncPolling- und pollingPeriod-Attribute hinzugefügt.
IIS 7.0	Das <configurationRedirection> Element wurde in IIS 7.0 eingeführt.
IIS 6.0	IIS 6.0 unterstützt keine gemeinsame Konfiguration.

Setup

Das <configurationRedirection>-Element ist in der Standardinstallation von IIS 7 enthalten.

Gewusst wie

Exportieren von Konfigurationseinstellungen und Aktivieren der freigegebenen Konfiguration

1. Ö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 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.

2. Klicken Sie im Bereich Verbindungen auf die Serververbindung, für die Sie die Konfigurationsumleitung einrichten möchten.

3. Doppelklicken Sie im Bereich Start auf Freigegebene Konfiguration.
   

4. Klicken Sie im Bereich Aktionen auf Konfiguration exportieren
   

5. Geben Sie im Dialogfeld Konfiguration exportieren den Pfad zu dem Verzeichnis ein, in das Sie die Konfigurationsdateien im Feld physischen Pfad exportieren möchten, geben Sie das Verschlüsselungskennwort ein, bestätigen Sie dieses, und klicken Sie dann auf OK.
   

6. Wenn das Dialogfeld Konfiguration exportieren angezeigt wird, klicken Sie auf OK.
   

Aktivieren der freigegebenen Konfiguration

1. Ö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 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.

2. Klicken Sie im Bereich Verbindungen auf die Serververbindung, für die Sie die Konfigurationsumleitung einrichten möchten.

3. Doppelklicken Sie im Bereich Start auf Freigegebene Konfiguration.
   

4. Aktivieren Sie im Bereich Freigegebene Konfiguration die Option Freigegebene Konfiguration aktivieren.

5. Geben Sie im Feld Physischer Pfad den Pfad zu den freigegebenen Konfigurationsdateien ein, geben Sie den Kontonamen mit Berechtigungen für den Zugriff auf die freigegebenen Konfigurationsdateien im Feld Benutzername ein, geben Sie das Kennwort des Kontos im Feld Kennwort ein, und geben Sie dann das Kontokennwort erneut im Feld Kennwort bestätigen ein.
   

6. Klicken Sie im Bereich Aktionen auf Übernehmen.

7. Geben Sie in das Kennwort-Dialogfeld Verschlüsselungsschlüssel-Passwort eingeben im Dialogfeld Verschlüsselungsschlüssel-Passwort das Passwort für den in Schritt 5 erstellten Verschlüsselungsschlüssel ein, und klicken Sie dann auf OK.
   

8. Klicken Sie in jedem der angezeigten Dialogfelder Freigegebene Konfiguration auf OK, um die Dialogfelder zu schließen.
   
   

   Hinweis

   Sie müssen den IIS-Manager schließen und neu starten, damit er diese Konfigurationsänderungen berücksichtigt.

Konfiguration

Das <configurationRedirection>-Element ist in der Datei Redirection.config konfiguriert.

Attribute

Attribut	Beschreibung
enabled	Optionales boolesches Attribut. Gibt an, ob die Konfigurationsumleitung auf dem Webserver aktiviert oder deaktiviert ist. Der Standardwert ist false.
enableUncPolling	Optionales boolesches Attribut. true, wenn die UNC-Abfrage verwendet werden soll, um zu überprüfen, ob die Konfigurationsdateien aktualisiert wurden; andernfalls false, wenn Änderungsbenachrichtigungen verwendet werden sollen. Hinweis: Das Zeitintervall zwischen Prüfungen wird durch das Attribut pollingPeriod konfiguriert. Hinweis: Dieses Attribut wurde in IIS 7.5 hinzugefügt. Der Standardwert ist false.
password	Optionales Zeichenfolgeattribut. Gibt das Kennwort an, das Sie für den Zugriff auf den Speicherort der Konfigurationsdatei authentifizieren müssen. Dies ist eine Zeichenfolge mit Groß-/Kleinschreibung. 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 Speicherort an, von dem Konfigurationsdateien und Verschlüsselungsschlüssel gelesen werden sollen. Dies kann ein Netzwerkpfad oder ein Ordner auf dem lokalen Computer sein. Es ist kein Standardwert vorhanden.
pollingPeriod	Optionales timeSpan-Attribut. Gibt das Zeitintervall zwischen Überprüfungen an, in dem IIS überprüft, ob die Konfigurationsdateien aktualisiert wurden. Hinweis: Dies gilt nur, wenn das Attribut enableUncPolling auf truefestgelegt ist. Hinweis: Dieses Attribut wurde in IIS 7.5 hinzugefügt. Der Standardwert beträgt 00:03:00 (drei Minuten).
userName	Optionales Zeichenfolgeattribut. Gibt den Benutzernamen an, den Sie für den Zugriff auf den Speicherort der Konfigurationsdatei authentifizieren müssen. Es ist kein Standardwert vorhanden.

Untergeordnete Elemente

Keine.

Konfigurationsbeispiel

Das folgende Codebeispiel zeigt, wie Sie IIS 7 so konfigurieren, dass Konfigurationsdateien und Verschlüsselungsschlüssel für ein freigegebenes Verzeichnis im Netzwerk freigegeben werden.

<CONFIGURATION>

   <CONFIGSECTIONS>
      <SECTION name="configurationRedirection" />
   </CONFIGSECTIONS>

   <CONFIGPROTECTEDDATA>
      <PROVIDERS>
         <ADD description="Uses RsaCryptoServiceProvider to encrypt and decrypt" name="IISRsaProvider" type="" keyContainerName="iisConfigurationKey" cspProviderName="" useMachineContainer="true" useOAEP="false" />
      </PROVIDERS>
   </CONFIGPROTECTEDDATA>

   <CONFIGURATIONREDIRECTION enabled="true" path="\\ServerName\ShareName" userName="MyUser" password="[enc:IISRsaProvider:57686f6120447564652c2049495320526f636b73:enc]" />

</CONFIGURATION>

Beispielcode

In den folgenden Beispielen wird die gemeinsame Konfiguration aktiviert, indem die exportierten Konfigurationsdateien verwendet werden, die unter \\ServerName\ShareName freigegeben sind, und indem ein Benutzername „MyUser“ mit dem Kennwort „P@ssw0rd“ für den Zugriff auf die Freigabe verwendet wird.

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.GetRedirectionConfiguration();
         ConfigurationSection redirectionSection = config.GetSection("configurationRedirection");

         redirectionSection.Attributes["enabled"].Value = true;
         redirectionSection.Attributes["path"].Value = @"\\ServerName\ShareName";
         redirectionSection.Attributes["userName"].Value = @"MyUser";
         redirectionSection.Attributes["password"].Value = @"P@ssw0rd";

         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.GetRedirectionConfiguration
      Dim redirectionSection As ConfigurationSection = config.GetSection("configurationRedirection")
      redirectionSection.Attributes("enabled").Value = True
      redirectionSection.Attributes("path").Value = "\\ServerName\ShareName"
      redirectionSection.Attributes("userName").Value = "MyUser"
      redirectionSection.Attributes("password").Value = "P@ssw0rd"
      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

try
{
   var config = WScript.CreateObject( "Microsoft.ApplicationHost.WritableAdminManager" );
   config.CommitPath = "MACHINE/REDIRECTION";
   var section = config.GetAdminSection( "configurationRedirection","MACHINE/REDIRECTION" );
   section.Properties.Item( "enabled" ).Value = true;
   section.Properties.Item( "path" ).Value = "\\\\ServerName\\ShareName";
   section.Properties.Item( "userName" ).Value = "MyUser";
   section.Properties.Item( "password" ).Value = "P@ssw0rd";
   config.CommitChanges();
}
catch(e)
{
   WScript.Echo(e.number); 
   WScript.Echo(e.description);
}

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/REDIRECTION"

Set configurationRedirection = adminManager.GetAdminSection( "configurationRedirection", _
"MACHINE/REDIRECTION" )

configurationRedirection.Properties.Item( "enabled" ).Value = True
configurationRedirection.Properties.Item( "path" ).Value = "\\ServerName\ShareName"
configurationRedirection.Properties.Item( "userName" ).Value = "MyUser"
configurationRedirection.Properties.Item( "password" ).Value = "P@ssw0rd"

adminManager.CommitChanges