Freigeben über


ASP.NET IIS-Registrierungstool (Aspnet_regiis.exe)

Das ASP.NET IIS-Registrierungstool (Aspnet_regiis.exe) dient zum Registrieren von ASP.NET-Anwendungen bei Internetinformationsdienste (IIS). In diesem Thema werden die Optionen, die Syntax und andere Informationen zum Verwenden des Tools beschrieben.

Mithilfe des ASP.NET IIS-Registrierungstools können Sie folgende Aufgaben durchführen:

  • Registrieren oder Entfernen der .NET Framework ASP.NET-Installation in IIS.

  • Erstellen von neuen ASP.NET-Anwendungspools.

  • Anzeigen des Status aller installierten Versionen von ASP.NET.

Wichtig

Die Version von Aspnet_regiis, die in .NET Framework, Version 4 enthalten ist, bietet neue Funktionen, die im Abschnitt Optionen zusammengefasst werden.Diese Funktionen sind nur jedoch verfügbar, wenn Sie .NET Framework 4 auf Windows Vista, Windows Server 2008 oder Windows 7 installieren.Wenn Sie .NET Framework, Version 4 auf einer beliebigen Version von Windows XP oder Windows Server 2003 installieren, funktioniert das Tool wie in Version 3.5 oder älteren Versionen von .NET Framework.Details darüber, wie Aspnet_regiis unter Windows XP oder Windows Server 2003 funktioniert, finden Sie unter ASP.NET IIS-Registrierungstool für .NET Framework Version 3.5.

.NET Framework 4 kann parallel mit früheren Versionen von .NET Framework auf einem einzelnen Computer installiert werden. Wenn IIS zuvor auf dem Computer aktiviert war, registriert der Installationsvorgang für .NET Framework ASP.NET 4 automatisch bei IIS. Wenn Sie jedoch .NET Framework 4 vor der Aktivierung von IIS installieren, müssen Sie das ASP.NET IIS-Registrierungstool ausführen, um .NET Framework bei IIS zu registrieren und Anwendungspools zu erstellen, die .NET Framework 4 verwenden.

Achtung

Informationen zum Ermitteln der richtigen Version von "Aspnet_regiis.exe" finden Sie weiter unten in diesem Dokument unter Suchen der richtigen Version von "Aspnet_regiis.exe".

aspnet_regiis [options]

Optionen

In der Regel sind die Optionen i, ir, iru und enable die einzigen Optionen, die erforderlich sind, um ASP.NET-Anwendungen bei IIS zu registrieren.

Option

Beschreibungen

-c

Legacyoption, die nicht gültig ist, wenn Sie Anwendungen unter ASP.NET, Version 4, ausführen. Informationen darüber, wie diese Funktion unter älteren Versionen von ASP.NET funktioniert, erhalten Sie unter ASP.NET IIS für .NET Framework, Version 3.5.

-disable

Unter IIS 6.0 und IIS 7.0 im klassischen Modus wird die ASP.NET-ISAPI-Erweiterung deaktiviert. Der Befehl gilt nicht für IIS 7.0 im integrierten Modus.

Diese Option kann nur mit der Option -i, -ir oder -r kombiniert werden. Sie steht nicht für IIS-Versionen vor IIS 6.0 zur Verfügung.

-e

Entfernt die Client-Skripte für ASP.NET aus dem aspnet_client-Unterverzeichnis jedes IIS-Siteverzeichnisses.

Es werden nur die Client-Skripte für die mit Aspnet_regiis.exe verbundene ASP.NET-Version entfernt.

-ea

Entfernt die Client-Skripte für alle Versionen von ASP.NET aus dem aspnet_client-Unterverzeichnis jedes IIS-Siteverzeichnisses.

-enable

Unter IIS 6.0 und IIS 7.0 im klassischen Modus wird mit der Option die ASP.NET-ISAPI-Erweiterung aktiviert. Der Befehl gilt nicht für IIS 7.0 im integrierten Modus.

Diese Option kann nur mit der Option -i, -ir oder -r kombiniert werden. Sie steht nicht für IIS-Versionen vor IIS 6.0 oder für ASP.NET-Versionen vor ASP.NET, Version 2.0, zur Verfügung.

-ga user

Gewährt dem angegebenen Benutzer bzw. der angegebenen Gruppe den Zugriff auf die IIS-Metabasis und andere Verzeichnissen, die von ASP.NET verwendet werden. Üblicherweise verwenden Sie diese Option, wenn Sie ein benutzerdefiniertes Dienstkonto erstellen. Weitere Informationen finden Sie unter Gewusst wie: Erstellen eines Dienstkontos für eine ASP.NET 2.0-Anwendung.

Diese Option steht nicht für ASP.NET-Versionen vor ASP.NET 2.0 zur Verfügung.

Für die Installation unter Windows Vista, Windows Server 2008 oder Windows 7 ermöglicht Ihnen diese Option, ACLs für Gruppen festzulegen.

Hinweis

Die Version von "Aspnet_regiis.exe", die in ASP.NET, Version 3.5 und früher, bereitgestellt wird, schlägt fehl, wenn ein lokaler Benutzer oder eine Gruppe angegeben wird.

-i

Installiert ASP.NET 4 und aktualisiert vorhandene Anwendungen auf die ASP.NET 4-Version des Anwendungspools. Der Befehl aktualisiert sowohl den Handler für den klassischen als auch für den integrierten IIS-Modus und die Skriptzuordnungen in der IIS-Metabasis.

Mit dieser Option werden die beiden neuen Anwendungspools ASP.NET v4.0 und ASP.NET v4.0 Classic erstellt. Der Anwendungspool DefaultAppPool und die Classic .NET AppPool-Anwendungspools werden auf die .NET Framework 4-Version der CLR festgelegt.

Die 32-Bit-Version von "Aspnet_regiis.exe" fügt der Datei "Applicationhost.config" nur 32-Bit-Skriptzuordnungen hinzu. Die 64-Bit-Version von "Aspnet_regiis.exe" fügt der Datei "Applicationhost.config" 32-Bit- und 64-Bit-Skriptzuordnungen hinzu. Hierbei wird so verfahren, da bei 64-Bit-Versionen von Windows Vista-, Windows Server 2008- oder Windows 7-Installationen, bei denen IIS 7.0 aktiviert wurde, auch Unterstützung für Windows auf Windows 64-Bit (WOW64) verfügbar ist.

Hinweis

Im Dialogfeld Windows-Funktionen des Betriebssystems ist die Option für ASP.NET-Integration nicht ausgewählt.(Diese Option ist im Abschnitt Internetinformationsdienste enthalten.) Das Dialogfeld Windows-Funktionen zeigt nur den Status der ASP.NET 2.0-Integration an.Es werden keine Informationen zu Version 4 angezeigt.

-ir

Installiert und registriert ASP.NET 4. Diese Option ist identisch mit der -i-Option, außer dass diese Option nicht die CLR-Version ändert, die bereits vorhandenen Anwendungspools zugeordnet ist.

-iru

Wenn ASP.NET derzeit nicht bei IIS registriert ist, werden die für -i beschriebenen Aufgaben ausgeführt.

Wenn eine frühere Version von ASP.NET bereits bei IIS registriert wird, führt diese Option die für -ir beschriebenen Aufgaben aus.

-k path

Diese Option wird nicht unter Windows Vista, Windows Server 2008 oder Windows 7 unterstützt.

Informationen darüber, wie diese Funktion unter Windows XP oder Windows Server 2003 funktioniert, finden Sie unter ASP.NET IIS für .NET Framework, Version 3.5.

-kn path

Diese Option wird nicht unter Windows Vista, Windows Server 2008 oder Windows 7 unterstützt.

Informationen darüber, wie diese Funktion unter Windows XP oder Windows Server 2003 funktioniert, finden Sie unter ASP.NET IIS für .NET Framework, Version 3.5.

-lk

Listet den Pfad und die Version aller IIS-Metabasisschlüssel auf, in denen ASP.NET zugeordnet ist. Diese Option wird nicht unter Windows Vista und höheren Versionen unterstützt.

Die Schlüssel, die ASP.NET-Skriptzuordnungen von einem übergeordneten Schlüssel erben, werden nicht angezeigt.

-lv

Listet den Status und den Installationspfad aller auf dem Computer installierten Versionen von ASP.NET auf.

