Программа регистрации IIS для ASP.NET (Aspnet_regiis.exe)
Обновлен: Ноябрь 2007
При параллельном выполнении нескольких версий .NET Framework на одном компьютере версия фильтра ISAPI ASP.NET, соответствующая приложению ASP.NET, определяет версию среды CLR, используемую приложением. Программа регистрации IIS для ASP.NET (Aspnet_regiis.exe) позволяет администратору или программе установки просто и легко обновить сопоставления сценариев для приложения ASP.NET, чтобы указать версию фильтра ISAPI ASP.NET, связанную со средством. Это средство также может использоваться для отображения состояния всех установленных версий ASP. NET, регистрации версии ASP.NET, связанной со средством, создания каталогов клиентских сценариев и выполнения других действий с конфигурацией.
.gif "Примечание") Примечание. |
|---|
Существует два средства регистрации IIS, поставляемых с .NET Framework; одно для стандартных, а другое для 64-разрядных систем. Средство для 64-разрядных систем находится в каталоге Framework64 каталога Microsoft.NET папки Windows; например средство регистрации IIS может находиться в папке C:\WINDOWS\Microsoft.NET\Framework64\v2.0.50727. |
aspnet_regiis [options]
Параметры
Параметр |
Описание |
|---|---|
-c |
Устанавливает клиентские сценарии для ASP.NET, например клиентский сценарий проверки, в подкаталог aspnet_client каждого каталога узла IIS. Устанавливаются только клиентские сценарии для версии ASP.NET, связанной с программой Aspnet_regiis.exe. |
-disable |
Отключает ASP.NET в консоли безопасности IIS. Этот параметр можно сочетать только с параметрами -i, -ir или -r. Он недоступен с версиями IIS, предшествующими IIS 6.0. |
-e |
Удаляет клиентские сценарии для ASP.NET из подкаталогов aspnet_client всех каталогов узла IIS. Удаляются только клиентские сценарии для версии ASP.NET, связанной с программой Aspnet_regiis.exe. |
-ea |
Удаляет клиентские сценарии для всех версий ASP.NET из подкаталогов aspnet_client всех каталогов узла IIS. |
-enable |
Включает ASP.NET в консоли безопасности IIS. Этот параметр можно сочетать только с параметрами -i, -ir или -r. Он не доступен с версиями IIS, предшествующими IIS 6.0, или с версиями ASP.NET, предшествующими ASP.NET версии 2.0. |
-ga user |
Предоставляет указанному пользователю или группе пользователей доступ к метабазе IIS и другим каталогам, используемым ASP.NET. Этот параметр недоступен с версиями ASP.NET, предшествующими ASP.NET 2.0. |
-i |
Устанавливает версию ASP.NET, связанную с программой Aspnet_regiis.exe, и обновляет сопоставления сценариев в корне метабазы IIS и далее по дереву. Обновляются только сопоставления сценариев, использующие более раннюю версию ASP.NET. Этот параметр не влияет на приложения, использующие более позднюю версию. |
-ir |
Устанавливает версию ASP.NET, связанную с программой Aspnet_regiis.exe, и только регистрирует ASP.NET в IIS. Этот параметр не обновляет сопоставления сценариев. Чтобы установить ASP.NET и обновить сопоставления сценариев, задайте параметр -i. |
-k path |
Удаляет сопоставления сценариев со всеми версиями ASP.NET из всех приложений ASP.NET по заданному пути к корневому каталогу приложения и его подкаталогам. |
-kn path |
Удалить сопоставления сценариев со всеми версиями ASP.NET из приложения ASP.NET только по заданному пути к корневому каталогу приложения. Этот параметр не влияет на приложения в подкаталогах для пути, заданного параметром path. |
-lk |
Выводит список путей и версий для всех ключей метабазы IIS, сопоставленных с ASP.NET. Ключи, наследующие сопоставления сценариев ASP.NET от родительского ключа, не отображаются. |
-lv |
Перечисляет состояния и пути установки для всех версий ASP.NET, установленных на компьютере. |
-norestart |
Запрещает перезапуск службы World Wide Web Publishing после установки или обновления сопоставлений сценариев ASP.NET. Если этот параметр не используется, все пулы приложений перезапускаются. Этот параметр используется с параметрами -i или -r при перезапуске рабочего процесса IIS вручную. |
-r |
Обновляет сопоставления сценариев в метабазе IIS и далее вниз по дереву, чтобы они указывали на версию ISAPI ASP.NET, связанную с программой Aspnet_regiis.exe. Все существующие сопоставления сценариев будут указывать на версию ISAPI ASP.NET, связанную со средством регистрации IIS ASP.NET, независимо от текущей версии. |
-s path |
Устанавливает сопоставления сценариев, указывающие на версию ISAPI ASP.NET, связанную с программой Aspnet_regiis.exe, для всех приложений ASP.NET в указанном корневом каталоге приложения и его подкаталогах. Обновляются все сопоставления сценариев в указанном каталоге и его подкаталогах, использующие более раннюю версию ISAPI ASP.NET. |
-sn path |
Устанавливает сопоставления сценариев, указывающие на версию ISAPI ASP.NET, связанную с программой, для приложения ASP.NET в указанный корневой каталог приложения. Обновляются все сопоставления сценариев в указанном каталоге, использующие более раннюю версию ISAPI ASP.NET. Этот параметр не влияет на приложения, расположенные в подкаталогах пути, заданного параметром path. |
-u |
Удаляет с компьютера версию ASP.NET, связанную со средством регистрации IIS для ASP.NET. Существующие сопоставления сценариев для этой версии ISAPI ASP.NET автоматически повторно сопоставляются с самой поздней из установленных версий ISAPI ASP.NET. |
-ua |
Удаляет с компьютера все версии ASP.NET. |
-? |
Отображает синтаксис команд и параметры средства регистрации IIS для ASP.NET. |
Параметры конфигурации
Параметр |
Описание |
|---|---|
-config+ |
Включает удаленный доступ к конфигурации ASP.NET на компьютере. |
-config- |
Отключает удаленный доступ к конфигурации ASP.NET на компьютере. |
-pa учетная запись контейнера |
Предоставляет заданному пользователю или группе пользователей account доступ к заданному контейнеру ключей container. С этим аргументом могут использоваться следующие необязательные модификаторы:
|
-pc контейнер |
Создает пару ключей "открытый/закрытый" RSA в заданном контейнере. С этим аргументом могут использоваться следующие необязательные модификаторы:
|
-pd раздел |
Расшифровывает раздел конфигурации. С этим аргументом могут задаваться следующие необязательные параметры:
|
-pdf раздел webApplicationDirectory |
Расшифровывает заданный раздел конфигурации файла Web.config в заданном физическом (не виртуальном) каталоге. |
-pe раздел |
Шифрует указанный раздел конфигурации. С этим аргументом могут использоваться следующие необязательные модификаторы:
|
-pef section webApplicationDirectory |
Шифрует заданный раздел конфигурации файла Web.config в заданном физическом (не виртуальном) каталоге. |
-pi файл контейнера |
Импортирует пару ключей "открытый/закрытый" RSA в контейнер, заданный параметром container, из заданного XML-файла file. С этим аргументом могут использоваться следующие необязательные модификаторы:
|
-pr учетная запись контейнера |
Удаляет для заданного пользователя или группы account разрешение на доступ к заданному контейнеру ключей container. С этим аргументом могут использоваться следующие необязательные модификаторы:
|
-px файл контейнера |
Экспортирует пару ключей "открытый/закрытый" RSA из заданного контейнера в заданный XML-файл. С этим аргументом могут использоваться следующие необязательные модификаторы:
|
-pz контейнер |
Удаляет заданный контейнер ключей. С этим аргументом может задаваться следующий необязательный модификатор:
|
Заметки
Сосуществование на компьютере нескольких установленных версий ASP.NET называется параллельным выполнением. В этом случае службе IIS требуется указать, какая версия ISAPI ASP.NET (aspnet_isapi.dll) должна обрабатывать ту или иную страницу в приложении ASP.NET. Версия ISAPI ASP.NET, связанная с приложением ASP.NET, определяет версию среды CLR, используемую приложением. Приложение ASP.NET связано с версией ISAPI ASP.NET с помощью сопоставления сценариев в IIS. Для упрощения процесса конфигурации приложений ASP.NET все версии ASP.NET поставляются со связанной версией средства Aspnet_regiis.exe.
| Примечание. |
|---|
С каждой версией .NET Framework поставляется уникальная версия Aspnet_regiis.exe. Так как каждая конкретная версия этой программы работает только со связанной версией .NET Framework, убедитесь в правильности выбора инструмента для настройки приложения ASP.NET. |
Средство регистрации IIS для ASP.NET обычно используется с параметром -s или -sn, чтобы восстановить сопоставление приложения ASP.NET с версией .NET Framework , с которой оно связано. Параметр -s применяется для обновления приложения в указанном корневом каталоге приложения и всех его подкаталогах. Если не нужно обновлять приложения, расположенные в подкаталогах, задайте параметр -sn. Чтобы обновить сопоставления сценариев одновременно для всех установленных на компьютере приложений ASP.NET, задайте параметр -r.
| Примечание. |
|---|
Параметр path ссылается на корневой каталог приложения, а не на физический путь. Пример: W3SVC/1/ROOT/SampleApp1. |
Напротив, средство регистрации IIS для ASP.NET можно использовать, чтобы удалять сопоставления сценариев для любых версий ASP.NET, для чего следует указать параметры -k or -kn и путь к корневому каталогу нужного приложения. Если указанный корневой путь наследует сопоставление сценария от родительского корневого пути, параметры -k и -knне действуют.
Параметр -norestart предотвращает перезапуск службы World Wide Web Publishing после установки или сопоставлений сценариев ASP.NET. Этот параметр следует использовать, если перезапуск всех пулов приложений нежелателен. Этот параметр следует использовать, если при запуске нескольких веб-узлов в IIS, в различных пулах приложений, перезапуск всех приложений нежелателен.
Обратите внимание, что любые изменения, выполненные с помощью вкладки ASP.NET консольного приложения службы IIS, также вызывают перезапуск всех пулов приложений. Если нужно изменить версию ASP.NET, используемую приложением, не вызывая перезапуск всех пулов приложений, выполните следующие две команды для изменения версии.
aspnet_regiis -s w3svc/<instance>/root -norestart
iisapp /a <app pool> /r
Средство регистрации IIS для ASP.NET также может использоваться для установки и удаления связанной версии ASP.NET. Параметр -i используется для установки ASP.NET и для обновления сопоставлений сценариев для всех существующих приложений ASP.NET. Чтобы установить ASP.NET без обновления сопоставлений сценариев, используется параметр -ir. Для удаления версии ASP.NET, связанной с инструментом, используется параметр -u. Чтобы удалить с компьютера все версии ASP.NET, можно использовать параметр -ua.
Средство регистрации IIS для ASP.NET можно также использовать для просмотра сведений о ASP.NET. Чтобы перечислить состояния и пути установки для всех версий ASP.NET, установленных на компьютере, используется параметр -lv. Чтобы просмотреть пути ко всем ключам метабазы IIS, которые сопоставлены ASP.NET, используется параметр -lk.
Клиентский сценарий, например проверка на стороне клиента, может быть установлен и удален с помощью программы Aspnet_regiis.exe. Параметр -c используется для установки клиентского сценария для версии ASP.NET, связанной с этой программой, в подкаталог Aspnet_client каждого каталога узла IIS. Чтобы удалить клиентский сценарий для версии ASP.NET, связанной с этой программой, используется параметр -e. Чтобы удалить клиентский сценарий для всех установленных версий ASP.NET, используется параметр -ea.
Если при использовании олицетворения у учетной записи олицетворения отсутствует доступ на чтение к метабазе IIS, при попытке доступа к DirectoryEntry возникает исключение COMException с сообщением "Доступ запрещен". Это может произойти, когда в корневом каталоге приложения существует подкаталог Code. Эта ошибка также может произойти, когда приложение сопоставляется с общей папкой UNC и у учетной записи UNC отсутствует доступ на чтение к метабазе. В обоих случаях проблема решается путем запуска средства регистрации IIS для ASP.NET с параметром **-ga **пользователь для олицетворения или учетной записи UNC.
Дополнительные сведения о параллельном выполнении в ASP.NET см. в разделе Side-by-Side Support in ASP.NET. Дополнительные сведения о сопоставлениях сценариев и корневых путей приложений см. в документации по IIS на веб-узле корпорации Майкрософт.
Примеры
Приведенная ниже команда устанавливает сопоставления сценариев, указывающие на версию ASP.NET, связанную с программой Aspnet_regiis.exe, с приложением SampleApp1 и всех его дочерних приложений.
aspnet_regiis -s W3SVC/1/ROOT/SampleApp1
Следующая команда обновляет сопоставления сценариев только для приложения SampleApp1, не влияя на приложения, расположенные в подкаталогах.
aspnet_regiis -sn W3SVC/1/ROOT/SampleApp1
Следующая команда устанавливает версию ASP.NET, связанную со средством регистрации IIS для ASP.NET и обновляет сопоставления сценариев для всех существующих приложений ASP.NET. Обратите внимание, что обновляются только приложения, сопоставленные с более ранними версиями ASP.NET.
aspnet_regiis -i
Следующая команда устанавливает версию ASP.NET, связанную со средством, но не обновляет сопоставления сценариев для установленных приложений ASP.NET.
aspnet_regiis -ir
Следующая команда отображает состояния и пути установки для всех версий ASP.NET, установленных на компьютере.
aspnet_regiis -lv