Partilhar via

Procedimento de instalação única para os exemplos do Windows Communication Foundation

  • Artigo

A maioria dos exemplos do Windows Communication Foundation (WCF) são hospedados no IIS (Serviços de Informações da Internet) e executados a partir de um diretório virtual comum. Este procedimento de configuração única cria uma pasta no disco; ele também adiciona um diretório virtual ao IIS chamado ServiceModelSamples.

O diretório virtual ServiceModelSamples é usado para criar e executar todos os exemplos que usam um serviço hospedado no IIS. Este é o único diretório virtual necessário para executar os exemplos. A criação de um exemplo substituirá qualquer serviço implantado anteriormente neste diretório virtual; Somente o exemplo criado mais recentemente será implantado e estará disponível neste diretório virtual.

Nota

  • Você deve executar todos os comandos em uma conta de administrador local. Se você estiver usando o Windows 7, Windows Vista ou Windows Server 2008 R2, também deverá executar o prompt de comando com privilégios elevados. Para fazer isso, clique com o botão direito do mouse no ícone do prompt de comando e, em seguida, clique em Executar como administrador.
  • Todos os comandos neste artigo devem ser executados em um prompt de comando que tenha as configurações de caminho apropriadas. A maneira mais fácil de garantir isso é usando o prompt de comando do desenvolvedor para Visual Studio.

Procedimento de configuração única para amostras de WCF

  1. Certifique-se de que ASP.NET está configurado. Para obter mais informações sobre como configurar o ASP.NET, consulte Instruções de hospedagem do Internet Information Service.

  2. Verifique se o .NET Framework 4+ está instalado. Pesquise o seguinte diretório para v4.0 (ou posterior): \Windows\Microsoft.NET\Framework

  3. Verifique se você tem o Visual Studio 2012 ou posterior instalado ou se seu sistema operacional é o Windows Server 2008 SP2 ou posterior.

  4. Execute os seguintes comandos. Para obter mais informações sobre por que esses comandos devem ser executados, consulte IIS Hosted Service Fails.

    Aviso

    Se o IIS for reinstalado, os comandos a seguir precisarão ser executados novamente.

    "%WINDIR%\Microsoft.Net\Framework\v4.0.30319\aspnet_regiis" –i –enable
"%WINDIR%\Microsoft.Net\Framework\v4.0.30319\ServiceModelReg.exe" -r

    Aviso

    A execução do comando aspnet_regiis –i –enable fará com que o Pool de Aplicativos Padrão seja executado usando o .NET Framework 4, o que pode gerar problemas de incompatibilidade para outros aplicativos no mesmo computador.

  5. Siga as instruções do firewall para ativar as portas usadas pelos exemplos.

  6. Execute o Setupvroot.bat arquivo em lotes. As seguintes etapas são executadas:

    • Um diretório virtual é criado no IIS chamado ServiceModelSamples.

    • Novos diretórios de disco são criados denominados %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples e %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples\bin.

    Se preferir configurar esses diretórios manualmente, consulte as Instruções de configuração do diretório virtual. Para reverter todas as alterações feitas nesta etapa, execute cleanupvroot.bat depois de terminar de usar os exemplos.

    Nota

    Este procedimento deve ser executado apenas uma vez em um computador, a menos que você execute cleanupvroot.bat.

  7. Você deve conceder permissão para modificar para %SystemDrive%\inetpub\wwwroot para a conta sob a qual você está criando os exemplos e o usuário do Serviço de Rede. Durante a construção, alguns exemplos hospedados na Web podem tentar copiar os binários compilados para o local mencionado anteriormente e, se você não tiver definido as permissões apropriadas, a compilação será interrompida. Como alternativa, você pode deixar as permissões como estão e executar o prompt de comando do SDK ou o Prompt de Comando do Visual Studio (2012) como Administrador, ou criar os exemplos no Visual Studio 2012, também executados como Administrador.

    Nota

    Se esta etapa não for concluída, todos os exemplos hospedados no IIS falharão durante a compilação. Certifique-se de definir as permissões corretamente ou execute o prompt de comando do SDK e o prompt de comando do Visual Studio como administrador.

  8. Crie um diretório C:\logs no computador porque alguns exemplos podem estar esperando por ele. Certifique-se de que a conta apropriada tem acesso de gravação concedido a esta pasta. Para Windows 7, Windows Vista e Windows Server 2008 R2, essa conta é Serviço de Rede. Para o Windows Server 2008, a conta é NT Authority\Network Service. Para Windows XP e Windows Server 2003, a conta é ASPNET.

  9. Execute o arquivo Setupcerttool.bat. Este script executa as seguintes tarefas:

    • Cria a ferramenta FindPrivateKey.

    • Cria um diretório chamado %ProgramFiles%\ServiceModelSampleTools.

    • Copia a nova ferramenta FindPrivateKey para este diretório.

    Essa ferramenta é exigida por exemplos que usam certificados e estão hospedados no IIS.

    Nota

    Para fins de segurança, lembre-se de remover a definição de diretório virtual e as permissões concedidas nas etapas de configuração acima, executando o arquivo em lotes chamado cleanupvroot.bat depois de concluir os exemplos.

  10. Exemplos que são auto-hospedados (não hospedados no IIS) exigem permissão para registrar endereços HTTP no computador para escutar. A permissão para uma reserva de namespace HTTP vem da conta de usuário usada para executar o exemplo. Por padrão, as contas de administrador têm permissão para registrar qualquer endereço HTTP. As contas que não sejam de administrador devem receber permissão para os namespaces HTTP usados pelos exemplos. Para obter mais informações sobre como configurar reservas de namespace, consulte Configurando HTTP e HTTPS.

  11. Alguns exemplos requerem o serviço de enfileiramento de mensagens. Consulte Instalando o serviço de enfileiramento de mensagens (MSMQ) para obter instruções de instalação.

    Nota

    Certifique-se de iniciar o serviço MSMQ antes de executar quaisquer exemplos que exijam o serviço de enfileiramento de mensagens.

  12. Algumas amostras requerem certificados. Consulte Instruções de instalação do certificado de servidor do IIS (Serviços de Informações da Internet).