Ferramenta de registro ASP.NET IIS (Aspnet_regiis.exe)

  • Artigo

Quando várias versões do .NET estrutura estão sendo executadas lado a lado em um único computador, a versão da ISAPI do ASP.NET mapeada para um aplicativo ASP.NET determina qual versão do common linguagem tempo de execução (CLR) é usada para o aplicativo. A ferramenta de inscrição de IIS do ASP.NET (Aspnet_regiis.exe) permite que um programa de instalação ou administrador com com facilidade atualização mapas de script para um aplicativo ASP.NET apontar para a versão da ISAPI do ASP.NET que está 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 juntamente com a ferramenta, criar diretórios de scripts de cliente e executar outras operações de configuração.

ObservaçãoObservação:

Há duas ferramentas de inscrição de IIS fornecidos com o .NET estrutura, um para sistemas padrão e um para o sistema de 64 bit. A ferramenta para sistemas de 64 bit em localizado no diretório Framework64 da pasta Microsoft.NET dentro da pasta do Windows; por exemplo C:\WINDOWS\Microsoft.NET\Framework64\v2.0.50727 conteria a ferramenta de inscrição do IIS.

 
aspnet_regiis [options]

Opções

Opção

Descrição

-c

Instala sistema autônomo scripts de cliente para o ASP.NET, sistema autônomo scripts de validação do lado do cliente para o subdiretório aspnet_client de cada Serviços de Informações da Internet (Serviços de Informações da Internet) Diretório de Sites.

Somente os scripts de cliente da versão do ASP.NET associada ao Aspnet_regiis.exe são instalados.

-disable

Desativa o ASP.NET no console de segurança do IIS.

Essa opção pode ser combinada somente com o -i, -ir, ou -r opções. Não está disponível com versões anteriores do IIS que o IIS 6.0.

-e

Remove os scripts no lado do cliente do ASP.NET do subdiretório aspnet_client de cada IIS site diretório.

Somente os scripts de cliente da versão do ASP.NET associada ao Aspnet_regiis.exe são removidos.

-ea

Remove os scripts de cliente para todas as versões do ASP.NET do subdiretório aspnet_client de cada diretório de sites do IIS.

-enable

Permite que o ASP.NET no console de segurança do IIS.

Essa opção pode ser combinada somente com o -i, -ir, ou -r opções. Não está disponível com versões anteriores ao IIS 6.0 do IIS ou com versões anteriores do ASP.NET que o ASP.NET versão 2.0.

-ga user

Concede o usuário especificado ou agrupar acesso a metabase do IIS e outros diretórios usados pelo ASP.NET.

Essa opção não está disponível com ASP.NET versões anteriores ao ASP.NET 2.0.

-i

Instala a versão do ASP.NET associada ao Aspnet_regiis.exe e atualizações de que mapas de script na raiz da metabase do IIS e abaixo.

Somente o script mapeia 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 que é associada ao Aspnet_regiis.exe e somente registra o ASP.NET no IIS.

Essa opção não atualização mapas de script. Para instalar o ASP.NET e atualizar os mapas de script, use o -i opção.

-k path

Remove o script mapeia para todas as versões do ASP.NET de todos os aplicativos ASP.NET no caminho da raiz do aplicativo especificado e seus subdiretórios.

-kn path

Remove o script mapeia para todas as versões do ASP.NET do aplicativo ASP.NET somente no caminho da raiz do aplicativo especificado.

Essa opção não afeta os aplicativos nos subdiretórios do especificado path.

-lk

Lista o caminho e a versão de todas as chaves de metabase do IIS em que o ASP.NET é mapeado.

As chaves que herdam mapas de script do ASP.NET uma chave pai não são exibidas.

-lv

Lista o status e o caminho da instalação de todas as versões do ASP.NET instaladas no computador.

-norestart

Inibe a reinicialização do serviço de publicação na World Wide Web após instalar ou atualizar os mapas de script do ASP.NET. Se você não usar esta opção, todos os pools de aplicativos são reciclados.

Use esta opção com o -i ou -r Opções de quando o processo do operador do IIS será reiniciado manualmente.

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

Todos os mapas de script existentes são atualizados para apontar para a versão da ISAPI do ASP.NET que está associada com a ferramenta de inscrição de IIS do ASP.NET, independentemente da versão corrente.

-s path

Instala o MAP de script que aponta para a versão da ISAPI do ASP.NET associada ao Aspnet_regiis.exe em todos os aplicativos ASP.NET no caminho da raiz do aplicativo especificado e seus subdiretórios. Script existente todos os mapas no caminho especificado e abaixo que usam uma versão anterior da ISAPI do ASP.NET são atualizados.

-sn path

Instala o MAP de script que aponta para a versão da ISAPI do ASP.NET associada à ferramenta para o aplicativo ASP.NET no caminho da raiz do aplicativo especificado. Mapeia todos os scripts existentes no caminho especificado que usam uma versão anterior da ISAPI do ASP.NET são atualizados.

