Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Appcmd.exe (IIS 8)

 

Betrifft: Windows Server 2012 R2, Windows Server 2012

IIS 8 Stellt ein Befehlszeilenprogramm Appcmd.exe, Konfigurieren und Abfragen von Objekten auf dem Webserver, und in Text- oder XML-Ausgabe zurückgeben. In den folgenden Beispielen werden die Aufgaben, die Sie mit abschließen können Appcmd.exe:

  • Erstellen und Konfigurieren von Websites, Anwendungen, Anwendungspools und virtuelle Verzeichnisse.

  • Starten und Beenden von Websites.

  • Starten, beenden und Anwendungspools wiederverwenden.

  • Anzeigen von Informationen zu Arbeitsprozessen und Anforderungen, die auf dem Webserver ausgeführt werden.

Appcmd.exe bietet konsistente Befehle für allgemeine Abfragen und Konfigurationsaufgaben, verringert die Komplexität der Syntax lernen. Beispielsweise können Sie die Liste -Befehl, um Informationen zu einem Objekt, z. B. eine Anwendung, oder Sie können die Hinzufügen Befehl zum Erstellen eines Objekts, z. B. eine Website.

Darüber hinaus können Sie Befehle zusammen komplexere Daten zu Objekten auf dem Webserver oder Aufgaben, die komplexer sind kombinieren. Sie können z. B. abschließen komplexe Aufgaben wie das Beenden von allen Standorten, die angefordert wurde, die länger als 60 Sekunden ausgeführt wurden.

Inhalt dieses Dokuments

Öffnen Sie Appcmd.exe wenn Sie konfigurieren möchten IIS 8 mithilfe einer Befehlsshellfenster.Appcmd.exe befindet sich im Verzeichnis %windir%\system32\inetsrv, das nur für das Administratorkonto oder Mitglieder der Gruppe Administratoren auf dem Computer verfügbar ist. Darüber hinaus müssen Mitglieder der Gruppe Administratoren starten Appcmd.exe mit erweiterten Berechtigungen anzeigen und Ändern von Einstellungen in den Konfigurationsdateien auf Serverebene: "Machine.config", der Datei Root Web.config (in der .NET Framework-Verzeichnis) und in der Datei ApplicationHost.config. Anzeigen oder Ändern von Web.config-Dateien in der Website oder Anwendung Verzeichnisse Benutzer benötigen Zugriff zum Lesen und Schreiben von Dateien in diesen Verzeichnissen.

System_CAPS_noteHinweis

Wenn Sie 64-Bit-Windows ausführen, verwenden Sie Appcmd.exe aus dem Verzeichnis %windir%\system32\inetsrv, nicht das %windir%\syswow64\inetsrv-Verzeichnis.

Um Appcmd.exe zu starten.

  1. Klicken Sie auf Starten, und klicken Sie dann auf Programme.

  2. Klicken Sie auf Zubehör, und klicken Sie dann auf Eingabeaufforderung.

  3. Geben Sie an der Befehlszeile cd %windir%\system32\inetsrv, und drücken Sie dann die EINGABETASTE.

System_CAPS_noteHinweis

Um den Befehl als Administrator ausführen, Maustaste das Symbol in der Start Menü, und klicken Sie dann auf als Administrator ausführen.

Appcmd.exe enthält integrierte Hilfe-Informationen. Zum Anzeigen von Hilfeinformationen über Appcmd.exe, geben Sie einen Befehl, und geben dann /?.

Beispielsweise, wenn Sie einführende Informationen zum anzeigen möchten Appcmd.exe, geben Sie den folgenden Befehl an der Befehlszeile, und drücken Sie dann die EINGABETASTE:

Appcmd /?

Anzeigen von Hilfeinformationen zu einem bestimmten Appcmd.exe Objekt, z. B. die Befehle, mit denen Sie mit der Website Objekt, geben Sie den folgenden Befehl an der Befehlszeile, und drücken Sie dann die EINGABETASTE:

Appcmd Site /?

Um Hilfeinformationen zu den Einstellungen anzuzeigen, die Sie mithilfe von konfigurieren können ein Appcmd.exe Objekt und Befehl, wie z. B. die Website Objekt und Hinzufügen Befehl, geben Sie Folgendes in die Befehlszeile eingeben und dann die EINGABETASTE drücken:

Appcmd Site hinzufügen /?

Verwenden Sie die Objekte in Appcmd.exe angeben, was Sie anzeigen oder in der Konfiguration ändern möchten. Zum Anzeigen einer Liste der Appcmd.exe Objekte, geben Sie den folgenden Befehl an der Befehlszeile, und drücken Sie dann die EINGABETASTE:

Appcmd /?

Sie können das Objekt anschließend mithilfe von Befehlen konfigurieren. Weitere Informationen zu Befehlen finden Sie unter Verwenden von Befehlen in Appcmd.exe.

