O utilitário aspnet_regiis é uma ferramenta de linha de comando fornecida com o .NET Framework que permite configurar, registrar e gerenciar a instalação do ASP.NET no Internet Information Services (IIS). Este artigo técnico irá guiá-lo através de como usar o aspnet_regiis para várias tarefas administrativas no ambiente Windows.

Introdução ao aspnet_regiis

O aspnet_regiis é uma ferramenta poderosa que pode ser usada para:

• Registrar ou desregistrar o ASP.NET com o IIS.
• Atualizar o mapeamento de scripts do ASP.NET.
• Configurar permissões de segurança para aplicativos ASP.NET.
• Exportar e importar chaves de criptografia de configuração.

Pré-requisitos

• Windows Server com IIS instalado.
• .NET Framework instalado.

Localização do aspnet_regiis

O utilitário aspnet_regiis está localizado na pasta do .NET Framework. Dependendo da versão do .NET Framework que você está usando, o caminho pode variar. Por exemplo:

• Para .NET Framework 4.0: C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe
• Para .NET Framework 2.0: C:\Windows\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis.exe

Exemplos Práticos

1. Registrar o ASP.NET com o IIS

Para registrar o ASP.NET com o IIS, você pode usar o seguinte comando:

C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i

Este comando instala e registra o ASP.NET 4.0 no IIS.

2. Atualizar o Mapeamento de Scripts

Para atualizar o mapeamento de scripts para ASP.NET, use o comando:

C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -r

Este comando atualiza todos os mapeamentos de scripts do ASP.NET no IIS.

3. Configurar Permissões de Segurança

Para configurar permissões de segurança para um aplicativo ASP.NET, você pode usar:

C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -ga "NomeDoUsuario"

Este comando concede ao usuário especificado as permissões necessárias para executar aplicativos ASP.NET.

4. Exportar Chaves de Criptografia

Para exportar chaves de criptografia de configuração, use:

C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -px "RSAProvider" "C:\chave.xml" -pri

Este comando exporta a chave RSA usada para criptografia de configuração para um arquivo XML.

5. Importar Chaves de Criptografia

Para importar chaves de criptografia de configuração, use:

C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -pi "RSAProvider" "C:\chave.xml"

Este comando importa a chave RSA de um arquivo XML para o provedor de criptografia.

Conclusão

O aspnet_regiis é uma ferramenta essencial para administradores que gerenciam aplicativos ASP.NET no IIS. Ele oferece uma variedade de opções para registrar, configurar e gerenciar o ASP.NET de forma eficiente. Com os exemplos fornecidos, você deve estar bem equipado para começar a usar essa ferramenta em seu ambiente Windows.