Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

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

ASP\ de ASP.NET a ferramenta de registro de IIS (Aspnet_regiis. exe) é usada para registrar o ASP.NET aplicativos com o Internet Information Services (IIS). Este tópico descreve as opções de sintaxe e outras informações para uso da ferramenta.

Usando o ASP.NET ferramenta de registro de IIS, você pode executar tarefas, como a seguir:

  • Registrar ou remover o.NET Framework ASP.NET instalação do IIS.

  • Crie novo ASP.NETpools deaplicativo .

  • Exiba o status de todas as versões instaladas do ASP.NET.

Observação importanteImportante

A versão do Aspnet_regiis incluída com o .NET Framework versão 4 possui novos recursos, que estão resumidos na Opções seção. No entanto, esses recursos só estão disponíveis quando você instalar o .NET Framework 4 em Windows Vista, Windows Server 2008, ou Windows 7. Se você instalar o .NET Framework versão 4 em qualquer versão do Windows XP ou Windows Server 2003, a ferramenta funciona exatamente como na versão 3.5 e anterior do.NET Framework. Para obter detalhes sobre como o Aspnet_regiis funciona em Windows XP ou Windows Server 2003, consulte ASP.NET ferramenta de registro IIS para o.NET Framework versão 3.5.

O .NET Framework 4 pode ser instalado lado--lado com versões anteriores do.NET Framework em um único computador. Se o IIS estava ativado anteriormente no computador, o processo de instalação para o.NET Framework registra automaticamente ASP.NET 4 com o IIS. No entanto, se você instalar o .NET Framework 4 antes de habilitar o IIS, você deve executar o ASP.NET ferramenta de registro de IIS para registrar o.NET Framework com IIS e criar aplicativo que usam de pools de .NET Framework 4.

Observação de cuidadoCuidado

Para obter informações sobre como localizar a versão correta do Aspnet_regiis. exe, consulte Finding the Correct Version of Aspnet_regiis.exe posteriormente no documento.

aspnet_regiis [options]

O i, ir, iru e enable opções normalmente são as únicas opções que você precisa para registrar o ASP.NET aplicativos com o IIS.

OPTION

Descrição

-c

Opção de legado que não aplicar ao executar aplicativos em ASP.NET versão 4. Para obter informações sobre como essa opção funciona com versões anteriores do ASP.NET, consulte ASP.NET ferramenta de registro IIS para o.NET Framework versão 3.5.

-disable

No IIS 6.0 e no IIS 7.0 em execução no modo Clássico, desativa o ASP.NET ISAPI de extensão. O comando faz não aplicar a IIS 7.0 no modo Integrado.

Esta opção pode ser combinada somente com o -i, -ir, ou -r Opções. Ele é não está disponíveis com versões anteriores do IIS que o IIS 6.0.

-e

Remove os scripts de cliente para ASP.NET a partir do subdiretório do aspnet_client de cada diretório de sites do IIS.

Somente os scripts de cliente para o ASP.NET versão que está associada ao Aspnet_regiis. exe são removidos.

-ea

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

-enable

No IIS 6.0 e no IIS 7.0 no modo Clássico, a opção permite que o ASP.NET ISAPI de extensão. O comando faz não aplicar a IIS 7.0 no modo Integrado.

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

-ga user

Concede especificado usuário ou grupo acesso a metabase do IIS e outros diretórios que são usados por ASP.NET. Você geralmente usa esta opção quando você estiver criando uma personalizada conta de serviço. Para obter mais informações, consulte como: Crie uma conta de serviço para um ASP.NET aplicativo 2.0.

Esta opção é não está disponível com versões anteriores do ASP.NET que ASP.NET 2.0.

Para instalações em Windows Vista, Windows Server 2008, ou Windows 7, esta opção permite que você defina as ACLs de grupos.

ObservaçãoObservação
A versão do Aspnet_regiis. exe que é fornecido em ASP.NET versão 3.5 e versões anteriores falhar ao especificar um usuário ou grupo local.

-i

Instala o ASP\ de ASP.NET 4 e atualizações de aplicativos para usar o ASP.NET 4 versão do pool de aplicativo . Ele atualiza o modo Clássico do IIS e os mapeamentos de script e o manipulador de modo Integrado do IIS na metabase do IIS.