Verwendung Appcmd.exe Befehle zum Anzeigen oder Ändern der Einstellungen für ein Appcmd.exe Objekt. Jedes dieser Objekte verfügt über Befehle, die Sie mit diesem Objekt arbeiten können. Um die Befehle für ein Objekt anzuzeigen, verwenden Sie die folgende Syntax:

Appcmd Objekt /?

Die Variable Objekt ist der Name des Objekts, für die Sie Befehle anzeigen möchten. Beispielsweise, um eine Liste der Befehle zum Anzeigen der Website Objekt, geben Sie den folgenden Befehl an der Befehlszeile, und drücken Sie dann die EINGABETASTE:

Appcmd Site /?

Weitere Informationen zu Appcmd.exe Objekte finden Sie unter Arbeiten mit Objekten in Appcmd.exe.

Geben Sie Werte für Attribute, wenn Sie die Ergebnisse eines Befehls Liste einschränken möchten, oder wenn Sie den Wert für ein Attribut ändern möchten ein Appcmd.exe Objekt.

Beispielsweise, um die Liste von Anwendungspools Netzwerkdienst konfiguriert Geben Sie den folgenden Befehl an der Befehlszeile, und drücken Sie dann die EINGABETASTE:

Appcmd Liste Apppool /processModel.identityType:NetworkService

Alternativ können Sie so konfigurieren Sie einen Anwendungspool namens Marketing Netzwerkdienst, geben den folgenden Befehl an der Befehlszeile, und drücken dann die EINGABETASTE:

Appcmd festlegen Apppool /apppool.name:Marketing /processModel.identityType:NetworkService

Die processModel.identityType Attribut wird in den beiden vorherigen Beispiele verwendet. Im ersten Beispiel schränkt das Attribut die Ergebnisse der Abfrage, indem auflisten nur Anwendungspools Netzwerkdienst konfiguriert sind. Im zweiten Beispiel gibt das Attribut an, dass der Anwendungspool Marketing die Identität Network Service verwenden.

In Windows 8 und Windows Server 2012 das AppHostConfig -Attribut wurde hinzugefügt. Das AppHostConfig -Attribut ermöglicht es Ihnen, eine AppHost-Konfigurationsdatei bearbeiten, die nicht die standardmäßige AppHost-Konfigurationsdatei. Obwohl dieses Attribut in vielen Situationen sinnvoll ist, werden ungültige Werte unter der folgenden Kombinationen der Verb-Objekt ignoriert wird:

Verb

Objekt

Starten oder beenden

Website

Starten Sie, beenden oder wiederverwenden

AppPool

Alle Verben

Ersatzanschluss

Alle Verben

Anforderung

Alle Verben

WP

In IIS 8, können Sie Einstellungen in Konfigurationsdateien auf Serverebene oder in der Web.config-Dateien, die in einem Ordner für einen Standort, eine Anwendung oder ein virtuelles Verzeichnis konfigurieren. Konfigurationsdateien auf Serverebene sind Machine.config, Root Web.config-Datei und "applicationHost.config". Diese drei Dateien sind nur für das Administratorkonto oder Mitglieder der Gruppe "Administratoren" auf dem Webserver zur Verfügung stehen. Darüber hinaus müssen Mitglieder der Gruppe der Administratoren ein Befehlsshellfenster öffnen, die ihre Administratorberechtigungen zum Lesen und ändern Sie die Einstellung in den Konfigurationsdateien auf Serverebene verwendet. Weitere Informationen zum Starten von Appcmd.exe in ein Befehlsshellfenster, die Administratorberechtigungen verwendet, finden Sie unter Starten von Appcmd.exe.

Standardmäßig ist "applicationHost.config" der Datei, aus der Appcmd.exe liest die Konfiguration und auf die Appcmd.exe schreiben. Lesen von oder Schreiben Änderungen an "Machine.config" oder der Datei Root Web.config gehören möchten eine commit Parameter im Befehl. Geben Sie Computer für die commit Parameter, wenn Sie Einfluss auf die Datei Machine.config oder WEBROOT angeben, wenn Sie die Datei Root Web.config beeinflussen möchten.

Z. B. zum Auflisten des Abschnitts MachineKey der Datei Web.config im Stammverzeichnis Geben Sie den folgenden Befehl an der Befehlszeile, und drücken Sie dann die EINGABETASTE:

Appcmd Liste Config /section:machineKey /commit:WEBROOT

In IIS 8, Sie können Einstellungen in Konfigurationsdateien auf Serverebene oder in der Web.config-Dateien für eine Website, eine Anwendung oder ein virtuelles Verzeichnis konfigurieren, auf dem Webserver. Anzeigen oder Ändern von Einstellungen in Web.config-Dateien in der Website oder Anwendung Verzeichnisse gelesen haben, müssen Benutzer und Schreibzugriff auf Dateien in diesen Verzeichnissen. Darüber hinaus müssen Sie Funktionen, die am Standort, der Anwendung oder eine Ebene des virtuellen Verzeichnisses in konfigurieren möchten Delegieren IIS 8. Weitere Informationen zu Konfigurationsdateien und Delegieren von Funktionen finden Sie unter Arbeiten mit Konfigurationsdateien in IIS 7.0 und Delegat-Website und Web Application Management.

Bei Verwendung Appcmd.exe Einstellungen in einer Web.config-Datei für eine bestimmte Site, eine Anwendung oder ein virtuelles Verzeichnis konfigurieren, geben Sie den Pfad zu der Website, eine Anwendung oder ein virtuelles Verzeichnis für die Anwendung die Konfiguration werden sollen. So deaktivieren Sie die standarddokumentfunktion für eine Website z. B. mit dem Namen Contoso, geben Sie den folgenden Befehl an der Befehlszeile, und drücken Sie dann die EINGABETASTE:

Appcmd set Config"Contoso"/section:defaultDocument / aktiviert: false

Im vorherigen Beispiel die Änderungen vorgenommen werden, in der Datei "Web.config" in der Contoso Verzeichnis und alle der Contoso Anwendungen und virtuellen Verzeichnissen, erben Sie die Konfiguration aus dieser Datei "Web.config". Jedoch wenn Sie für eine bestimmte Anwendung in Standarddokumente aktivieren möchten die Contoso -Website können Sie Appcmd.exe den Pfad der Anwendung angeben. Dokumente z. B. So aktivieren Sie die Standardeinstellung für eine Anwendung mit dem Namen Katalog, geben Sie den folgenden Befehl an der Befehlszeile, und drücken Sie dann die EINGABETASTE:

Appcmd set Config"Contoso/Galerie"/section:defaultDocument / enabled: true

Der Befehl im vorherigen Beispiel aktiviert die Standard-Dokumente für die Katalog -Anwendung in die Contoso Website und schreibt die Konfiguration geändert wird, in die Datei Web.config in der Galerie Verzeichnis.

Im vorherige Abschnitt wurde erläutert, wie mit Appcmd.exe Funktionen für eine bestimmte Site, eine Anwendung oder ein virtuelles Verzeichnis durch Schreiben von Änderungen in einer Web.config-Datei konfigurieren. Sie können auch Funktionen für einen bestimmten Standort, eine Anwendung, ein virtuelles Verzeichnis oder sogar einer URL konfigurieren, mithilfe von Speicherorttags in einer übergeordneten Konfigurationsdatei.

Wenn Sie Einstellungen für einen Standort, eine Anwendung oder ein virtuelles Verzeichnis konfigurieren möchten, aber die Einstellungen in einer übergeordneten Konfigurationsdatei speichern möchten, z. B. in "applicationHost.config" statt in der Datei Web.config, verwenden Sie die Appcmd.exe Commit Parameter mit dem Befehl.  Anhand der Beispiele im vorherigen Abschnitt können Sie jetzt die Änderungen an "applicationHost.config" anstelle von für die Website und eine Anwendung Web.config-Dateien schreiben.

Erstens So deaktivieren Sie die Standarddokumente der Website mit dem Namen Contoso, geben Sie den folgenden Befehl an der Befehlszeile, und drücken Sie dann die EINGABETASTE:

Appcmd set Config"Contoso"/section:defaultDocument / aktiviert: false /commit:APPHOST

Der vorherige Befehl deaktiviert die Standarddokumente für die Contoso Website und schreibt die Konfigurationsdateien mit einem geografischen Ort tag "applicationHost.config". Im Tag Location gibt an, dass die Konfiguration gilt die Contoso Website. Der Konfigurationsabschnitt ähnelt dem folgenden Beispiel:

<location path="Contoso">
      <system.webServer>
            <defaultDocument enabled="false" />
      </system.webServer>
</location>

Zweitens Standarddokumente für die Anwendung aktivieren Katalog, geben Sie den folgenden Befehl an der Befehlszeile, und drücken Sie dann die EINGABETASTE:

Appcmd set Config"Contoso/Galerie"/section:defaultDocument / enabled: true /commit:APPHOST

Der vorherige Befehl aktiviert die Standarddokumente für die Katalog Anwendung und die Konfigurationsdateien mit einem Speicherort an "applicationHost.config"-Tag schreibt. Im Tag Location gibt an, dass die Konfiguration gilt die Katalog Anwendung. Der Konfigurationsabschnitt sieht wie im folgenden Beispiel:

<location path="Contoso/Gallery">
      <system.webServer>
            <defaultDocument enabled="true" />
      </system.webServer>
</location>
Anzeigen: