ASP.NET IIS Registration, outil (Aspnet_regiis.exe)
L'outil ASP.NET IIS Registration (Aspnet_regiis.exe) est utilisé pour inscrire des applications ASP.NET auprès d'IIS. Cette rubrique décrit les options, la syntaxe et d'autres informations pour l'utilisation de l'outil.
À l'aide de l'outil ASP.NET IIS Registration, vous pouvez effectuer notamment les tâches suivantes :
Inscrire ou supprimer l'installation du .NET Framework ASP.NET auprès IIS.
Créer des pools d'applications ASP.NET.
Afficher l'état de toutes les versions installées d'ASP.NET.
Important
La version d'Aspnet_regiis incluse avec .NET Framework version 4a de nouvelles fonctionnalités et fonctions, résumées dans la section Options.Toutefois, ces fonctionnalités sont disponibles uniquement lorsque vous installez .NET Framework 4 sur Windows Vista, Windows Server 2008ou Windows 7.Si vous installez le .NET Framework version 4 sur la version de Windows XP ou de Windows Server 2003, l'outil fonctionne pareillement que dans les versions 3.5 et antérieures du .NET Framework.Pour plus d'informations sur le fonctionnement d'Aspnet_regiis sur Windows XP ou Windows Server 2003, consultez l'Outil ASP.NET IIS Registration de .NET Framework version 3.5.
Le .NET Framework 4 peut être installé avec des versions antérieures du .NET Framework sur un ordinateur unique. Si IIS a été activé précédemment sur l'ordinateur, le processus d'installation du .NET Framework inscrit automatiquement ASP.NET 4 auprès d'IIS. Toutefois, si vous installez .NET Framework 4 avant d'activer IIS, vous devez exécuter l'outil ASP.NET IIS Registration afin d'inscrire le .NET Framework auprès d'IIS et créer des pools d'applications qui utilisent .NET Framework 4.
Avertissement
Pour plus d'informations sur la recherche de la version correcte d'Aspnet_regiis.exe, consultez Recherche de la version correcte d'Aspnet_regiis.exe plus loin dans ce document.
aspnet_regiis [options]
Options
Les options i, ir, iru et enable sont généralement les seules options dont vous avez besoin pour inscrire les applications ASP.NET auprès d'IIS.
Option |
Description |
|---|---|
-c |
Option héritée qui ne s'applique pas lorsque vous lancez des applications sous ASP.NET version 4. Pour plus d'informations sur le fonctionnement de cette option avec les versions antérieures d'ASP.NET, consultez l'Outil ASP.NET IIS Registration pour .NET Framework version 3.5 |
-disable |
Sur IIS 6.0 et IIS 7.0 fonctionnant en mode Classique, désactive l'extension ISAPI ASP.NET. La commande ne s'applique pas à IIS 7.0 en mode intégré. Cette option peut être associée uniquement aux options -i, -ir ou -r. Elle n'est pas disponible avec les versions IIS antérieures à IIS 6.0. |
-e |
Supprime les scripts clients correspondant à ASP.NET du sous-répertoire aspnet_client de chaque répertoire de site IIS. Seuls les scripts clients correspondant à la version d'ASP.NET qui est associée à Aspnet_regiis.exe sont supprimés. |
-ea |
Supprime les scripts clients correspondant à toutes les versions d'ASP.NET du sous-répertoire aspnet_client de chaque répertoire de site IIS. |
-enable |
Sur IIS 6.0 et IIS 7.0 en mode classique, l'option permet l'extension ISAPI ASP.NET. La commande ne s'applique pas à IIS 7.0 en mode intégré. Cette option peut être associée uniquement aux options -i, -ir ou -r. Elle n'est pas disponible avec les versions IIS antérieures à IIS 6.0 ou avec les versions d'ASP.NET antérieures à ASP.NET 2.0. |
-ga user |
Accorde à l'utilisateur ou au groupe spécifié l'accès à la métabase IIS et à d'autres répertoires utilisés par ASP.NET. Cette option est généralement utilisée lors de la création d'un compte de service personnalisé. Pour plus d'informations, consultez How to: Create a Service Account for an ASP.NET 2.0 Application. Cette option n'est pas disponible avec les versions d'ASP.NET antérieures à ASP.NET 2.0. Pour les installations sur Windows Vista, Windows Server 2008ou Windows 7, cette option vous permet de définir des ACL pour les groupes. .gif "Remarque") Remarque
La version d'Aspnet_regiis.exe qui est fournie dans la version 3.5 et dans les versions antérieures d'ASP.NET échoue lors de la spécification d'un utilisateur ou groupe local.
|
-i |
Installe ASP.NET 4 et met à jour les applications existantes de sorte qu'elles utilisent la version ASP.NET 4 du pool d'applications. Elle met à jour à la fois le gestionnaire en mode classique et en mode intégré d'IIS, ainsi que les mappages de scripts dans la métabase IIS. Cette option crée les deux pools d'applications ASP.NET v4.0 et ASP.NET v4.0 Classic. Le pool d'applications DefaultAppPool et les pools d'applications Classic .NET AppPool sont configurés pour utiliser la version .NET Framework 4 du CLR. La version 32 bits d'Aspnet_regiis.exe ajoute uniquement des mappages de scripts 32 bits au fichier Applicationhost.config. La version 64 bits d'Aspnet_regiis.exe ajoute des mappages de scripts 32 bits et 64 bits au fichier Applicationhost.config. Cela est fait parce que les versions 64 bits des installations de Windows Vista, Windows Server 2008 ou Windows 7 qui ont IIS 7.0 activé auront également la prise en charge Windows sur Windows 64 bits (WOW64) disponible. Remarque
Dans la boîte de dialogue Fonctionnalités Windows du système d'exploitation, l'option pour l'intégration d'ASP.NET n'est pas sélectionnée.(Cette option est dans la section Services IIS (Internet Information Services).) La boîte de dialogue Fonctionnalités Windows affiche uniquement l'état d'intégration d'ASP.NET 2.0.Il n'affiche pas d'informations à propos de la version 4.
|
-ir |
Installe et inscrit ASP.NET 4. Cette option est identique à l'option -i. Toutefois, elle ne modifie pas la version CLR qui est associée à tous les pools d'applications existants. |
-iru |
Si ASP.NET n'est pas enregistré actuellement avec IIS, les tâches décrites pour -i sont effectuées. Si une version antérieure ASP.NET est déjà enregistrée avec IIS, cette option effectue les tâches décrites pour -ir. |
-k path |
Cette option n'est pas prise en charge sous Windows Vista, Windows Server 2008 ou Windows 7. Pour plus d'informations sur le fonctionnement de cette option sous Windows XP ou Windows Server 2003, consultez l' Outil ASP.NET IIS Registration Tool pour .NET Framework version 3.5. |
-kn path |
Cette option n'est pas prise en charge sous Windows Vista, Windows Server 2008 ou Windows 7. Pour plus d'informations sur le fonctionnement de cette option sous Windows XP ou Windows Server 2003, consultez l' Outil ASP.NET IIS Registration Tool pour .NET Framework version 3.5. |
-lk |
Répertorie le chemin d'accès et la version de toutes les clés de la métabase IIS où ASP.NET est mappé. Cette option n'est pas prise en charge sur Windows Vista et versions ultérieures. Les clés qui héritent des scriptmaps ASP.NET d'une clé parente ne sont pas affichées. |
-lv |
Répertorie l'état et le chemin d'installation de toutes les versions d'ASP.NET installées sur l'ordinateur. |
-norestart |
Cette option n'est pas prise en charge sous Windows Vista, Windows Server 2008 ou Windows 7. Pour plus d'informations sur le fonctionnement de cette option sous Windows XP ou Windows Server 2003, consultez l' Outil ASP.NET IIS Registration Tool pour .NET Framework version 3.5. |
-r |
Effectue les tâches décrites pour -i et de plus bascule tous les pools d'applications pour utiliser le CLR de .NET Framework 4. |
-s path |
Met à jour des scriptmaps et des assignations de pools d'applications pour l'application spécifiée et toutes les sous-applications. Pour une application Web non racine (pas W3SVC\ ou W3SVC\ROOT), les paramètres du pool d'applications pour l'application Web non racine et toutes ses sous-applications sont copiés vers un nouveau pool d'applications nommé ASP.NET V4.0 nom de pool d'applications d'origine, et l'application Web non racine est ensuite déplacée vers le nouveau pool d'applications. Le nouveau pool d'applications a les mêmes paramètres que le pool d'applications d'origine, mais la copie est mappée au CLR du .NET Framework 4 et a des paramètres ASP.NET 4. Si le nouveau pool d'applications ASP.NET V4.0 nom du pool d'applications d'origine existe déjà, l'étape de création et de clonage du pool d'applications est ignorée. À la place, Aspnet_regiis.exe utilise le pool d'applications existant et le configure de manière à utiliser le CLR de .NET Framework 4, mais n'apporte pas d'autres modifications. L'outil déplace alors l'application spécifiée et ses sous-applications vers la copie de pool d'applications correspondante. Les paramètres du pool d'application existants restent inchangés. Si l'application spécifiée est la racine Web (W3SVC \ ou W3SVC\ROOT), Aspnet_regiis.exe met à jour tous les pools d'applications pour utiliser le CLR de .NET Framework 4 et ASP.NET 4. |
-sn path |
Effectue les tâches décrites pour -s, sauf que -sn n'est pas récursif. Met à jour des scriptmaps et des assignations de pools d'applications pour l'application spécifique uniquement. Aucune sous-application n'est modifiée. Si l'application spécifiée est la racine Web (W3SVC\ ou W3SVC\ROOT), Aspnet_regiis.exe modifie les pools d'applications nommés DefaultAppPool, Classic .NET AppPool, ASP.NET V4.0 et ASP.NET V4.0 Classic pour utiliser le CLR de .NET Framework 4 et ASP.NET 4. |
-u |
Pour la désinstallation, conserve les deux versions 4 des pools d'applications ainsi que toutes les applications qui figuraient dans les deux pools d'applications version 4. Cette option supprime également l'attribut managedRuntimeVersion des pools d'applications mappés au CLR de .NET Framework 4. Cela rétablit les pools d'applications à la valeur par défaut d'IIS 7.0 pour l'exécution, à savoir 2.0 sur Windows Vista, Windows Server 2008 ou Windows 7. L'option supprime tout gestionnaire version 4 et mappage de module défini explicitement. Il supprime également tous les scriptmaps (32 bits et 64 bits), peu importe que la version 32 bits ou 64 bits d'Aspnet_regiis.exe soit utilisée. |
-ua |
Pour la désinstallation, conserver les deux versions 4 des pools d'applications ainsi que toutes les applications qui figuraient dans les deux pools d'application version 4. Cette option supprime toutes les inscriptions ASP.NET (versions 2.0 et 4) du fichier Applicationhost.config. Il supprime également tous les scriptmaps (32 bits et 64 bits), peu importe que la version 32 bits ou 64 bits d'Aspnet_regiis.exe soit utilisée. Les pools d'applications existants seront encore associés au .NET Framework 2.0, car c'est la valeur par défaut de l'attribut managedRuntimeVersion. |
-? |
Affiche la syntaxe de commande et les options de l'outil ASP.NET IIS Registration. |
Options de configuration
Option |
Description |
|---|---|
-config+ |
Permet l'accès à distance à la configuration ASP.NET. |
-config- |
Désactive l'accès à distance à la configuration ASP.NET. |
-pa compte de conteneur |
Attribue au compte (account) d'utilisateur ou de groupe spécifié des autorisations d'accès au conteneur de clé indiqué. Cette option peut accepter les modificateurs suivants :
|
-pc conteneur |
Crée une paire de clés publique/privée RSA dans le conteneur spécifié. Cette option peut accepter les modificateurs suivants :
|
-pd section |
Déchiffre la section de configuration. Cet argument peut prendre les paramètres suivants :
|
-pdf section webApplicationDirectory |
Déchiffre la section de configuration spécifiée du fichier Web.config dans le répertoire physique (pas virtuel) spécifié. |
-pe section |
Chiffre la section de configuration spécifiée. Cette option peut accepter les modificateurs suivants :
|
-pef section webApplicationDirectory |
Chiffre la section de configuration spécifiée du fichier Web.config dans le répertoire physique (pas virtuel) spécifié. |
-pi fichier conteneur |
Importe une paire de clés publique/privée RSA vers le container spécifié du file XML indiqué. Cette option peut accepter les modificateurs suivants :
|
-pr compte de conteneur |
Supprime pour le compte (account) d'utilisateur ou de groupe spécifié les autorisations d'accès au conteneur de clé indiqué. Cette option peut accepter les modificateurs suivants :
|
-px fichier conteneur |
Exporte une paire de clés publique/privée RSA du conteneur spécifié vers le fichier XML spécifié. Cette option peut accepter les modificateurs suivants :
|
-pz conteneur |
Supprime le conteneur de clé spécifié. Cette option peut accepter le modificateur suivant :
|
Notes
Lorsque plusieurs versions d'ASP.NET sont installées sur un ordinateur, ont dit que les versions d'ASP.NET sont exécutées côte à côte. Dans ce scénario, vous devez configurer IIS pour indiquer quelle version de l'ISAPI ASP.NET (aspnet_isapi.dll) doit traiter une page dans une application ASP.NET. Dans IIS 7.0, dans les deux modes Classique et Intégré, la version du CLR définie pour le pool d'applications détermine quelle version d'ASP.NET et quelle version associée du CLR sont utilisées pour exécuter une application. Dans IIS 6.0, un scriptmap est utilisé pour associer une application à une version ISAPI ASP.NET spécifique, et la version ISAPI détermine ensuite quelle version du CLR est utilisée pour exécuter l'application.
Il existe des versions 32 bits et 64 bits d'Aspnet_regiis.exe. Pour Windows Vista et Windows Server 2008, vous pouvez exécuter la version 32 bits de l'outil sur une installation 64 bits d'IIS. Cela vous permet d'exécuter des processus de travail 32 bits et 64 bits sur le même système 64 bits. Le tableau suivant répertorie les cas et limitations spécifiques qui s'appliquent lorsque vous exécutez la version 32 bits de l'outil sur une version 64 bits d'IIS.
Version d'IIS |
Cas spéciaux pour les versions 32 bits d'Aspnet_regiis.exe |
|---|---|
6.0 |
Vous pouvez exécuter la version 32 bits d'Aspnet_regiis.exe sous une installation IIS 6.0 64 bits sur Windows Server 2003avec les restrictions suivantes :
|
7.0 |
Sur Windows Vista, Windows Server 2008 ou Windows 7, lorsque vous exécutez la version 32 bits d'Aspnet_regiis.exe sous IIS 7, l'outil ne définit pas automatiquement l'attribut enable32BitAppOnWin64 de l'élément applicationPools. Sur une installation de système d'exploitation 64 bits par défaut, avec Windows sur Windows 64 actif, vous pouvez utiliser Aspnet_regiis.exe 32 bits pour configurer l'IIS 7, mais vous ne serez en mesure d'exécuter aucune application 32 bits, à moins que vous modifiiez explicitement l'attribut enable32BitAppOnWin64 pour permettre l'exécution de l'application dans Windows sur Windows 64. Pour plus d'informations sur les options de configuration IIS 7.0, consultez la documentation pour l'élément applicationPools dans le fichier Applicationhost.config. |
L'outil ASP.NET IIS Registration est généralement utilisé avec l'option -s ou -sn pour remapper une application ASP.NET à la version du .NET Framework à laquelle elle est associée. Utilisez l'option -s pour mettre à jour une application située au niveau du chemin d'accès racine spécifié et de tous ses sous-répertoires. Si vous ne souhaitez pas la mise à jour des applications figurant dans les sous-répertoires, utilisez l'option -sn.
Notes
Le paramètre path fait référence au chemin d'accès racine de l'application, mais pas au chemin d'accès physique.Par exemple, W3SVC/1/ROOT/SampleApp1.
Vous pouvez également utiliser l'outil ASP.NET IIS Registration Tool pour consulter des informations à propos d'ASP.NET. Pour répertorier l'état et le chemin d'installation de toutes les versions d'ASP.NET installées sur l'ordinateur, utilisez l'option -lv.
L'option -norestart entrave le redémarrage du service de publication World Wide Web après l'installation ou la mise à jour des mappages de scripts d'ASP.NET. Utilisez cette option si vous exécutez plusieurs sites Web dans IIS, dans différents pools d'applications, et que vous ne souhaitez pas qu'ils soient tous redémarrés.
Toutes les modifications apportées via l'onglet ASP.NET de l'application de la console Internet Information Service (IIS) entraînent également le recyclage de tous les pools d'applications. Si vous souhaitez modifier la version d'ASP.NET utilisée par une application sans entraîner le recyclage de tous les pools d'applications, exécutez les deux commandes suivantes pour modifier la version.
aspnet_regiis -s w3svc/<instance>/root -norestart
iisapp /a <app pool> /r
L'outil ASP.NET IIS Registration peut également être utilisé pour installer et désinstaller la version liée d'ASP.NET. Utilisez l'option -i pour installer ASP.NET et mettre à jour les mappages de scripts de toutes les applications ASP.NET existantes. Utilisez l'option -ir pour installer ASP.NET sans mettre à jour les mappages de scripts. Pour désinstaller la version d'ASP.NET qui est associée à l'outil, utilisez l'option -u. Si vous souhaitez désinstaller toutes les versions d'ASP.NET de votre ordinateur, utilisez l'option -ua.
Vous pouvez également utiliser l'outil ASP.NET IIS Registration Tool pour consulter des informations à propos d'ASP.NET. Pour répertorier l'état et le chemin d'installation de toutes les versions d'ASP.NET installées sur l'ordinateur, utilisez l'option -lv. Si vous souhaitez voir les chemins d'accès à toutes les clés de la métabase IIS où ASP.NET est mappé, utilisez l'option -lk.
Vous pouvez utiliser Aspnet_regiis.exe pour installer et supprimer un script côté client système, tel qu'un script pour la validation côté client. Utilisez l'option -c afin d'installer le script client pour la version d'ASP.NET qui est associée à l'outil. (Le script est installé dans le sous-répertoire Aspnet_client de chaque répertoire de site IIS.) Pour supprimer le script côté client uniquement pour la version d'ASP.NET qui est associée à l'outil, utilisez l'option -e. Pour supprimer le script côté client pour toutes les versions installées d'ASP.NET, utilisez l'option -ea.
Lorsque vous utilisez un emprunt d'identité et si le compte emprunté n'a pas un accès en lecture à la métabase IIS, une exception COMException avec le message "Accès refusé" est levée lorsque vous essayez d'accéder à DirectoryEntry. Cela peut se produire lorsque le sous-répertoire Code de l'application existe dans le répertoire racine de l'application. Cette erreur peut également se produire lorsqu'une application est mappée à un partage UNC et que le compte UNC n'a pas d'accès en lecture à la métabase. Dans les deux cas, il faut exécuter l'outil ASP.NET IIS Registration avec l'option **-ga **utilisateur pour l'emprunt d'identité ou le compte UNC pour résoudre le problème.
Pour plus d'informations sur les scriptmaps et les chemins d'accès racine des applications, consultez la documentation IIS (éventuellement en anglais) sur le site Web de Microsoft.
Exemples
La commande suivante installe la version d'ASP.NET qui est associée à la version de l'outil ASP.NET IIS Registration que vous utilisez et met à jour les applications ASP.NET existantes. Sur IIS 6.0, la commande met à jour les mappages de scripts des applications ASP.NET existantes actuellement mappées à une version antérieure d'ASP.NET. Sur IIS 7.0, la commande met à jour à la fois les gestionnaires de mode classique et de mode intégré dans la métabase IIS. Elle bascule également les pools d'applications DefaultAppPool et Classic .NET AppPool pour utiliser le CLR de .NET Framework 4.
aspnet_regiis -i
La commande suivante installe la version d'ASP.NET qui est associée à l'outil sans mettre à jour les applications existantes. Sur IIS 7.0, la commande ne met pas à jour la version du .NET Framework qui est associée aux pools d'applications DefaultAppPool et Classic .NET AppPool.
aspnet_regiis -ir
La commande suivante affiche l'état et le chemin d'installation de toutes les versions d'ASP.NET installées sur l'ordinateur.
aspnet_regiis -lv
La commande suivante met à jour une application Web et toutes ses sous-applications de sorte qu'elles utilisent la version d'ASP.NET qui est associée à l'outil. Sur IIS 6.0, les mappages de scripts sont mis à jour. Sur IIS 7.0, l'application est mappée à un nouveau pool d'applications.
aspnet_regiis -s W3SVC/1/ROOT/SampleApp1
La commande suivante exécute les mêmes fonctions que la commande -s, mais elle n'affecte pas les applications dans les sous-répertoires.
aspnet_regiis -sn W3SVC/1/ROOT/SampleApp1
La commande suivante accorde à l'utilisateur ou aux comptes de groupe spécifiés l'accès à la métabase IIS et aux autres répertoires utilisés par ASP.NET.
aspnet_regiis -ga MyUserGroup W3SVC/1/ROOT/SampleApp1
Recherche de la version correcte d'Aspnet_regiis.exe
Aspnet_regiis.exe est installé dans le répertoire Microsoft.NET Framework. Si l'ordinateur exécute plusieurs versions du .NET Framework côte à côte, plusieurs versions de l'outil peuvent être installées. Le tableau suivant répertorie les emplacements d'installation de l'outil pour les versions différentes du .NET Framework.
Version de .NET Framework |
Emplacement du fichier 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 et version 3.5 (systèmes 32 bits) |
%windir%\Microsoft.NET\Framework\v2.0.50727 |
.NET Framework version 2.0, version 3.0 et version 3.5 (systèmes 64 bits) |
%windir%\Microsoft.NET\Framework64\v2.0.50727 |
.NET Framework version 4 (systèmes 32 bits) |
%windir%\Microsoft.NET\Framework\v4.0.30319 |
.NET Framework version 4 (systèmes 64 bits) |
%windir%\Microsoft.NET\Framework64\v4.0.30319 |
Les répertoires pour les versions 3.0 et 3.5 de .NET Framework n'ont pas de copie de l'outil. Pour plus d'informations, consultez l'entrée How to set an IIS Application or AppPool to use ASP.NET 3.5 rather than 2.0 sur le blog de Scott Hanselman.
Voir aussi
Concepts
Autres ressources
ASP.NET IIS Registration Tool for the .NET Framework Version 3.5