Partilhar via

Pacote de hospedagem do .NET Core

  • Artigo

Observação

Esta não é a versão mais recente deste artigo. Para informações sobre a versão vigente, confira a Versão do .NET 8 deste artigo.

Aviso

Esta versão do ASP.NET Core não tem mais suporte. Para obter mais informações, confira .NET e a Política de Suporte do .NET Core. Para informações sobre a versão vigente, confira a Versão do .NET 8 deste artigo.

Importante

Essas informações relacionam-se ao produto de pré-lançamento, que poderá ser substancialmente modificado antes do lançamento comercial. A Microsoft não oferece nenhuma garantia, explícita ou implícita, quanto às informações fornecidas aqui.

Para informações sobre a versão vigente, confira a Versão do .NET 8 deste artigo.

O pacote de Hospedagem do .NET Core é um instalador para o Runtime do .NET Core e o Módulo do ASP.NET Core. O executar permite que aplicativos do ASP.NET Core sejam executados com IIS.

Instalar o pacote de hospedagem do .NET Core

Importante

Se o pacote de hospedagem for instalado antes do IIS, a instalação do pacote deverá ser reparada. Execute o instalador do pacote de hospedagem novamente depois de instalar o IIS.

Se o pacote de hospedagem for instalado após a instalação da versão de 64 bits (x64) do .NET Core, os SDKs poderão parecer estar ausentes (Nenhum SDK do .NET Core foi detectado). Para resolver o problema, consulte Solucionar problemas e depurar projetos do ASP.NET Core.

Alterações interruptivas e avisos de segurança são relatados no repositório Comunicados. Os comunicados podem ser limitados a uma versão específica selecionando um filtro Rótulo.

Download direto

Baixe o instalador usando os seguintes links:

Requisito de Pacote Redistribuível do Visual C++

Em versões mais antigas do Windows como, por exemplo, no Windows Server 2012 R2, instale o Pacote Redistribuível do Visual Studio C++ 2015, 2017, 2019. Caso contrário, uma mensagem de erro confusa no Log de Eventos do Windows relata que The data is the error.

Pacote Redistribuível atual do x64 VS C++Pacote Redistribuível atual do x86 VS C++

Versões anteriores do instalador

Para obter uma versão anterior do instalador:

  1. Navegue até a página Baixar o .NET Core.
  2. Selecione a versão desejada do .NET Core.
  3. Na coluna Executar aplicativos – runtime, localize a linha da versão de runtime do .NET Core desejada.
  4. Baixe o instalador usando o link Pacote de hospedagem.

Aviso

Alguns instaladores contêm versões de lançamento que atingiram o EOL (fim da vida útil) e não têm mais suporte da Microsoft. Para saber mais, confira a política de suporte.

O Módulo ASP.NET Core é compatível com as versões no suporte do .NET.

Opções

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

    • OPT_NO_ANCM=1: ignorar a instalação do Módulo do ASP.NET Core.
    • OPT_NO_RUNTIME=1: ignorar a instalação do runtime do .NET Core. Usado quando o servidor hospeda apenas implantações autossuficientes (SCD).
    • OPT_NO_SHAREDFX=1: ignorar a instalação da Estrutura Compartilhada do ASP.NET (runtime do ASP.NET). Usado quando o servidor hospeda apenas implantações autossuficientes (SCD).
    • OPT_NO_X86=1: ignorar a instalação dos runtimes x86. Use esse parâmetro quando você souber que não hospedará aplicativos de 32 bits. Se houver uma possibilidade de hospedar aplicativos de 32 bits e 64 bits no futuro, não use esse parâmetro e instale ambos os runtimes.
    • OPT_NO_SHARED_CONFIG_CHECK=1: desabilite a verificação para usar uma Configuração Compartilhada do IIS quando a configuração compartilhada (applicationHost.config) estiver no mesmo computador do que a instalação do IIS. Disponível somente para instaladores do ASP.NET Core 2.2 ou Hosting Bundler posterior. Para obter mais informações, consulte Configuração avançada.

Observação

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

Observação

Ao executar o instalador do Pacote de Hospedagem com opções definidas, o valor de cada opção é salvo no registro. As instalações subsequentes da mesma banda de versão Major.Minor usam as mesmas opções, a menos que outro conjunto de opções seja explicitamente passado da linha de comando. Se a primeira instalação do pacote de hospedagem não tiver nenhuma opção passada, cada opção obterá 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á recusando o componente fornecido.

Reinicie os IIS

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

Para reiniciar o IIS manualmente, interrompa o WAS (Serviço de Ativação de Processo do Windows) e reinicie o W3SVC (Serviço de Publicação na World Wide Web) e quaisquer serviços dependentes. Execute os seguintes comandos em um shell de comando com privilégios elevados:

net stop was /y
net start w3svc

Versão do módulo e logs do instalador do pacote de hospedagem

Para determinar a versão do Módulo do ASP.NET Core instalado:

  1. No sistema de hospedagem, acesse %PROGRAMFILES%\IIS\Asp.Net Core Module\V2.
  2. Localize o arquivo aspnetcorev2.dll.
  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 de instalador do pacote de hospedagem para o módulo são encontrados em C:\Users\%UserName%\AppData\Local\Temp. O arquivo é chamado dd_DotNetCoreWinSvrHosting__{TIMESTAMP}_000_AspNetCoreModule_x64.log, onde o espaço reservado {TIMESTAMP} é o carimbo de data/hora do arquivo.