ASP.NET IIS Registration, outil (Aspnet_regiis.exe)

  • Article

Mise à jour : novembre 2007

Lorsque plusieurs versions du .NET Framework sont exécutées côte à côte sur un même ordinateur, la version ISAPI ASP.NET mappée à une application ASP.NET détermine la version du Common Language Runtime utilisée pour l'application. L'outil ASP.NET IIS Registration Tool (Aspnet_regiis.exe) permet à un administrateur ou à un programme d'installation de mettre à jour facilement les scriptmaps pour une application ASP.NET afin qu'elle pointe vers la version ISAPI ASP.NET associée à cet outil. L'outil peut être utilisé également pour afficher l'état de toutes les versions installées d'ASP. NET, enregistrer la version ASP.NET associée à l'outil, créer des répertoires de scripts clients et exécuter d'autres opérations de configuration.

Remarque :

Deux outils IIS Registration Tool sont fournis avec le .NET Framework ; un pour les systèmes standard et un pour les systèmes 64 bits. L'outil destiné aux systèmes 64 bits se trouve dans le répertoire Framework64 du répertoire Microsoft.NET à l'intérieur du dossier Windows ; par exemple, C:\WINDOWS\Microsoft.NET\Framework64\v2.0.50727 contiendrait l'outil IIS Registration Tool.

 
aspnet_regiis [options]

Options

Option

Description

-c

Installe les scripts côté client pour ASP.NET, tels que les scripts de validation côté client, dans le sous-répertoire aspnet_client de chaque répertoire de site IIS (Internet Information Services).

Seuls les scripts côté client de la version d'ASP.NET associée à Aspnet_regiis.exe sont installés.

-disable

Désactive ASP.NET dans la console de sécurité IIS.

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 côté client pour ASP.NET du sous-répertoire aspnet_client de chaque répertoire de site IIS.

Seuls les scripts côté client de la version d'ASP.NET associée à Aspnet_regiis.exe sont supprimés.

-ea

Supprime les scripts côté client pour toutes les versions d'ASP.NET du sous-répertoire aspnet_client de chaque répertoire de site IIS.

-enable

Active ASP.NET dans la console de sécurité IIS.

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 n'est pas disponible avec les versions d'ASP.NET antérieures à ASP.NET 2.0.

-i

Installe la version d'ASP.NET associée à Aspnet_regiis.exe et met à jour les scriptmaps à la racine de la métabase IIS et en dessous.

Seuls les scriptmaps des applications qui utilisent une version antérieure d'ASP.NET sont mis à jour. Les applications qui utilisent une version ultérieure ne sont pas affectées.

-ir

Installe la version d'ASP.NET associée à Aspnet_regiis.exe et inscrit uniquement ASP.NET dans IIS.

Cette option ne met pas à jour les scriptmaps. Pour installer ASP.NET et mettre à jour les scriptmaps, utilisez l'option -i.

-k path

Supprime les scriptmaps de toutes les versions d'ASP.NET de toutes les applications ASP.NET situées au niveau du chemin d'accès racine des applications spécifiées et des sous-répertoires.

-kn path

Supprime les scriptmaps de toutes les versions d'ASP.NET de l'application ASP.NET située au niveau du chemin d'accès racine de l'application spécifiée uniquement.

Cette option n'affecte pas les applications situées dans les sous-répertoires du path spécifié.

-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é.

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

Entrave le redémarrage du service de publication World Wide Web après l'installation ou la mise à jour des scriptmaps d'ASP.NET. Si vous n'utilisez pas cette option, tous les pools d'applications sont recyclés.

Utilisez cette option avec les options -i ou -r lorsque le processus de traitement IIS est redémarré manuellement.

-r

Met à jour tous les scriptmaps de la métabase IIS et en dessous pour qu'ils pointent vers la version ISAPI ASP.NET associée à Aspnet_regiis.exe.

Tous les scriptmaps existants sont mis à jour pour pointer vers la version ISAPI ASP.NET associée à l'outil ASP.NET IIS Registration, quelle que soit la version actuelle.

-s path

Installe le scriptmap pointant vers la version ISAPI ASP.NET associée à Aspnet_regiis.exe dans toutes les applications ASP.NET situées au niveau du chemin d'accès racine des applications spécifiées et des sous-répertoires. Tous les scriptmaps existants situés dans le chemin d'accès spécifié et en dessous qui utilisent une version antérieure d'ISAPI ASP.NET sont mis à jour.

