Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

Exportieren von IIS-Konfigurationen mithilfe von "Iiscnfg.vbs"

Sie können mit dem Befehlszeilenskript iiscnfg.vbs, das im Verzeichnis Systemstamm\system32 gespeichert ist, eine IIS-Metabasis (Internet Information Services, Internetinformationsdienste) ganz oder teilweise, verschlüsselt oder unverschlüsselt, in eine XML-Datei (Extensible Markup Language) kopieren. Die XML-Datei kann in einem /import-Vorgang zum Kopieren der ganzen Metabasis oder eines Teiles davon in eine andere IIS-Konfiguration verwendet werden.

Auf dem Computer, von dem der Befehl ausgegeben wird, muss Windows XP oder ein Mitglied der Windows Server 2003-Produktfamilie ausgeführt werden. Auf dem Computer, auf den sich der Befehl auswirkt, muss ein Mitglied der Windows Server 2003-Produktfamilie mit IIS 6.0 ausgeführt werden.

Wichtig
Sie müssen Mitglied der Gruppe Administratoren auf dem lokalen Computer sein, um Skripts und ausführbare Dateien ausführen zu können. Größtmögliche Sicherheit erreichen Sie, wenn Sie sich über ein Konto, das nicht zur Gruppe Administratoren gehört, am Computer anmelden und dann mithilfe des Befehls runas das Skript bzw. die ausführbare Datei als Administrator ausführen. Geben Sie an der Eingabeaufforderung runas /profile /User:MeinComputer\Administrator cmd ein, um ein Befehlsfenster mit Administratorrechten zu öffnen, und geben Sie dann cscript.exe Skriptname ein (einschließlich des vollständigen Skriptpfades und eventueller Parameter).

Wichtig

Sie müssen Mitglied der Gruppe Administratoren auf dem lokalen Computer sein, um Skripts und ausführbare Dateien ausführen zu können. Größtmögliche Sicherheit erreichen Sie, wenn Sie sich über ein Konto, das nicht zur Gruppe Administratoren gehört, am Computer anmelden und dann mithilfe des Befehls runas das Skript bzw. die ausführbare Datei als Administrator ausführen. Geben Sie an der Eingabeaufforderung runas /profile /User:MeinComputer\Administrator cmd ein, um ein Befehlsfenster mit Administratorrechten zu öffnen, und geben Sie dann cscript.exe Skriptname ein (einschließlich des vollständigen Skriptpfades und eventueller Parameter).

Dieses Thema enthält die folgenden Informationen:

Übersicht: Grundlegendes zum Verständnis von Exportverfahren
Syntax: Die Reihenfolge, in der ein Befehl sowie nachfolgende Argumente und Optionen eingegeben werden.
Parameter: Die Werte, die für Variablen im Befehl eingegeben werden.
Beispiele: Beispielcode sowie eine Erklärung der Ergebnisse.

Übersicht

Die Metabasis eines IIS-Servers enthält system- und computerspezifische Eigenschaften. Exportieren Sie die Konfiguration eines IIS-Servers nicht unverändert auf einen anderen IIS-Server. Verwenden Sie stattdessen den /copy-Vorgang von Sichern von IIS-Konfigurationen mithilfe von "Iisback.vbs" oder Exportieren von IIS-Konfigurationen mithilfe von "Iiscnfg.vbs". Dieser ersetzt system- und computerspezifische Eigenschaften, sodass die Konfiguration auf dem Zielcomputer gültig ist.

Iiscnfg.vbs stellt eine Option bereit, mit der vererbte Eigenschaften in die Exportdatei aufgenommen werden können.

Wenn Sie eine unbefugte Verwendung der Exportdateien verhindern möchten, können Sie mithilfe von iiscnfg.vbs die Dateien mit einem Kennwort verschlüsseln. Das Kennwort verschlüsselt den Sitzungsschlüssel, der wiederum alle Eigenschaften verschlüsselt, für die das sichere Attribut festgelegt wurde.

Sie können eine verschlüsselte Exportkopie lesen (nur der Sitzungsschlüssel und die sicheren Eigenschaften sind verschlüsselt), und Sie können die Datei löschen. Sie können die Sicherungskopie in einem /import-Vorgang nur verwenden, wenn Sie das Verschlüsselungskennwort bereitstellen. Außerdem können Sie die Kennwortverschlüsselung nicht von der Exportdatei entfernen oder das Verschlüsselungskennwort ändern.

Durch den /copy-Vorgang werden die computer- und systemspezifischen Eigenschaften in der Metabasis so geändert, dass sie auf dem Zielcomputer gültig sind. Verzeichnis- oder Dateipfade werden jedoch nicht angepasst. Daher sind Pfade in der Konfiguration auf dem Zielcomputer möglicherweise nicht gültig.

Syntax

iiscnfg /export /f [Pfad\]Dateiname. xml /sp Quellpfad [ /d Verschlüsselungskennwort] [ /inherited ] [ /children ] [ /s Computer [ /u [Domäne\]Benutzer [ /p Kennwort]]]

Parameter

/f [Pfad\]Dateiname. xml

Erforderlich. Gibt einen eindeutigen Namen und Speicherort für die Exportdatei an. Wenn Sie eine vorhandene Datei angeben oder die Verzeichnisse im angegebenen Pfad nicht vorhanden sind, schlägt der Befehl fehl. Der Dateipfad muss außerdem lokal sein. Beim Exportieren einer Datei von einem Remotecomputer bezieht sich der Parameter /f auf einen Pfad auf dem Remotecomputer.

/sp Quellpfad