Essa opção cria dois pools de aplicativo , ASP.NET v4.0 e ASP.NET v4.0 Classic. O DefaultAppPoolpool deaplicativo e o Classic .NETAppPoolpools deaplicativo são definidos para o.NET Framework 4 versão do CLR.

A 32 de bits de- versão do Aspnet_regiis. exe adiciona somente 32 mapas de script de bits de-no arquivo applicationHost. config. O-bits x64 versão do Aspnet_regiis. exe adiciona 32-bits e 64-bits de mapas de script no arquivo applicationHost. config. Isso é feito porque-de 64-bit versões do Windows Vista, Windows Server 2008, ou Windows 7 instalações que tenham IIS 7.0 habilitado serão também tenham o Windows on Windows 64-bit (WOW64) suporte disponível.

ObservaçãoObservação
No Recursos do Windows caixa de diálogo do sistema operacional, a opção de ASP.NET integração não está selecionada.(Essa opção está na Internet Information Services seção.) O Recursos do Windows caixa de diálogo exibe apenas o status dos ASP.NET integração 2.0.Ele não exibe informações sobre a versão 4.

-ir

Instala e registra o ASP.NET 4. Esta opção é igual a -i opção exceto que essa opção não altera aversão CLRque está associado a qualquer pools de aplicativo existentes.

-iru

Se ASP.NET não está registrado com o IIS, executa as tarefas descritas para -i.

Se uma versão anterior de ASP.NET já está registrado com o IIS, essa opção executa as tarefas descritas para -ir.

-k path

Esta opção não é suportada em Windows Vista, Windows Server 2008, ou Windows 7.

Para obter informações sobre como essa opção funciona quando executado em Windows XP ou Windows Server 2003, consulte ASP.NET ferramenta de registro IIS para o.NET Framework versão 3.5.

-kn path

Esta opção não é suportada em Windows Vista, Windows Server 2008, ou Windows 7.

Para obter informações sobre como essa opção funciona quando executado em Windows XP ou Windows Server 2003, consulte ASP.NET ferramenta de registro IIS para o.NET Framework versão 3.5.

-lk

Lista o caminho e a versão de todas as chaves de metabase do IIS onde ASP.NET é mapeado. Esta opção não é suportada em Windows Vista e versões posteriores.

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

-lv

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

-norestart

Esta opção não é suportada em Windows Vista, Windows Server 2008, ou Windows 7.

Para obter informações sobre como essa opção funciona quando executado em Windows XP ou Windows Server 2003, consulte ASP.NET ferramenta de registro IIS para o.NET Framework versão 3.5.

-r

Executa as tarefas descritas para -i e switches além de todos os pools de aplicativo para usar o.NET do Framework 4 CLR.

-s path

Atualiza os mapas de script e o aplicativo-pool de atribuições para o aplicativo especificado e todos os aplicativos de sub-.

Para um não-raizWebaplicativo (não W3SVC\ ou W3SVC\ROOT), as configurações do pool de aplicativo para o não-daWebraizaplicativo e todos os seus aplicativos sub-são copiados para um novo pool de aplicativo denominado ASP.NET V4.0 nome do pool de aplicativo originale o não-raizWebaplicativo é movido para o novo pool de aplicativo . O novo pool de aplicativo tem as mesmas configurações como o pool de aplicativo original, exceto que a cópia é mapeada para o.NET Framework 4 CLR e tem ASP.NET 4 as configurações.

Se o novo pool de aplicativo ASP.NET V4.0 nome do pool de aplicativo original já existir, a etapa de criação e a clonagem de pool de aplicativo é ignorado. Em vez disso, o Aspnet_regiis. exe usa o pool de aplicativo existente e define-o para usar o.NET Framework 4 CLR, mas não faz outras alterações. A ferramenta move o aplicativo especificado e seus aplicativos de sub-para o aplicativocorrespondente-cópia do pool. aplicativode existente-pool as definições permanecem inalterada.

Se o aplicativo especificado for Web raiz (W3SVC\ ou W3SVC\ROOT), o Aspnet_regiis. exe atualiza todos os pools de aplicativo para usar o.ASP\ de líquido de Framework 4 CLR e ASP.NET 4.

-sn path

Executa as tarefas descritas para -s, exceto que -sn é recursiva. Atualiza os mapas de script e o aplicativo-pool de atribuições para apenas a determinado aplicativo. Aplicativos de sub-Não são alterados.