-sn path

Installe le scriptmap pointant vers la version ISAPI ASP.NET associée à l'outil dans l'application ASP.NET située au niveau du chemin d'accès racine de l'application spécifiée. Tous les scriptmaps existants situés dans le chemin d'accès spécifié et qui utilisent une version antérieure d'ISAPI ASP.NET sont mis à jour.

Cette option n'affecte pas les applications situées dans les sous-répertoires de path.

-u

Désinstalle la version d'ASP.NET associée à l'outil ASP.NET IIS Registration de l'ordinateur. Les scriptmaps existants de cette version ISAPI ASP.NET sont automatiquement remappés sur la version ISAPI ASP.NET la plus récente encore installée.

-ua

Désinstalle toutes les versions d'ASP.NET de l'ordinateur.

-?

Affiche la syntaxe de commande et les options de l'outil ASP.NET IIS Registration.

Options de configuration

Option

Description

-config+

Active l'accès à distance à la configuration ASP.NET sur l'ordinateur.

-config-

Désactive l'accès à distance à la configuration ASP.NET sur l'ordinateur.

-pa compte de conteneur

Accorde au account d'utilisateur ou de groupe l'autorisation d'accès au container de clé spécifié. Cet argument accepte les modificateurs facultatifs suivants :

  • -pku   Substitue un conteneur spécifié par l'utilisateur au conteneur machine par défaut.

  • -csp provider   Spécifie le fournisseur de conteneurs à utiliser.

  • -full   Spécifie qu'il faut ajouter un accès complet au lieu de l'accès en lecture seule par défaut.

-pc conteneur

Crée une paire de clés publique/privée RSA dans le conteneur spécifié. Cet argument accepte les modificateurs facultatifs suivants :

  • -size keySize   Spécifie la taille de la clé. La valeur par défaut est 1024 octets.

  • -pku   Substitue un conteneur spécifié par l'utilisateur au conteneur de clé par défaut de l'ordinateur.

  • -exp   Indique que les clés privées peuvent être exportées.

  • -csp provider   Spécifie le fournisseur de conteneurs à utiliser.

-pd section

Déchiffre la section de configuration. Cet argument prend les modificateurs optionnels suivants :

  • -app virtualPath   Spécifie que le déchiffrement doit avoir lieu au niveau du chemin d'accès inclus.

  • -location subPath   Spécifie le sous-répertoire à déchiffrer.

  • -pkm   Spécifie que le fichier Machine.config doit être déchiffré au lieu du fichier Web.config.

-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. Cet argument accepte les modificateurs facultatifs suivants :

  • -prov provider   Spécifie le fournisseur de chiffrement à utiliser.

  • -app virtualPath   Spécifie que le chiffrement doit avoir lieu au niveau du chemin d'accès inclus.

  • -location subPath   Spécifie le sous-répertoire à chiffrer.

  • -pkm   Spécifie que le fichier Machine.config doit être chiffré au lieu du fichier Web.config.

-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é. Cet argument accepte les modificateurs facultatifs suivants :

  • -pku   Substitue un conteneur spécifié par l'utilisateur au conteneur machine par défaut.

  • -exp   Spécifie que les clés privées peuvent être exportées.

  • -csp provider   Spécifie le fournisseur de conteneurs à utiliser.

-pr compte de conteneur

Supprime pour le account d'utilisateur ou de groupe l'autorisation d'accès au container de clé spécifié. Cet argument accepte les modificateurs facultatifs suivants :

  • -pku   Substitue un conteneur spécifié par l'utilisateur au conteneur machine par défaut.

  • -csp provider   Spécifie le fournisseur de conteneurs à utiliser.

-px fichier conteneur

Exporte une paire de clés publique/privée RSA du conteneur spécifié vers le fichier XML spécifié. Cet argument accepte les modificateurs facultatifs suivants :

  • -pku   Substitue un conteneur spécifié par l'utilisateur au conteneur machine par défaut.

  • -csp provider   Spécifie le fournisseur de conteneurs à utiliser.

-pz conteneur

Supprime le conteneur de clé spécifié. Cet argument prend le modificateur facultatif suivant :

  • -pku   Substitue un conteneur spécifié par l'utilisateur au conteneur machine par défaut.

Notes

Lorsque plusieurs versions d'ASP.NET sont installées sur un ordinateur, ASP.NET est exécuté selon un mode d'exécution côte à côte. Dans cette configuration, les Services IIS (Internet Information Services) doivent savoir quelle version d'ISAPI ASP.NET (aspnet_isapi.dll) doit traiter une page dans une application ASP.NET. La version ISAPI ASP.NET associée à une application ASP.NET détermine quelle version du Common Language Runtime est utilisée pour l'application. Une application ASP.NET est associée à une version ISAPI ASP.NET par l'intermédiaire d'un scriptmap dans IIS. Pour simplifier le processus de configuration d'une application ASP.NET, chaque version d'ASP.NET est fournie avec une version liée de l'outil Aspnet_regiis.exe.

Remarque :

Une version unique de l'outil Aspnet_regiis.exe est incluse avec chaque version du .NET Framework. Étant donné que chaque version de l'outil n'est applicable qu'à sa version associée du .NET Framework, assurez-vous d'utiliser la version appropriée de l'outil pour configurer une application ASP.NET.

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. Pour mettre à jour les scriptmaps de toutes les applications ASP.NET existantes sur l'ordinateur en une seule fois, utilisez l'option -r.

Remarque :

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.

À l'inverse, vous pouvez utiliser l'outil ASP.NET IIS Registration pour supprimer d'une application les scriptmaps de n'importe quelle version d'ASP.NET à l'aide de l'option -k ou -kn et en indiquant le chemin d'accès racine de l'application. Si le chemin d'accès racine spécifié hérite de son scriptmap d'un chemin d'accès racine parent, les options -k et -kn n'auront aucun effet.

L'option -norestart entrave le redémarrage du service de publication World Wide Web après l'installation ou la mise à jour des scriptmaps d'ASP.NET. Vous devez utiliser cette option si vous ne souhaitez pas que tous les pools d'applications soient recyclés. Utilisez cette option si vous exécutez plusieurs sites Web dans IIS, dans différents pools d'applications, et que vous ne souhaitiez pas que tous les pools soient redémarrés.

Notez que 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 scriptmaps de toutes les applications ASP.NET existantes. Utilisez l'option -ir pour installer ASP.NET sans mettre à jour les scriptmaps. Pour désinstaller la version d'ASP.NET 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 utiliser également l'outil ASP.NET IIS Registration pour consulter des informations concernant ASP.NET. Pour répertorier l'état et le chemin d'installation de toutes les versions d'ASP.NET installées sur votre ordinateur, utilisez l'option -lv. Si vous souhaitez voir les chemins d'accès à toutes les clés de la métabase IIS dans lesquelles ASP.NET est mappé, utilisez l'option -lk.

Un script côté client, tel qu'un script de validation côté client, peut être installé et supprimé à l'aide de l'outil Aspnet_regiis.exe. Pour installer le script côté client de la version d'ASP.NET associée à l'outil dans le sous-répertoire aspnet_client de chaque répertoire de site IIS, utilisez l'option -c. Pour supprimer le script côté client uniquement pour la version d'ASP.NET 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é, 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 l'exécution côte à côte dans ASP.NET, consultez Prise en charge de l'exécution côte à côte dans ASP.NET. Pour plus d'informations sur les scriptmaps et les chemins d'accès racine des applications, consultez la documentation IIS (en anglais) sur le site Web Microsoft.

Exemples

La commande suivante installe les scriptmaps pointant vers la version d'ASP.NET associée à l'outil dans l'application SampleApp1 et toutes ses sous-applications.

aspnet_regiis -s W3SVC/1/ROOT/SampleApp1

La commande suivante ne met à jour que les scriptmaps de l'application SampleApp1, sans affecter les applications contenues dans les sous-répertoires.

aspnet_regiis -sn W3SVC/1/ROOT/SampleApp1

La commande suivante installe la version d'ASP.NET associée à l'outil ASP.NET IIS Registration et met à jour les scriptmaps de toutes les applications ASP.NET existantes. Notez que seules les applications actuellement mappées sur une version antérieure d'ASP.NET sont affectées.

aspnet_regiis -i

La commande suivante installe la version d'ASP.NET associée à l'outil, mais ne met pas à jour les scriptmaps des applications ASP.NET existantes.

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

Voir aussi

Référence

Outils du .NET Framework

Autres ressources

Exécution côte à côte