Erforderlich. Gibt die zu exportierenden Metabasisschlüssel an. Geben Sie einen Metabasispfad, einschließlich /lm/ als Stamm, für die ausgewählten Schlüssel ein.

/d Verschlüsselungskennwort

Verschlüsselt die Exportdatei mit dem angegebenen Kennwort. Sie können jede beliebige Zeichenfolge als Kennwort verwenden. Mit dem Parameter /d wird durch Verschlüsseln des Sitzungsschlüssels und Schützen von Eigenschaften mit dem angegebenen Kennwort eine sichere Exportdatei erstellt. Sie müssen das Kennwort für die Verwendung der Datei in einer /import-Operation bereitstellen.

Wenn Sie diesen Parameter oder das Kennwortargument auslassen, wird die Exportdatei mit einem leeren Kennwort verschlüsselt. In dem Fall werden nur die sicheren Eigenschaften verschlüsselt, und jeder Administrator kann mithilfe der Exportdatei die Konfiguration einer Metabasis importieren.

/inherited

Fügt die vererbten Eigenschaften der exportierten Schlüssel zur Exportdatei hinzu. Ohne diesen Parameter enthält die Exportdatei keine von höheren Schlüsseln vererbten Eigenschaften. Wenn Sie diese Option auswählen, werden die vererbten Eigenschaften der exportierten Schlüssel von iiscnfg.vbs zu einem IIsInheritedProperties-Schlüssel in der Exportdatei hinzugefügt. Beim Importieren von Schlüsseln aus dieser Datei können Sie wählen, ob mit den Schlüsseln die vererbten Eigenschaften importiert werden sollen.

Hinweis
Wenn vererbte Eigenschaften importiert werden, behalten die importierten Schlüssel die Eigenschaften, die sie in der exportierenden Konfiguration geerbt haben. Werden die vererbten Eigenschaften nicht importiert, erben die Schlüssel die Eigenschaften der importierenden Konfiguration.

/children

Fügt die Unterschlüssel des angegebenen Schlüssels rekursiv zur Exportdatei hinzu.

/s Computer

Führt das Skript auf dem angegebenen Remotecomputer aus. Geben Sie den Computernamen oder die IP-Adresse (Internetprotokoll) ohne umgekehrte Schrägstriche ein. Als Standard ist der lokale Computer festgelegt.

/u [Domäne\]Benutzer

Führt das Skript mit den Berechtigungen des angegebenen Benutzerkontos aus. Bei diesem Konto muss es sich um ein Mitglied der Gruppe Administratoren auf dem Remotecomputer handeln. Standardmäßig wird das Skript mit den Berechtigungen des aktuellen Benutzers auf dem lokalen Computer ausgeführt.

/p Kennwort

Gibt das Kennwort für das Benutzerkonto an, das im Parameter /u angegeben wurde. Wenn Sie diesen Parameter nicht festlegen, fordert das Skript Sie zur Eingabe des Kennworts auf und verdeckt den eingegebenen Text.

Beispiele

Beispiel 1:

Das folgende Beispiel exportiert die Konfiguration der Website Finanzen in die Datei C:\Finanzen\Finanzen.xml. Der Befehl gibt mit dem Parameter /sp den Metabasispfad der Website an (/lm/W3SVC/2) und exportiert mit dem Parameter /children alle Unterschlüssel der Konfiguration. Ferner werden mit dem Parameter /inherited die vererbten Eigenschaften in die Exportdatei aufgenommen. Dadurch wird sichergestellt, dass die Websitekonfiguration diese Eigenschaften auch bei einem Import in ein anderes System beibehält.

iiscnfg /export /f c:\Finanzen\Finanzen.xml /sp /lm/w3svc/2 /children /inherited

Daraufhin zeigt iiscnfg die folgende Erfolgsmeldung an:

Configuration exported from /lm/w3svc/2 to file c:\finance\finance.xml

Die resultierende Datei enthält alle im Pfad /lm/w3svc/2 eingeschlossenen Schlüssel und Unterschlüssel. Sie enthält auch den IisInheritedProperties-Schlüssel mit den Werten aller vererbten Eigenschaften.

Beispiel 2:

Das folgende Beispiel exportiert die IIS-Konfiguration des lokalen Computers in die Datei D:\IIStest\Config.xml. Mit dem Parameter /f wird der Dateiname und der Speicherort und mit dem Parameter /sp der Stammschlüssel (/) der Metabasis angegeben. Der Parameter /children fügt alle Unterschlüssel des Stammschlüssels rekursiv zu der Exportdatei hinzu. (Ohne den Parameter /children wird nur der Stammschlüssel exportiert.) Zum Verschlüsseln der Exportdatei verwendet der Befehl den Parameter /d und ein Kennwort.

iiscnfg /export /f d:\iistest\config.xml /sp / /children /d p@sswoRd61

Daraufhin zeigt iiscnfg die folgende Erfolgsmeldung an:

Configuration / has been exported to d:\iistest\config.xml

Selbst ein vollständiger Export der Konfigurationsdatei ist mit der Datei MetaBase.xml für das System nicht identisch. Der Sitzungsschlüssel, die Zugriffssteuerungslisten (ACLs) und Kennwörter unterscheiden sich.

Auf den ersten Blick ist die Verschlüsselung der Exportdatei nicht ersichtlich. Wenn Sie jedoch die verschlüsselte Version mit der unverschlüsselten Version derselben Datei vergleichen, sehen Sie, dass die Werte der sicheren Eigenschaften in der verschlüsselten Version verschieden sind. Die Datei kann deshalb ohne das Kennwort nicht in einem Importbefehl verwendet werden.

Produkte

Ressourcen

Lösungen

Downloads

Testversionen

Tools

TechNet-Support

Microsoft-Support