Partilhar via

O Pacote de Alojamento .NET

Observação

Esta não é a versão mais recente deste artigo. Para a versão atual, consulte a versão .NET 10 deste artigo.

Advertência

Esta versão do ASP.NET Core não é mais suportada. Para obter mais informações, consulte a Política de suporte do .NET e .NET Core. Para a versão atual, consulte a versão .NET 9 deste artigo.

O .NET Hosting bundle é um instalador para o .NET Runtime e o ASP.NET Core Module. O pacote permite que os aplicativos ASP.NET Core sejam executados com o IIS.

Instale o Pacote de Alojamento .NET

Importante

Se o Pacote de Hospedagem estiver instalado antes do IIS, a instalação do pacote deverá ser reparada. Execute o instalador do Hosting Bundle novamente após a instalação do IIS.

Se o Pacote de Hospedagem for instalado após a instalação da versão .NET de 64 bits (x64), os SDKs podem parecer ausentes (não foram detetados SDKs .NET). Para resolver o problema, consulte Solucionar e depurar problemas em projetos ASP.NET Core.

Alterações significativas e avisos de segurança são reportados no repositório de anúncios . Os anúncios podem ser limitados a uma versão específica selecionando um filtro Rótulo.

Download direto

Faça o download do instalador usando os seguintes links:

Requisito redistribuível do Visual C++

Em versões mais antigas do Windows, por exemplo o Windows Server 2012 R2, instale o Visual Studio C++ 2015, 2017, 2019 Redistributable. Caso contrário, uma mensagem de erro confusa no log de eventos do Windows informa que The data is the error.

Redistribuível VS C++ atual para x64Redistribuível VS C++ atual para x86

Versões anteriores do instalador

Para obter uma versão anterior do instalador:

  1. Navegue até à página de Download .NET .
  2. Selecione a versão .NET desejada.
  3. Na coluna Executar aplicações - Runtime , encontre a linha da versão de runtime .NET desejada.
  4. Faça o download do instalador usando o link Hosting Bundle .

Advertência

Alguns instaladores contêm versões de lançamento que atingiram seu fim de vida útil (EOL) e não são mais suportadas pela Microsoft. Para obter mais informações, consulte a política de suporte.

O ASP.NET Core Module é compatível com versões anteriores e posteriores do .NET.

Opções

  1. Os seguintes parâmetros estão disponíveis ao executar o instalador a partir de um shell de comando do administrador:

    • OPT_NO_ANCM=1: Ignore a instalação do ASP.NET Core Module.
    • OPT_NO_RUNTIME=1: Ignorar a instalação do ambiente de execução .NET. Usado quando o servidor somente hospeda implantações autónomas (SCD).
    • OPT_NO_SHAREDFX=1: Ignore a instalação do ASP.NET Shared Framework (ASP.NET tempo de execução). Usado quando o servidor somente hospeda implantações autónomas (SCD).
    • OPT_NO_X86=1: Ignore a instalação de tempos de execução x86. Use esse parâmetro quando souber que não hospedará aplicativos de 32 bits. Se houver alguma chance de você hospedar aplicativos de 32 bits e 64 bits no futuro, não use esse parâmetro e instale ambos os tempos de execução.
    • OPT_NO_SHARED_CONFIG_CHECK=1: Desative a verificação do uso de uma Configuração Compartilhada do IIS quando a configuração compartilhada (applicationHost.config) estiver na mesma máquina que a instalação do IIS. Disponível apenas para instaladores do ASP.NET Core 2.2 ou posterior do Hosting Bundler. Para obter mais informações, consulte Configuração avançada.

Observação

Para obter informações sobre a Configuração Compartilhada do IIS, consulte ASP.NET Módulo Principal com Configuração Compartilhada do IIS.

Observação

Ao executar o instalador do Hosting Bundle com opções definidas, o valor de cada opção é salvo no registro. Instalações subsequentes dentro da mesma faixa de versão Major.Minor usam as mesmas opções, a menos que outro conjunto de opções seja explicitamente fornecido através da linha de comando. Se a primeira instalação do pacote de hospedagem não tiver opções passadas, cada opção receberá um valor padrão de 0 gravado no registro. Um valor de 0 implica que a opção está desativada, o que significa que o usuário não está optando por sair do componente fornecido.

Reiniciar o IIS

Depois que o Pacote de Hospedagem for instalado, uma reinicialização manual do IIS pode ser necessária. Por exemplo, as dotnet ferramentas da CLI (comando) podem não existir no PATH para executar processos de trabalho do IIS.

Para reiniciar manualmente o IIS, pare o Serviço de Ativação de Processos do Windows (WAS) e, em seguida, reinicie o Serviço de Publicação na World Wide Web (W3SVC) e quaisquer serviços dependentes. Execute os seguintes comandos em um shell de comando elevado:

net stop was /y
net start w3svc

Versão do módulo e logs do instalador do Hosting Bundle

Para determinar a versão do ASP.NET Core Module instalado:

  1. No sistema de hospedagem, navegue até %PROGRAMFILES%\IIS\Asp.Net Core Module\V2.
  2. Localize o aspnetcorev2.dll arquivo.
  3. Clique com o botão direito do mouse no arquivo e selecione Propriedades no menu contextual.
  4. Selecione a guia Detalhes . A versão do arquivo e a versão do produto representam a versão instalada do módulo.

Os logs do instalador do Hosting Bundle para o módulo podem ser encontrados em C:\Users\%UserName%\AppData\Local\Temp. O ficheiro é chamado dd_DotNetCoreWinSvrHosting__{TIMESTAMP}_000_AspNetCoreModule_x64.log, onde o marcador de posição {TIMESTAMP} é o carimbo de data/hora do ficheiro.

  • Last updated on