Compartilhar via

One-Time Procedimento de configuração para as amostras do Windows Communication Foundation

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

O diretório virtual ServiceModelSamples é usado para compilar e executar todos os exemplos que usam um serviço hospedado pelo IIS. Esse é 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 compilado mais recentemente será implantado e disponível neste diretório virtual.

Observação

  • Você deve executar todos os comandos em uma conta de administrador local. Se você estiver usando o Windows 7, o Windows Vista ou o 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 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 instalação único para exemplos do WCF

  1. Verifique se ASP.NET está configurado. Para obter mais informações sobre como configurar ASP.NET, consulte instruções de hospedagem do Serviço de Informações da Internet.

  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 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 Falha no serviço hospedado do IIS.

    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 de Firewall para habilitar as portas usadas pelos exemplos.

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

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

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

    Se você preferir configurar esses diretórios manualmente, consulte as Instruções de Instalação do Diretório Virtual. Para reverter todas as alterações feitas nesta etapa, execute cleanupvroot.bat após concluir o uso dos exemplos.

    Observação

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

  7. É necessário conceder permissão para modificar %SystemDrive%\inetpub\wwwroot à conta em que os exemplos e o usuário do Serviço de Rede estão sendo compilados. Durante a criação, alguns exemplos hospedados pela Web podem tentar copiar os binários compilados para o local mencionado anteriormente e, se você não tiver definido as permissões apropriadas, o build será interrompido. 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 compilar os exemplos no Visual Studio 2012, também executado como Administrador.

    Observação

    Se esta etapa não for concluída, todos os exemplos hospedados pelo IIS falharão durante a compilação. Verifique se você definiu 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 precisar dele. Verifique se 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 arquivoSetupcerttool.bat. Esse 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 são hospedados no IIS.

    Observação

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

  10. Os exemplos auto-hospedados (não hospedados no IIS) exigem permissão a fim de registrar endereços HTTP no computador para escuta. 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 a permissão para registrar qualquer endereço HTTP. As contas não 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 exigem Enfileiramento de Mensagens. Veja Instalação de Enfileiramento de Mensagens (MSMQ) para obter instruções de instalação.

    Observação

    Certifique-se de iniciar o serviço MSMQ antes de executar os exemplos que exigem o Enfileiramento de Mensagens.

  12. Alguns exemplos exigem certificados. Consulte as instruções de instalação do certificado do servidor do IIS (Serviços de Informações da Internet).