ASP.Net – Quando temos várias versões do Aspnet_(regiis)
Postado por Rafael | Postado em .NET, Desenvolvimento | Postado 13-05-2012
0
Quando várias versões. NET Framework estão sendo executadas lado a lado em um único computador, a versão da ISAPI ASP.NET mapeado para uma aplicação ASP.NET determina qual versão do Common Language Runtime é usado para a aplicação. O ASP.NET IIS Registration Tool (Aspnet_regiis.exe) permite que um administrador ou programa de instalação atualize facilmente os mapas de script de um aplicativo ASP.NET para apontar para o ISAPI do ASP.NET versão associada com a ferramenta.
A ferramenta também pode ser usada para exibir o status de todas as versões instaladas do ASP.NET, registrar a versão do ASP.NET associada à ferramenta, criar diretórios de scripts de cliente, e executar outras operações de configuração.
Sintaxe:
Aspnet_regiis [opção]
Você pode especificar uma ou mais das seguintes opções.
-C – Instala os scripts do lado do cliente para o ASP.NET, como scripts client-side de validação, para o subdiretório aspnet_client de cada diretório de sites do IIS.
Observação: Somente os scripts do lado do cliente para a versão do ASP.NET associada ao Aspnet_regiis.exe estão instalados.
-E – Remove os scripts do lado do cliente para o ASP.NET do subdiretório aspnet_client de cada diretório de sites do IIS.
Observação: Somente os scripts do lado do cliente para a versão do ASP.NET associada ao Aspnet_regiis.exe são removidos.
-Ea – Remove os scripts do lado do cliente para todas as versões do ASP.NET do subdiretório Aspnet_client de cada diretório de sites do IIS.
-I – Instala a versão do ASP.NET associada ao Aspnet_regiis.exe e atualiza os mapas de script na raiz da metabase do IIS e abaixo.
Nota: Apenas os mapas de script para aplicativos que usam uma versão anterior do ASP.NET são atualizados. Aplicativos que usam uma versão posterior não são afetados.
-Ir – Instala a versão do ASP.NET associada ao Aspnet_regiis.exe e somente registra o ASP.NET no IIS.
Nota: Esta opção não atualiza os mapas de script. Para instalar o ASP.NET e atualizar os mapas de script, use a opção -i.
-K – caminho Remove os mapas de script para todas as versões do ASP.NET de todos os aplicativos ASP.NET no caminho raiz do aplicativo especificado e seus subdiretórios.
-Kn – caminho Remove os mapas de script para todas as versões do ASP.NET do aplicativo ASP.NET somente no caminho da raiz do aplicativo especificado.
Observação: Essa opção não afeta os aplicativos nos subdiretórios do caminho.
-Lk – Lista o caminho e a versão de todas as chaves da metabase do IIS onde ASP.NET é mapeado.
Observação: As chaves que herdam os mapas de script do ASP.NET de uma chave pai não são exibidos.
-Lv – Lista o status e o caminho da instalação de todas as versões do ASP.NET instaladas no computador.
-R – Atualiza todos os mapas de script na metabase do IIS e abaixo para apontar para a versão da ISAPI do ASP.NET associada ao Aspnet_regiis.exe.
Observação: Todos os mapas de script existentes são atualizados para apontar para a versão da ISAPI do ASP.NET associada ao Aspnet_regiis.exe, independentemente da versão atual.
-S – caminho Instala o mapa de script apontando para a versão da ISAPI do ASP.NET associada ao Aspnet_regiis.exe para todos os aplicativos ASP.NET no caminho da raiz do aplicativo especificado e seus subdiretórios. Todos os mapas de script existentes no caminho especificado e abaixo que usam uma versão anterior da ISAPI do ASP.NET são atualizados.
-Sn – caminho Instala o mapa de script apontando para a versão da ISAPI do ASP.NET associada ao Aspnet_regiis.exe à aplicação ASP.NET no caminho da raiz do aplicativo especificado. Todos os mapas de script existentes no caminho especificado que usam uma versão anterior da ISAPI do ASP.NET são atualizados.
Observação: Essa opção não afeta os aplicativos nos subdiretórios do caminho.
-U – Desinstala a versão do ASP.NET associada ao Aspnet_regiis.exe do computador. Mapas de script existentes para esta versão da ISAPI do ASP.NET são automaticamente remapeado para o restante maior ASP.NET versão ISAPI instalado.
-Ua – Desinstala todas as versões do ASP.NET do computador.
-? – Exibe a sintaxe de comando e opções para a ferramenta.
Observações: Quando várias versões do ASP.NET são instalados em um computador, o ASP.NET é executado lado a lado. Nesta configuração, o Internet Information Services (IIS) precisa saber qual a versão da ISAPI do ASP.NET (aspnet_isapi.dll) deve processar uma página em um aplicativo ASP.NET. O ASP.NET versão ISAPI associado a um aplicativo ASP.NET determina qual versão do Common Language Runtime é usado para a aplicação. Um aplicativo ASP.NET é associado com uma versão da ISAPI do ASP.NET através de um mapa de script no IIS. Para simplificar o processo de configuração de um aplicativo ASP.NET, cada versão do ASP.NET vem com uma versão vinculada do Aspnet_regiis.exe.
Nota: uma versão exclusiva do Aspnet_regiis.exe acompanha cada versão do. NET Framework. Uma vez que cada versão da ferramenta é aplicável somente para a versão associada do. NET Framework, não se esqueça de usar a versão apropriada da ferramenta para configurar um aplicativo ASP.NET.
Aspnet_regiis.exe é comumente usado com a opção -s ou -sn para remapear um aplicativo ASP.NET para a versão do. NET Framework que está associado com a ferramenta. Use a opção-s para atualizar as aplicações no caminho raiz especificado e em todos os seus subdiretórios. Se você não deseja que os aplicativos nos subdiretórios sejam atualizados, use a opção -sn. Para atualizar os mapas de script de todos os aplicativos ASP.NET existentes no computador de uma só vez, use a opção -r.
Nota: O parâmetro path refere-se ao caminho da raiz do aplicativo, não o caminho físico. Por exemplo, W3SVC/1/ROOT/SampleApp1.
Por outro lado, você pode usar a ferramenta para remover os mapas de script para qualquer versão do ASP.NET de um aplicativo usando o -k ou -kn como opção e especificar o caminho raiz do aplicativo.
Observação: Se o caminho raiz especificado herda seu mapa de script de um caminho da raiz pai, as opções -k e -kn opções não terão nenhum efeito.
A ferramenta também pode ser usado para instalar e desinstalar a versão vinculada do ASP.NET. Use a opção -i para instalar o ASP.NET e atualizar os scripmaps de todos os aplicativos ASP.NET existentes. Use a opção -ir para instalar o ASP.NET sem atualizar os mapas de script. Para desinstalar a versão do ASP.NET associada à ferramenta, use a opção -u. Se você deseja desinstalar todas as versões do ASP.NET a partir do computador, use a opção -ua.
Você pode usar Aspnet_regiis.exe para exibir informações sobre ASP.NET. Para listar o status e o caminho da instalação de todas as versões instaladas do ASP.NET, use a opção -lv. Se você gostaria de ver os caminhos para todas as chaves da metabase do IIS onde ASP.NET é mapeado, use a opção -lk.
Client-side script, como validação do cliente, pode ser instalado e removido usando Aspnet_regiis.exe. Para instalar o script do lado do cliente para a versão do ASP.NET associada à ferramenta para o subdiretório aspnet_client de cada diretório de sites do IIS, use a opção -c. Para remover o script do lado do cliente apenas para a versão do ASP.NET associada à ferramenta, use a opção -e. Para remover o script do lado do cliente para todas as versões instaladas do ASP.NET, use a opção -ea.
Para mais informações sobre side-by-side execução no ASP.NET, consulte Side-by-Side Suporte em ASP.NET. Para mais informações sobre mapas de script e caminho de raiz do aplicativo, consulte a documentação do IIS (http://localhost/iishelp). Note que para ver a documentação do IIS, você deve ter o IIS instalado.
Exemplos
O seguinte comando instala os mapas de script apontando para a versão do ASP.NET associada ao Aspnet_regiis.exe à aplicação SampleApp1 e todos os seus sub-aplicações.
Aspnet_regiis-s W3SVC/1/ROOT/SampleApp1
O comando a seguir só atualiza os mapas de script para a aplicação SampleApp1, sem afetar os aplicativos nos subdiretórios.
Aspnet_regiis-sn W3SVC/1/ROOT/SampleApp1
O seguinte comando instala a versão do ASP.NET associada à ferramenta e atualiza os mapas de script de todos os aplicativos ASP.NET existentes. Note-se que somente os aplicativos que atualmente são mapeados para uma versão anterior do ASP.NET são afetados.
Aspnet_regiis-i
O seguinte comando instala a versão do ASP.NET associada à ferramenta, mas não atualiza os mapas de script de aplicativos ASP.NET existentes.
Aspnet_regiis-ir
O comando a seguir exibe o status e o caminho da instalação de todas as versões do ASP.NET instaladas no computador.
Aspnet_regiis-lv
A ferramenta também pode ser usada para exibir o status de todas as versões instaladas do ASP.NET, registrar a versão do ASP.NET associada à ferramenta, criar diretórios de scripts de cliente, e executar outras operações de configuração.
Sintaxe:
Aspnet_regiis [opção]
Você pode especificar uma ou mais das seguintes opções.
-C – Instala os scripts do lado do cliente para o ASP.NET, como scripts client-side de validação, para o subdiretório aspnet_client de cada diretório de sites do IIS.
Observação: Somente os scripts do lado do cliente para a versão do ASP.NET associada ao Aspnet_regiis.exe estão instalados.
-E – Remove os scripts do lado do cliente para o ASP.NET do subdiretório aspnet_client de cada diretório de sites do IIS.
Observação: Somente os scripts do lado do cliente para a versão do ASP.NET associada ao Aspnet_regiis.exe são removidos.
-Ea – Remove os scripts do lado do cliente para todas as versões do ASP.NET do subdiretório Aspnet_client de cada diretório de sites do IIS.
-I – Instala a versão do ASP.NET associada ao Aspnet_regiis.exe e atualiza os mapas de script na raiz da metabase do IIS e abaixo.
Nota: Apenas os mapas de script para aplicativos que usam uma versão anterior do ASP.NET são atualizados. Aplicativos que usam uma versão posterior não são afetados.
-Ir – Instala a versão do ASP.NET associada ao Aspnet_regiis.exe e somente registra o ASP.NET no IIS.
Nota: Esta opção não atualiza os mapas de script. Para instalar o ASP.NET e atualizar os mapas de script, use a opção -i.
-K – caminho Remove os mapas de script para todas as versões do ASP.NET de todos os aplicativos ASP.NET no caminho raiz do aplicativo especificado e seus subdiretórios.
-Kn – caminho Remove os mapas de script para todas as versões do ASP.NET do aplicativo ASP.NET somente no caminho da raiz do aplicativo especificado.
Observação: Essa opção não afeta os aplicativos nos subdiretórios do caminho.
-Lk – Lista o caminho e a versão de todas as chaves da metabase do IIS onde ASP.NET é mapeado.
Observação: As chaves que herdam os mapas de script do ASP.NET de uma chave pai não são exibidos.
-Lv – Lista o status e o caminho da instalação de todas as versões do ASP.NET instaladas no computador.
-R – Atualiza todos os mapas de script na metabase do IIS e abaixo para apontar para a versão da ISAPI do ASP.NET associada ao Aspnet_regiis.exe.
Observação: Todos os mapas de script existentes são atualizados para apontar para a versão da ISAPI do ASP.NET associada ao Aspnet_regiis.exe, independentemente da versão atual.
-S – caminho Instala o mapa de script apontando para a versão da ISAPI do ASP.NET associada ao Aspnet_regiis.exe para todos os aplicativos ASP.NET no caminho da raiz do aplicativo especificado e seus subdiretórios. Todos os mapas de script existentes no caminho especificado e abaixo que usam uma versão anterior da ISAPI do ASP.NET são atualizados.
-Sn – caminho Instala o mapa de script apontando para a versão da ISAPI do ASP.NET associada ao Aspnet_regiis.exe à aplicação ASP.NET no caminho da raiz do aplicativo especificado. Todos os mapas de script existentes no caminho especificado que usam uma versão anterior da ISAPI do ASP.NET são atualizados.
Observação: Essa opção não afeta os aplicativos nos subdiretórios do caminho.
-U – Desinstala a versão do ASP.NET associada ao Aspnet_regiis.exe do computador. Mapas de script existentes para esta versão da ISAPI do ASP.NET são automaticamente remapeado para o restante maior ASP.NET versão ISAPI instalado.
-Ua – Desinstala todas as versões do ASP.NET do computador.
-? – Exibe a sintaxe de comando e opções para a ferramenta.
Observações: Quando várias versões do ASP.NET são instalados em um computador, o ASP.NET é executado lado a lado. Nesta configuração, o Internet Information Services (IIS) precisa saber qual a versão da ISAPI do ASP.NET (aspnet_isapi.dll) deve processar uma página em um aplicativo ASP.NET. O ASP.NET versão ISAPI associado a um aplicativo ASP.NET determina qual versão do Common Language Runtime é usado para a aplicação. Um aplicativo ASP.NET é associado com uma versão da ISAPI do ASP.NET através de um mapa de script no IIS. Para simplificar o processo de configuração de um aplicativo ASP.NET, cada versão do ASP.NET vem com uma versão vinculada do Aspnet_regiis.exe.
Nota: uma versão exclusiva do Aspnet_regiis.exe acompanha cada versão do. NET Framework. Uma vez que cada versão da ferramenta é aplicável somente para a versão associada do. NET Framework, não se esqueça de usar a versão apropriada da ferramenta para configurar um aplicativo ASP.NET.
Aspnet_regiis.exe é comumente usado com a opção -s ou -sn para remapear um aplicativo ASP.NET para a versão do. NET Framework que está associado com a ferramenta. Use a opção-s para atualizar as aplicações no caminho raiz especificado e em todos os seus subdiretórios. Se você não deseja que os aplicativos nos subdiretórios sejam atualizados, use a opção -sn. Para atualizar os mapas de script de todos os aplicativos ASP.NET existentes no computador de uma só vez, use a opção -r.
Nota: O parâmetro path refere-se ao caminho da raiz do aplicativo, não o caminho físico. Por exemplo, W3SVC/1/ROOT/SampleApp1.
Por outro lado, você pode usar a ferramenta para remover os mapas de script para qualquer versão do ASP.NET de um aplicativo usando o -k ou -kn como opção e especificar o caminho raiz do aplicativo.
Observação: Se o caminho raiz especificado herda seu mapa de script de um caminho da raiz pai, as opções -k e -kn opções não terão nenhum efeito.
A ferramenta também pode ser usado para instalar e desinstalar a versão vinculada do ASP.NET. Use a opção -i para instalar o ASP.NET e atualizar os scripmaps de todos os aplicativos ASP.NET existentes. Use a opção -ir para instalar o ASP.NET sem atualizar os mapas de script. Para desinstalar a versão do ASP.NET associada à ferramenta, use a opção -u. Se você deseja desinstalar todas as versões do ASP.NET a partir do computador, use a opção -ua.
Você pode usar Aspnet_regiis.exe para exibir informações sobre ASP.NET. Para listar o status e o caminho da instalação de todas as versões instaladas do ASP.NET, use a opção -lv. Se você gostaria de ver os caminhos para todas as chaves da metabase do IIS onde ASP.NET é mapeado, use a opção -lk.
Client-side script, como validação do cliente, pode ser instalado e removido usando Aspnet_regiis.exe. Para instalar o script do lado do cliente para a versão do ASP.NET associada à ferramenta para o subdiretório aspnet_client de cada diretório de sites do IIS, use a opção -c. Para remover o script do lado do cliente apenas para a versão do ASP.NET associada à ferramenta, use a opção -e. Para remover o script do lado do cliente para todas as versões instaladas do ASP.NET, use a opção -ea.
Para mais informações sobre side-by-side execução no ASP.NET, consulte Side-by-Side Suporte em ASP.NET. Para mais informações sobre mapas de script e caminho de raiz do aplicativo, consulte a documentação do IIS (http://localhost/iishelp). Note que para ver a documentação do IIS, você deve ter o IIS instalado.
Exemplos
O seguinte comando instala os mapas de script apontando para a versão do ASP.NET associada ao Aspnet_regiis.exe à aplicação SampleApp1 e todos os seus sub-aplicações.
Aspnet_regiis-s W3SVC/1/ROOT/SampleApp1
O comando a seguir só atualiza os mapas de script para a aplicação SampleApp1, sem afetar os aplicativos nos subdiretórios.
Aspnet_regiis-sn W3SVC/1/ROOT/SampleApp1
O seguinte comando instala a versão do ASP.NET associada à ferramenta e atualiza os mapas de script de todos os aplicativos ASP.NET existentes. Note-se que somente os aplicativos que atualmente são mapeados para uma versão anterior do ASP.NET são afetados.
Aspnet_regiis-i
O seguinte comando instala a versão do ASP.NET associada à ferramenta, mas não atualiza os mapas de script de aplicativos ASP.NET existentes.
Aspnet_regiis-ir
O comando a seguir exibe o status e o caminho da instalação de todas as versões do ASP.NET instaladas no computador.
Aspnet_regiis-lv