-norestart

Diese Option wird nicht unter Windows Vista, Windows Server 2008 oder Windows 7 unterstützt.

Informationen darüber, wie diese Funktion unter Windows XP oder Windows Server 2003 funktioniert, finden Sie unter ASP.NET IIS für .NET Framework, Version 3.5.

-r

Führt die für -i beschriebenen Aufgaben aus und stellt zudem alle Anwendungspools auf die .NET Framework 4-CLR um.

-s path

Aktualisiert Skriptzuordnungen und Anwendungspoolzuweisungen für die angegebene Anwendung und für alle Unteranwendungen.

Bei einer nicht stammbezogenen Webanwendung (nicht W3SVC\ oder W3SVC\ROOT) werden die Anwendungspooleinstellungen für die nicht stammbezogene Webanwendung und alle Unteranwendungen in einen neuen Anwendungspool mit dem Namen ASP.NET V4.0 ursprünglicher Anwendungspoolname kopiert, und die nicht stammbezogene Webanwendung wird anschließend in den neuen Anwendungspool verschoben. Der neue Anwendungspool verfügt über die gleichen Einstellungen wie der ursprüngliche Anwendungspool, außer, dass die Kopie der .NET Framework 4 CLR zugeordnet wird und ASP.NET 4-Einstellungen besitzt.

Wenn der neue Anwendungspool ASP.NET V4.0 Ursprünglicher Anwendungspoolname bereits vorhanden ist, wird der Schritt zum Erstellen und Klonen des Anwendungspools übersprungen. Stattdessen verwendet "Aspnet_regiis.exe" den vorhandenen Anwendungspool und legt ihn fest, um .NET Framework 4 CLR verwenden zu können. Weitere Änderungen werden hingegen nicht vorgenommen. Das Tool verschiebt anschließend die angegebene Anwendung und die Unteranwendungen in die entsprechende Anwendungspoolkopie. Vorhandene Anwendungspooleinstellungen werden unverändert gelassen.

Wenn die angegebene Anwendung der Webstamm ist, aktualisiert "Aspnet_regiis.exe" ("W3SVC \" oder "W3SVC\ROOT") alle Anwendungspools, damit die .NET Framework 4-CLR und ASP.NET 4 verwendet werden.

-sn path

Führt die für -s beschriebenen Aufgaben aus, abgesehen davon, dass -sn nicht rekursiv ist. Aktualisiert Skriptzuordnungen und Anwendungspoolzuweisungen ausschließlich für die betreffende Anwendung. Es werden keine Teilanwendungen geändert.

Wenn die angegebene Anwendung der Webstamm ist (W3SVC\ oder W3SVC\ROOT), ändert "Aspnet_regiis.exe" die Anwendungspools DefaultAppPool, Classic .NET AppPool, ASP.NET V4.0 und ASP.NET  V4.0 Classic, damit die .NET Framework 4-CLR und ASP.NET 4 verwendet werden.

-u

Zur Deinstallation werden die zwei 4-Versionen der Anwendungspools und alle Anwendungen verlassen, die sich in den zwei Anwendungspools von Version 4 befanden.

Diese Option entfernt auch das **managedRuntimeVersion**-Attribut der Anwendungspools, die der .NET Framework 4 CLR zugeordnet wurden. Dadurch werden die Anwendungspools auf den IIS 7.0-Standardwert für die Laufzeit zurückgesetzt, der in Windows Vista, Windows Server 2008 oder Windows 7 2.0 ist.

Mit der Option werden alle explizit festgelegten Handler und Modulzuordnungen der Version 4 entfernt. Zudem werden alle Skriptzuordnungen (32-Bit und 64-Bit) unabhängig davon entfernt, ob die 32-Bit- oder 64-Bit-Version von "Aspnet_regiis.exe" verwendet wird.

-ua

Zur Deinstallation werden die zwei 4-Versionen der Anwendungspools und alle Anwendungen verlassen, die sich in den zwei Anwendungspools von Version 4 befanden.

Mit dieser Option werden alle ASP.NET-Registrierungen (sowohl Versionen 2.0 als auch 4) aus der Datei "Applicationhost.config" entfernt. Zudem werden alle Skriptzuordnungen (32-Bit und 64-Bit) unabhängig davon entfernt, ob die 32-Bit- oder 64-Bit-Version von "Aspnet_regiis.exe" verwendet wird.

Bereits vorhandene Anwendungspools bleiben weiterhin .NET Framework 2.0 zugeordnet, da das der Standardwert für das **managedRuntimeVersion**-Attribut ist.

-?

Zeigt die Befehlssyntax und Optionen für das ASP.NET IIS-Registrierungstool an.

Konfigurationsoptionen

Option

Beschreibungen

-config+

Aktiviert Remotezugriff auf ASP.NET-Konfiguration.

-config-

Deaktiviert Remotezugriff auf ASP.NET-Konfiguration.

-pa container account

Gewährt dem angegebenen Benutzer bzw. der angegebenen Gruppe account den Zugriff auf den angegebenen Schlüsselcontainer. Diese Option kann die folgenden Modifizierer aufweisen:

  • -pku   Ersetzt den Standardcontainer des Computers durch einen vom Benutzer angegebenen Container.

  • -csp provider   Gibt den zu verwendenden Containeranbieter an.

  • -full   Gibt an, dass Vollzugriff gewährt werden soll (standardmäßig ist der Zugriff schreibgeschützt).

-pc container

Erstellt im angegebenen Container ein RSA-Schlüsselpaar aus öffentlichem und privatem Schlüssel. Diese Option kann die folgenden Modifizierer aufweisen:

  • -size keySize   Gibt die Schlüsselgröße an. Der Standardwert ist 2048 Bytes.

  • -pku   Ersetzt den Standardschlüssel des Computers durch einen vom Benutzer angegebenen Container.

  • -exp   Gibt an, dass es möglich sein muss, dass private Schlüssel exportiert werden.

  • -csp provider   Gibt den zu verwendenden Containeranbieter an.

-pd section

Entschlüsselt den Konfigurationsabschnitt. Für dieses Argument sind die folgenden Parameter gültig:

  • -app virtualPath   Gibt an, dass die Entschlüsselung auf der Ebene des enthaltenen Pfads erfolgen soll.

  • -location subPath   Gibt das zu entschlüsselnde Unterverzeichnis an.

  • -pkm   Gibt an, dass statt der Datei Web.config die Datei Machine.config entschlüsselt werden soll.

-pdf section webApplicationDirectory

Entschlüsselt den angegebenen Konfigurationsabschnitt der Datei Web.config im angegebenen physischen Verzeichnis (nicht im virtuellen).

-pe section

Entschlüsselt den angegebenen Konfigurationsabschnitt. Diese Option kann die folgenden Modifizierer aufweisen:

  • -prov provider   Gibt den zu verwendenden Verschlüsselungsanbieter an.

  • -app virtualPath   Gibt an, dass die Verschlüsselung auf der Ebene des enthaltenen Pfads erfolgen soll.

  • -location subPath   Gibt das zu verschlüsselnde Unterverzeichnis an.

  • -pkm   Gibt an, dass statt der Datei Web.config die Datei Machine.config verschlüsselt werden soll.

-pef section webApplicationDirectory

Verschlüsselt den angegebenen Konfigurationsabschnitt der Datei Web.config im angegebenen physischen Verzeichnis (nicht im virtuellen).

-pi container file

Importiert ein RSA-Schlüsselpaar aus öffentlichem und privatem Schlüssel aus der angegebenen XML-file in den angegebenen container. Diese Option kann die folgenden Modifizierer aufweisen:

  • -pku   Ersetzt den Standardcontainer des Computers durch einen vom Benutzer angegebenen Container.

  • -exp   Gibt an, dass private Schlüssel exportiert werden können.

  • -csp provider   Gibt den zu verwendenden Containeranbieter an.

-pr container account

Entzieht dem angegebenen Benutzer bzw. der angegebenen Gruppe account die Genehmigung zum Zugriff auf den angegebenen Schlüsselcontainer. Diese Option kann die folgenden Modifizierer aufweisen:

  • -pku   Ersetzt den Standardcontainer des Computers durch einen vom Benutzer angegebenen Container.

  • -csp provider   Gibt den zu verwendenden Containeranbieter an.

-px container file

Exportiert ein RSA-Schlüsselpaar aus öffentlichem und privatem Schlüssel aus dem angegebenen Container in die angegebene XML-Datei. Diese Option kann die folgenden Modifizierer aufweisen:

  • -pku   Ersetzt den Standardcontainer des Computers durch einen vom Benutzer angegebenen Container.

  • -csp provider   Gibt den zu verwendenden Containeranbieter an.

-pz container

Löscht den angegebenen Schlüsselcontainer. Diese Option kann den folgenden Modifizierer aufweisen:

  • -pku   Ersetzt den Standardcontainer des Computers durch einen vom Benutzer angegebenen Container.

Hinweise

Wenn mehrere Versionen von ASP.NET auf einem Computer installiert sind, werden die Versionen von ASP.NET gemäß Definition parallel ausgeführt. In diesem Szenario muss IIS (Internet Information Services, Internetinformationsdienste) so konfiguriert werden, dass angegeben wird, von welcher Version von ASP.NET ISAPI ("aspnet_isapi.dll" ) eine Seite in einer ASP.NET-Anwendung verarbeitet werden soll. In IIS 7.0 wird sowohl im klassischen als auch im integrierten Modus durch die für den Anwendungspool festgelegte CLR-Version bestimmt, welche Version von ASP.NET und welche zugehörige Version der CLR verwendet wird, um eine Anwendung auszuführen. In IIS 6.0 dient eine Skriptzuordnung für die Zuordnung einer Anwendung zu einer bestimmten ASP.NET ISAPI-Version, und durch die ISAPI-Version wird wiederum bestimmt, mit welcher Version der CLR die Anwendung ausgeführt wird.

Es gibt 32-Bit- und 64-Bit-Versionen von "Aspnet_regiis.exe". Für Windows Vista und Windows Server 2008 können Sie auf einer 64-Bit-Installation des IIS die 32-Bit-Version des Tools ausführen. Dadurch können auf dem gleichen 64-Bit-System gemischte 32-Bit- und 64-Bit-Arbeitsprozesse ausgeführt werden. In der folgenden Tabelle werden besondere Fälle und Einschränkungen aufgeführt, die zutreffen, wenn Sie die 32-Bit-Version des Tools auf einer 64-Bit-Version von IIS ausführen.

IIS-Version

Besondere Fälle für 32-Bit-Versionen von "Aspnet_regiis.exe"

6.0

Sie können die 32-Bit-Version von "Aspnet_regiis.exe" unter einer 64-Bit-Installation von IIS 6.0 auf Windows Server 2003 ausführen. Dabei gelten die folgenden Einschränkungen:

  • Die 32-Bit-Version wird nur ausgeführt, wenn IIS für die Ausführung im 32-Bit-Modus festgelegt wurde.

  • Die 64-Bit-Version wird nur ausgeführt, wenn IIS für die Ausführung im 64-Bit-Modus festgelegt wurde.

7.0

In Windows Vista, Windows Server 2008 oder Windows 7 wird das **enable32BitAppOnWin64**-Attribut des **applicationPools**-Elements beim Ausführen der 32-Bit-Version von "Aspnet_regiis.exe" unter IIS 7 nicht automatisch festgelegt. In einer standardmäßigen 64-Bit-Betriebssysteminstallation, bei der Windows unter Windows 64 aktiviert ist, können Sie "Aspnet_regiis.exe" (32-Bit) zum Konfigurieren von IIS 7 verwenden. Sie können jedoch nur dann 32-Bit-Anwendungen ausführen, wenn Sie das **enable32BitAppOnWin64**-Attribut ausdrücklich ändern, um die Ausführung der Anwendung in Windows unter Windows 64 zu ermöglichen. Weitere Informationen zu IIS 7.0-Konfigurationsoptionen finden Sie in der Dokumentation für das applicationPools-Element in der Datei Applicationhost.config.

Das ASP.NET IIS-Registrierungstool wird i. d. R. mit der Option -s oder -sn verwendet, um eine ASP.NET-Anwendung der mit dem Tool verbundenen Version von .NET Framework zuzuordnen. Mit der Option -s können Sie eine Anwendung im angegebenen Pfad zum Stammverzeichnis und in den Unterverzeichnissen aktualisieren. Wenn Anwendungen in Unterverzeichnissen nicht aktualisiert werden sollen, verwenden Sie die Option -sn.

Hinweis

Der path-Parameter bezieht sich auf den Pfad zum Stammverzeichnis der Anwendung, nicht auf den physischen Pfad.Beispielsweise W3SVC/1/ROOT/SampleApp1.

Mit dem ASP.NET IIS-Registrierungstool können ebenfalls Informationen zu ASP.NET angezeigt werden. Um den Status und den Installationspfad aller Versionen von ASP.NET aufzulisten, die auf dem Computer installiert sind, verwenden Sie die -lv-Option.

Die -norestart-Option verhindert einen Neustart des WWW-Publishingdiensts nach der Installation oder Aktualisierung von ASP.NET-Skriptzuordnungen. Wenn Sie mehrere Websites in IIS in verschiedenen Anwendungspools ausführen und Sie nicht möchten, dass alle Websites neu gestartet werden, verwenden Sie diese Option.

Alle Änderungen, die Sie auf der Registerkarte ASP.NET der IIS-Konsolenanwendung vorgenommen haben, führen ebenfalls dazu, dass alle Anwendungspools wiederverwendet werden. Wenn Sie die ASP.NET-Version einer Anwendung ändern möchten, ohne dass alle Anwendungspools wiederverwendet werden, führen Sie die folgenden zwei Befehle aus, um die Version zu ändern.

aspnet_regiis -s w3svc/<instance>/root -norestart
iisapp /a <app pool> /r

Mit dem ASP.NET IIS-Registrierungstool kann auch die verknüpfte Version von ASP.NET installiert oder deinstalliert werden. Mit der Option -i können Sie ASP.NET installieren und die Skriptzuordnungen aller vorhandenen ASP.NET-Anwendungen aktualisieren. Mit der Option -ir können Sie ASP.NET installieren, ohne die Skriptzuordnungen zu aktualisieren. Mit der Option -u können Sie die dem Tool zugeordnete ASP.NET-Version deinstallieren. Wenn Sie alle Versionen von ASP.NET auf dem Computer deinstallieren möchten, verwenden Sie die Option -ua.

Mit dem ASP.NET IIS-Registrierungstool können ebenfalls Informationen zu ASP.NET angezeigt werden. Um den Status und den Installationspfad aller Versionen von ASP.NET aufzulisten, die auf dem Computer installiert sind, verwenden Sie die -lv-Option. Mit der Option -lk können Sie die Pfade zu allen IIS-Metabasisschlüsseln anzeigen, denen ASP.NET zugeordnet ist.

Mit "Aspnet_regiis.exe" können Sie clientseitige Systemskripts installieren und entfernen, z. B. ein Skript für die clientseitige Validierung. Mit der Option -c können Sie das Clientskript für die dem Tool zugeordnete Version von ASP.NET installieren. (Das Skript wird im Unterverzeichnis "Aspnet_client" jedes IIS-Siteverzeichnisses installiert.) Verwenden Sie die Option -e, wenn Sie nur das clientseitige Skript für die dem Tool zugeordnete ASP.NET-Version entfernen möchten. Wenn Sie das clientseitige Skript für alle installierten ASP.NET-Versionen löschen möchten, verwenden Sie die Option -ea.

Wenn Sie den Identitätswechsel verwenden und das Konto für den Identitätswechsel keinen Lesezugriff auf die IIS-Metabasis hat, wird eine COMException-Ausnahme mit der Meldung "Zugriff verweigert" ausgelöst, sobald Sie versuchen, auf DirectoryEntry zuzugreifen. Dies kann auftreten, wenn das Codeunterverzeichnis der Anwendung im Stammverzeichnis der Anwendung enthalten ist. Der Fehler kann auch auftreten, wenn eine Anwendung einer UNC-Freigabe zugewiesen ist, und das UNC-Konto keinen Lesezugriff auf die IIS-Metabasis hat. In beiden Fällen kann das Problem behoben werden, indem Sie das ASP.NET IIS-Registrierungstool mit der -ga user-Option für das Konto für den Identitätswechsel oder das UNC-Konto ausführen.

Weitere Informationen zu Skriptzuordnungen und dem Pfad des Anwendungsstamms finden Sie in der IIS-Dokumentation auf der Microsoft-Website.

Beispiele

Durch den folgenden Befehl wird die der verwendeten Version des ASP.NET IIS-Registrierungstools zugeordnete ASP.NET-Version installiert, und vorhandene ASP.NET-Anwendungen werden aktualisiert. In IIS 6.0 aktualisiert der Befehl die Skriptzuordnungen vorhandener ASP.NET-Anwendungen, die aktuell einer früheren Version von ASP.NET zugeordnet sind. In IIS 7.0 werden mit dem Befehl sowohl der Handler für den klassischen als auch für den integrierten Modus in der IIS-Metabasis aktualisiert. Außerdem werden die Anwendungspools DefaultAppPool und Classic  .NET AppPool auf die Verwendung der .NET Framework 4-CLR festgelegt.

aspnet_regiis -i

Mit dem folgenden Befehl wird die dem Tool zugeordnete ASP.NET-Version installiert, ohne vorhandene Anwendungen zu aktualisieren. Unter IIS 7.0 aktualisiert der Befehl nicht die Version von .NET Framework, die den Anwendungspools DefaultAppPool und Classic .NET AppPool zugeordnet ist.

aspnet_regiis -ir

Durch den folgenden Befehl werden der Status und der Installationspfad aller auf dem Computer installierten ASP.NET-Versionen angezeigt.

aspnet_regiis -lv

Mit dem folgenden Befehl werden eine Webanwendung und alle zugehörigen Unteranwendungen für die Verwendung der dem Tool zugeordneten ASP.NET-Version aktualisiert. Unter IIS 6.0 werden die Skriptzuordnungen aktualisiert. Unter IIS 7.0 wird die Anwendung einem neuen Anwendungspool zugeordnet.

aspnet_regiis -s W3SVC/1/ROOT/SampleApp1

Der folgende Befehl führt die gleichen Funktionen wie der -s-Befehl aus, abgesehen davon, dass Anwendungen in Unterverzeichnissen nicht betroffen sind.

aspnet_regiis -sn W3SVC/1/ROOT/SampleApp1

Durch den folgenden Befehl erhalten die angegebenen Benutzer- bzw. Gruppenkontos Zugriff auf die IIS-Metabasis und die anderen Verzeichnissen, die von ASP.NET verwendet werden.

aspnet_regiis -ga MyUserGroup W3SVC/1/ROOT/SampleApp1

Suchen der richtigen Version von "Aspnet_regiis.exe"

Aspnet_regiis.exe ist im Verzeichnis von Microsoft.NET Framework installiert. Wenn auf dem Computer mehrere .NET Framework-Versionen parallel ausgeführt werden, werden unter Umständen mehrere Versionen des Tools installiert. In der folgenden Tabelle sind die Orte aufgeführt, an denen das Tool für andere Versionen von .NET Framework installiert ist.

Version von .NET Framework

Speicherort der Datei "Aspnet_regiis.exe"

.NET Framework, Version 1

%windir%\.NET\Framework\v1.0.3705

.NET Framework, Version 1.1

%windir%\Microsoft.NET\Framework\v1.1.4322

.NET Framework, Version 2.0, Version 3.0 und Version 3.5 (32-Bit-Systeme)

%windir%\Microsoft.NET\Framework\v2.0.50727

.NET Framework, Version 2.0, Version 3.0 und Version 3.5 (64-Bit-Systeme)

%windir%\Microsoft.NET\Framework64\v2.0.50727

.NET Framework, Version 4 (32-Bit-Systeme)

%windir%\Microsoft.NET\Framework\v4.0.30319

.NET Framework, Version 4 (64-Bit-Systeme)

%windir%\Microsoft.NET\Framework64\v4.0.30319

Verzeichnisse für .NET Framework, Versionen 3.0 und 3.5, haben keine Kopie des Tools. Weitere Informationen finden Sie unter How to set an IIS Application or AppPool to use ASP.NET 3.5 rather than 2.0 im Blog von Scott Hanselman.

Siehe auch

Konzepte

Parallele Ausführung

Weitere Ressourcen

ASP.NET IIS-Registrierungstool für .NET Framework, Version 3.5

.NET Framework-Tools