Essa opção não afeta os aplicativos nos subdiretórios de path.

-u

Desinstala a versão do ASP.NET que está associado com a ferramenta de inscrição de IIS do ASP.NET do computador. Mapas de script existentes para esta versão da ISAPI do ASP.NET são remapeados automaticamente para a versão da ISAPI do ASP.NET restante mais recente instalada.

-ua

Desinstala todas as versões do ASP.NET do computador.

-?

Exibe a sintaxe de comando e opções para a ferramenta de inscrição de IIS do ASP.NET.

Opções de configuração

Opção

Descrição

-config+

Permite o acesso remoto a configuração do ASP.NET no computador.

-config-

Desativa o acesso remoto à configuração do ASP.NET no computador.

-pa container account

Concede permissão para o usuário especificado ou o agrupar account para acesso a chave especificada container. Este argumento tem seguintes modificadores opcionais:

  • -pku   Substitui um contêiner especificado pelo usuário para o recipiente de computador padrão.

  • -csp provider   Specifies the container provider to use.

  • -full   Especifica que acesso completo deve ser adicionado, em vez do acesso somente leitura do padrão.

-pc container

Cria um RSA pública / emparelharticular chave emparelhar no contêiner especificado. Este argumento tem seguintes modificadores opcionais:

  • -size keySize   Specifies the key size. O padrão é 1024 bytes.

  • -pku   Substitui um contêiner especificado pelo usuário para o recipiente de chave padrão no computador.

  • -exp   Especifica que particular chaves devem ser capazes de ser exportado.

  • -csp provider   Specifies the container provider to use.

-pd section

Descriptografa a seção de configuração. Esse argumento usa os seguintes parâmetros opcionais:

  • -app virtualPath   Specifies that decryption should occur at the level of the included path.

  • -location subPath   Specifies the subdirectory to decrypt.

  • -pkm   Especifica que o arquivo computador.config deve ser descriptografado em vez do arquivo Web.config.

-pdf section webApplicationDirectory

Descriptografa a seção de configuração especificado o arquivo Web.config no diretório (não virtual) físico especificado.

-pe section

Criptografa a seção de configuração especificado. Este argumento tem seguintes modificadores opcionais:

  • -prov provider   Specifies the encryption provider to use.

  • -app virtualPath    Specifies that encryption should occur at the level of the included path.

  • -location subPath   Specifies the subdirectory to encrypt.

  • -pkm   Especifica que a computador. arquivo de configuração devem ser criptografados em vez da Web. arquivo de configuração.

-pef section webApplicationDirectory

Criptografa a seção de configuração especificada do arquivo Web.config no diretório (não virtual) físico especificado.

-pi container file

Importa um público RSA / emparelharticular chave emparelhar à especificada container o XML especificado file. Este argumento tem seguintes modificadores opcionais:

  • -pku   Substitui um contêiner especificado pelo usuário para o recipiente de computador padrão.

  • -exp   Especifica que particular chaves podem ser exportadas.

  • -csp provider   Specifies the container provider to use.

-pr container account

Remove a permissão para o usuário especificado ou o agrupar account para acessar a chave especificada container. Este argumento tem seguintes modificadores opcionais:

  • -pku   Substitui um contêiner especificado pelo usuário para o recipiente de computador padrão.

  • -csp provider   Specifies the container provider to use.

-px container file

Exporta um emparelhar de chaves pública/privada RSA do contêiner especificado para o arquivo XML especificado. Este argumento tem seguintes modificadores opcionais:

  • -pku   Substitui um contêiner especificado pelo usuário para o recipiente de computador padrão.

  • -csp provider   Specifies the container provider to use.

-pz container

Exclui o contêiner de chave especificado. Esse argumento leva o modificador opcional seguinte:

  • -pku   Substitui um contêiner especificado pelo usuário para o recipiente de computador padrão.

Comentários

Quando várias versões do ASP.NET são instaladas em um computador, é chamado de ASP.NET esteja em execução lado a lado. Nessa configuração, Serviços de Informações da Internet (Serviços de Informações da Internet) precisa saber qual versão do ISAPI do ASP.NET (aspnet_isapi.dll) deve processar uma página em um aplicativo ASP.NET. A versão da ISAPI do ASP.NET que está associada um aplicativo ASP.NET determina qual versão do CLR é usada para o aplicativo. Um aplicativo ASP.NET é associado a uma versão da ISAPI do ASP.NET usando um MAP 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.

ObservaçãoObservação:

Uma versão exclusiva do Aspnet_regiis.exe está incluída com cada versão do .NET estrutura. Desde que cada versão da ferramenta se aplica apenas a sua versão associada do .NET estrutura, certifique-se de usar a versão apropriada da ferramenta para configurar um aplicativo ASP.NET.

A ferramenta de inscrição de IIS do ASP.NET é normalmente usada com o -s ou -sn opção para remapear um aplicativo ASP.NET para a versão do .NET estrutura à qual está associado. Use o -s opção para atualização um aplicativo no caminho da raiz especificado e em todas as suas subpastas. Não aplicativos nos subdiretórios sejam atualizados, use o -sn opção. Para atualização mapas de script de todos os aplicativos ASP.NET existentes no computador ao mesmo time, use o -r opção.

ObservaçãoObservação:

O path parâmetro se refere ao caminho raiz do aplicativo, não o caminho físico. Por exemplo, W3SVC/1/ROOT/SampleApp1.

Por outro lado, você pode usar a ferramenta de inscrição de IIS do ASP.NET para remover os mapas de script para qualquer versão do ASP.NET de um aplicativo usando o -k ou -kn opção e especificando o caminho raiz do aplicativo. Se o caminho raiz especificado herdar MAP de script de um caminho de raiz pai, a -k e -kn opções têm efeito.

The -norestart opção impede a reinicialização do serviço de publicação na World Wide Web depois de mapas de script do ASP.NET são instalados ou atualizados. Você deve usar essa opção se você não quiser todo aplicativo pools para reciclagem. Se você estiver executando vários sites no IIS, em vários pools de aplicativos, e você não deseja que todos eles seja reiniciado, você deve usar essa opção.

Observe que qualquer alteração feita usando a guia ASP.NET no aplicativo de console do Internet serviço de informações também fazer com que todos os pools de aplicativos ser reciclado. Se você desejar alterar a versão do ASP.NET um aplicativo usa sem fazer com que todos os pools de aplicativos para reciclagem, execute os dois comandos a seguir para alterar a versão.

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

A ferramenta de inscrição de IIS do ASP.NET também pode ser usada para instalar e desinstalar a versão vinculada do ASP.NET. Use o -i opção para instalar o ASP.NET e atualizar os mapas de script de todos os aplicativos ASP.NET existentes. Use o -ir opção para instalar o ASP.NET sem atualizar o script mapeia. Para desinstalar a versão do ASP.NET que está associada com a ferramenta, use o -u opção. Se você deseja desinstalar todas as versões do ASP.NET do computador, use o -ua opção.

Você também pode usar a ferramenta de inscrição de IIS do ASP.NET para exibir informações sobre o ASP.NET. Para listar o status e o caminho da instalação de todas as versões do ASP.NET instaladas no seu computador, use o -lv opção. Se desejar ver os caminhos para todas as chaves de metabase do IIS em que o ASP.NET é mapeado, use o -lk opção.

Script do lado do cliente, sistema autônomo a validação do lado do cliente, pode ser instalado e removido usando Aspnet_regiis.exe. Use o -c opção de instalar o script do lado do cliente para a versão do ASP.NET que está associado com a ferramenta para a subdiretório Aspnet_cliente de cada diretório de sites do IIS. Para remover o script do lado do cliente apenas da versão do ASP.NET associada à ferramenta, use o -e opção. Para remover o script do lado do cliente para todas as versões instaladas do ASP.NET, use o -ea opção.

Quando você estiver usando representação, se a conta de personificação não tiver acesso de leitura à metabase do IIS, um COMExceptionexceção com a mensagem "acesso negado" é lançada quando você tentar acessar DirectoryEntry. Isso pode ocorrer quando o subdiretório de código do aplicativo existe no diretório raiz do aplicativo. Este erro também pode ocorrer quando um aplicativo é mapeado para um compartilhamento UNC e a conta UNC não tem acesso de leitura à metabase. In both cases, running the ASP.NET IIS Registration tool with the **-ga **user option for the impersonation or UNC account fixes the issue.

Para obter mais informações sobre a execução lado a lado no ASP.NET, consulte Suporte Lado-a-laddo no ASP.NET. Para obter mais informações sobre mapas de script e caminhos de raiz do aplicativo, consulte o Documentação do IIS no site da Microsoft.

Exemplos

O comando a seguir instala os mapas de script apontando para a versão do ASP.NET que está associada com a ferramenta para o aplicativo SampleApp1 e todos os seus subdiretórios.

aspnet_regiis -s W3SVC/1/ROOT/SampleApp1

O comando a seguir só atualiza os mapas de script para o aplicativo SampleApp1, sem afetar os aplicativos nos subdiretórios.

aspnet_regiis -sn W3SVC/1/ROOT/SampleApp1

O comando a seguir instala a versão do ASP.NET que está associado com a ferramenta de inscrição de IIS do ASP.NET e atualiza os mapas de script de todos os aplicativos ASP.NET existentes. Observe que somente os aplicativos que atualmente são mapeados para uma versão anterior do ASP.NET são afetados.

aspnet_regiis -i

O comando a seguir instala a versão do ASP.NET que está associada com a ferramenta, mas ele não atualização 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

Consulte também

Referência

Ferramentas.NET Framework

Outros recursos

Execução Lado a Lado