Se o aplicativo especificado for Web raiz (W3SVC\ ou W3SVC\ROOT), o Aspnet_regiis. exe altera os pools de aplicativo denominados DefaultAppPool, Classic .NET AppPool, ASP.NET V4.0, e ASP.NET  V4.0 Classic" Para usar o.ASP\ de líquido de Framework 4 CLR e ASP.NET 4.

-u

Para a desinstalação, deixa as duas 4 deixa de versões de pools de aplicativo , os aplicativos que estavam sendo dois versão 4 aplicativo pools.

Essa opção também remove o managedRuntimeVersionoatributo de pools de aplicativo o.NET Framework 4 CLR. Isso reverterá pools de aplicativo para o IIS 7.0 valor padrão para o tempo de execução, que é o 2.0 Windows Vista, Windows Server 2008, ou Windows 7.

A opção todos explicitamente remove mapeamentos de manipulador e módulo de definir a versão 4. Ela também remove todos os mapas de script (-de 32 bits e 64 bits de-), independentemente do-de 32 bits ou 64 bits do- versão do Aspnet_regiis. exe é usado.

-ua

Para a desinstalação, deixa as duas 4 versões do aplicativo pools e deixa a todos os aplicativos que estavam no dois versão 4 aplicativo pools.

Esta opção remove todos os ASP.NET (ambas as versões 2.0 e 4) de registros do arquivo applicationHost. config. Ela também remove todos os mapas de script (-de 32 bits e 64 bits de-), independentemente do-de 32 bits ou 64 bits do- versão do Aspnet_regiis. exe é usado.

Pools de aplicativo existentes ainda serão associados com o.NET Framework 2.0, porque esse é o valor padrão para o managedRuntimeVersion atributo.

-?

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

Opçõesde configuração

OPTION

Descrição

-config+

Permite o acesso remoto para ASP.NET configuração.

-config-

Desativa o acesso remoto para ASP.NET configuração.

-pa conta docontêiner

Concede permissão para o usuário ou grupo especificado account para acessar ocontêinerde a chaveespecificada. Esta opção pode levar os seguintes modificadores:

  • -pkuSubstitui um usuário-especificada do contêiner de computadorpadrãocontêiner.

  • -csp providerEspecifica oprovedor do contêinerpara usar.

  • -fullEspecifica que o acesso completo deve ser adicionado (por padrão, o acesso é somente leitura).

-pc contêiner

Cria um par de chaves RSA public/private no conteiner especificado. Esta opção pode levar os seguintes modificadores:

  • -size keySize   Especifica as principais dimensões. O padrão é 2048 bytes.

  • -pkuSubstitui um usuário-especificada do contêiner de chavepadrãocontêiner.

  • -expEspecifica as chaves particulares devem ser capazes de ser exportado.

  • -csp providerEspecifica oprovedor do contêinerpara usar.

-pd seção

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

  • -app virtualPathEspecifica que a descriptografia deve ocorrer no nível do caminho incluído.

  • -location subPathEspecifica o subdiretório para descriptografar.

  • -pkmEspecifica que o arquivo Machine. config deve ser descriptografado em vez de um arquivo Web. config.

-pdf seção webApplicationDirectory

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

-pe seção

Criptografa a seção de configuração do especificado. Esta opção pode levar os seguintes modificadores:

  • -prov providerEspecifica o provedor de criptografia para usar.

  • -app virtualPathEspecifica que a criptografia deve ocorrer no nível do caminho incluído.

  • -location subPathEspecifica o subdiretório para criptografar.

  • -pkmEspecifica que o arquivo Machine. config deve ser criptografado em vez de um arquivo Web. config.

-pef section webApplicationDirectory

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

-pi arquivo decontêiner

Importações um par de chave pública RSA/Particular para o especificado container a partir de um especificado XML file. Esta opção pode levar os seguintes modificadores:

  • -pkuSubstitui um usuário-especificada do contêiner de computadorpadrãocontêiner.

  • -expEspecifica que as chaves particulares podem ser exportadas.

  • -csp providerEspecifica oprovedor do contêinerpara usar.

-pr conta docontêiner

Remove a permissão para o usuário ou grupo especificado account para acessar ocontêinerde a chaveespecificada. Esta opção pode levar os seguintes modificadores:

  • -pkuSubstitui um usuário-especificada do contêiner de computadorpadrãocontêiner.

  • -csp providerEspecifica oprovedor do contêinerpara usar.

-px arquivo decontêiner

Exporta um par de chaves pública/privada RSA do container especificado para o arquivo XML especificado. Esta opção pode levar os seguintes modificadores:

  • -pkuSubstitui um usuário-especificada do contêiner de computadorpadrãocontêiner.

  • -csp providerEspecifica oprovedor do contêinerpara usar.

-pz contêiner

Exclui o recipiente de chave especificado. Esta opção pode levar o modificador do seguinte:

  • -pkuSubstitui um usuário-especificada do contêiner de computadorpadrãocontêiner.

Quando várias versões do ASP.NET estão instalados em um computador, as versões do ASP.NET está sendo executado -lado a lado de-. Nesse cenário, você deve configurar o IIS para indicar qual versão do ASP.NET ISAPI (aspnet_isapi. dll) deve o processo uma página em um ASP.NET aplicativo. Em IIS 7.0, clássico e o modo Integrado, aversão CLRdefinido para o pool de aplicativo determina qual versão do ASP.NET e qual associada a versão do CLR são usados para executar um aplicativo. No IIS 6.0, um mapa de script é usado para associar um aplicativo um determinado ASP.NET ISAPI versãoe a versão da ISAPI por sua vez determina qual versão do CLR é usada para executar o aplicativo.

Há-de 32 bits e 64 bit versions de-do Aspnet_regiis. exe. Para Windows Vista e Windows Server 2008, você pode executar a 32-bits versão da ferramenta em uma instalação de bit-64 do IIS. Isso permite executar misto 32-bits e 64 sistema de processos em que o mesmo-de 64 bits-bits operador. A tabela a seguir lista as limitações e casos especiais que aplicar ao executar a 32-bits versão da ferramenta em um-bits x64 versão do IIS.

IIS Version

Versões de casos especiais para-de 32 bits do Aspnet_regiis. exe

6.0

Você pode executar a instalação do IIS 6.0 da versão do Aspnet_regiis. exe em um-de 64 bits de bit do-32 em Windows Server 2003 com as seguintes restrições:

  • O 32-bits versão executa somente se o IIS tiver sido definido para ser executado em 32-modo bits.

  • A 64-bits versão executa somente se o IIS foi definido para ser executado em 64-modo de bits.

7.0

Em Windows Vista, Windows Server 2008, ou Windows 7, quando você executar o 32-bits versão do Aspnet_regiis. exe no IIS 7, a ferramenta não define automaticamente a enable32BitAppOnWin64deatributo da applicationPools elemento. Em um 64-bits de instalação do sistema operacional, com o Windows on Windows 64 habilitada por padrão, você pode usar 32-bits Aspnet_regiis. exe para configurar o IIS 7, mas você não será capaz de executar qualquer 32-bits de aplicativos, a menos que você altere explicitamente a enable32BitAppOnWin64deatributo para permitir que o aplicativo em execução no Windows on Windows 64. Para obter mais informações sobre IIS 7.0Opções deconfiguração , consulte a documentação para o applicationPools o elemento no arquivo applicationHost. config.

ASP\ de ASP.NET ferramenta de registro de IIS é normalmente usada com o -s ou a opção-sn para remapear um ASP.NETaplicativo para a versão do.NET Framework que está associado. Use o -s opção para atualização um aplicativo no caminho da raiz do especificado e em todas as subpastas. Se você não quiser que os aplicativos nos subdiretórios sejam atualizados, use o -sn opção.

ObservaçãoObservação

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

Você também pode usar o ASP.NET ferramenta de registro de IIS para exibir informações sobre ASP.NET. Para listar o caminho de instalação e o status de todas as versões do ASP.NET que são instalados em seu computador, use o -lv opção.

O -norestart opção impede a reinicialização do serviço de publicação na World Wide Web após ASP.NETmapas descript são instalados ou atualizados. Se você estiver executando vários sites Web no IIS e eles são em diversos pools de aplicativo , e se você não quiser que todas elas seja reiniciado, use esta opção.

Qualquer alteração feita usando o ASP.NET guia o aplicativo de console de serviço de informações da Internet também fazer com que todos os pools de aplicativo ser reciclado. Se você deseja alterar o ASP.NETque usa um aplicativo sem causar todos os pools de aplicativo ser reciclado, executar dois comandos a seguir para alterar a versãodaversão .

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

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

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

Você pode usar o Aspnet_regiis. exe para instalar e remover o sistema cliente-lado script, como o script de validaçãodo lado do cliente-. Use o -c a opção para instalaroscript de cliente para a versão de ASP.NET está associado à ferramenta. (Script é instalado no subdiretório do Aspnet_client de cada diretório de sites do IIS). Para remover do-lado script de cliente apenas ASP\ ASP.NET versão que está associado com a 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 e se a conta de representação não tiver acesso de leitura à metabase do IIS, um COMException exceção com a mensagem "acesso negado" é acionada quando você tenta acessar DirectoryEntry. Isso pode ocorrer quando o subdiretório de Código do aplicativo existe no diretórioraiz de aplicativo. Esse erro também pode ocorrer quando um aplicativo é mapeado para um compartilhamento UNC e a conta UNC não tem acesso de leitura à metabase. Em ambos os casos, executando o ASP.NET IIS Registration Tool com a opção usuário -ga para a representação ou conta UNC corrige o problema.

Para obter mais informações sobre caminhos deraiz do aplicativoe mapas de script, consulte o a documentação do IIS no site da Microsoft Web .

O comando a seguir instala o ASP.NET versão que está associado com a versão do ASP.NET ferramenta de registro de IIS que você está usando e atualizações existentes ASP.NET aplicativos. No IIS 6.0, o comando atualiza os mapas de script de ASP\ de ASP.NET aplicativos que atualmente são mapeados para uma versão anterior de ASP.NET. Em IIS 7.0, o comando atualiza o modo clássico e manipuladores de modo integrado na metabase do IIS. Ele também alterna o DefaultAppPool e o pools deClassic  .NET AppPool de aplicativos para usar o.NET do Framework 4 CLR.

aspnet_regiis -i

O comando a seguir instala o ASP.NET versão que está associado com a ferramenta sem atualizar os aplicativos existentes. Em IIS 7.0, faz o comando não atualização a versão do.NET Framework associado com o DefaultAppPool e Classic .NET AppPoolpools deaplicativo .

aspnet_regiis -ir

O seguinte comando exibe o status do caminho e instalação de todas versões do ASP.NET que estão instaladas no computador.

aspnet_regiis -lv

O comando a seguir atualiza umaplicativo de Webe todos os seus aplicativos sub-para usar o ASP.NETversão que está associado com a ferramenta. No IIS 6.0, os mapas de script são atualizados. Em IIS 7.0, o aplicativo é mapeado para um novo pool de aplicativo .

aspnet_regiis -s W3SVC/1/ROOT/SampleApp1

O seguinte comando executa as mesmas funções que o -s de comando, exceto que ele não afeta os aplicativos nos subdiretórios.

aspnet_regiis -sn W3SVC/1/ROOT/SampleApp1

O comando a seguir concede o usuário ou especificado acesso de contas de grupo para a metabase do IIS e outros diretórios usados por ASP.NET.

aspnet_regiis -ga MyUserGroup W3SVC/1/ROOT/SampleApp1

Aspnet_regiis. exe é instalado no Microsoft.NET Framework directory. Se o computador estiver executando vários.NET Framework versões lado a-pelo lado de-, várias versões da ferramenta podem ser instaladas. A tabela a seguir lista os locais onde a ferramenta está instalada para versões diferentes do.NET Framework.

Versão do.NET Framework

Local doarquivo .exedo Aspnet_regiis

.NET Framework version 1

%windir%\.NET\Framework\v1.0.3705

.NET Framework version 1.1

%windir%\Microsoft.NET\Framework\v1.1.4322

.NET Framework versão 2.0, versão 3.0 e a versão 3.5 (32-sistemas de bit)

%windir%\Microsoft.NET\Framework\v2.0.50727

.NET Framework versão 2.0, versão 3.0 e a versão 3.5 (64-sistemas de bit)

%windir%\Microsoft.NET\Framework64\v2.0.50727

.NET Framework versão 4 (32-sistemas de bit)

%windir%\Microsoft.NET\Framework\v4.0.30319

.NET Framework versão 4 (64-sistemas de bit)

%windir%\Microsoft.NET\Framework64\v4.0.30319

Diretórios para o.NET Framework versões 3.0 e 3.5 não tem uma cópia da ferramenta. Para obter mais informações, consulte a entrada como configurar um aplicativo do IIS ou o AppPool use ASP.NET 3.5 em vez de 2.0 no blog de Scott Hanselman.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft