Процедура однократной настройки образцов Windows Communication Foundation

большинство примеров Windows Communication Foundation (WCF) размещаются в службы IIS (IIS) и запускаются из общего виртуального каталога. Эта одноразовая процедура установки создает папку на диске; Он также добавляет виртуальный каталог в IIS с именем servicemodelsamples.

Виртуальный каталог servicemodelsamples используется для создания и запуска всех примеров, использующих размещенную в IIS службу. Это единственный виртуальный каталог, необходимый для выполнения примеров. При построении образца будет заменена любая служба, развернутая ранее в этом виртуальном каталоге. Развернут и доступен в данном виртуальном каталоге будет только последний построенный образец.

Примечание

  • Необходимо выполнить все команды от имени учетной записи локального администратора. если вы используете Windows 7, Windows Vista или Windows Server 2008 R2, также необходимо запустить командную строку с повышенными привилегиями. Для этого щелкните правой кнопкой мыши значок командной строки и выберите команду Запуск от имени администратора.
  • Все команды в этой статье должны выполняться в командной строке с соответствующими параметрами пути. Самый простой способ обеспечить это с помощью Командная строка разработчика для Visual Studio.

Однократно настраиваемая процедура для образцов WCF

  1. убедитесь, что ASP.NET настроено. дополнительные сведения о настройке ASP.NET см. в разделе инструкции по размещению службыiis.

  2. убедитесь, что установлен платформа .NET Framework 4 +. выполните поиск в следующем каталоге версии 4.0 (или более поздней): \ Windows \микрософт.нет\фрамеворк

  3. убедитесь, что на компьютере установлено Visual Studio 2012 или более поздней версии или установлена операционная система Windows Server 2008 SP2 или более поздней версии.

  4. Выполните указанные ниже команды. Дополнительные сведения о том, почему должны выполняться эти команды, см. в разделе сбой размещенной службы IIS.

    Предупреждение

    Если IIS был переустановлен, необходимо вновь выполнить следующие команды.

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

    Предупреждение

    при выполнении команды aspnet_regiis –i –enable пул приложений по умолчанию будет выполняться с помощью платформа .NET Framework 4, что может привести к проблемам несовместимости других приложений на том же компьютере.

  5. Следуйте инструкциям брандмауэра , чтобы включить порты, используемые образцами.

  6. Запустите пакетный файлSetupvroot.bat. Выполняются следующие шаги.

    • В службах IIS создается виртуальный каталог с именем ServiceModelSamples.

    • Создаются новые каталоги диска с именами «%SystemDrive%\Inetpub\wwwroot\ServiceModelSamples» и «%SystemDrive%\Inetpub\wwwroot\ServiceModelSamples\bin».

    Если вы предпочитаете настроить эти каталоги вручную, см. инструкции по настройке виртуального каталога. Чтобы отменить все изменения, выполненные на этом шаге, запустите cleanupvroot.bat после завершения работы с примерами.

    Примечание

    Эту процедуру необходимо выполнить на компьютере только один раз, если не запустить cleanupvroot.bat.

  7. Предоставьте разрешение на изменение папки «%SystemDrive%\inetpub\wwwroot» для учетной записи, от имени которой выполняется построение образцов, и для пользователя сетевой службы. При построении некоторых образцов, размещенных на веб-сервере, может быть выполнена попытка копирования компилированных двоичных файлов в указанное ранее расположение, и если соответствующие разрешения не заданы, построение прервется. кроме того, можно оставить разрешения по мере их возникновения и запустить командную строку пакета SDK или Visual Studio командной строки (2012) от имени администратора или создать образцы в Visual Studio 2012, а также запустить от имени администратора.

    Примечание

    Если этот шаг не выполнен, построение всех образцов, размещенных в службах IIS, завершится с ошибкой. убедитесь, что разрешения заданы правильно, или запустите командную строку пакета SDK и Visual Studio командной строки от имени администратора.

  8. Создайте на компьютере каталог "C:\Logs", так как он может ожидать некоторые примеры. Убедитесь, что соответствующая учетная запись имеет разрешение на запись в этот каталог. для Windows 7, Windows Vista и Windows Server 2008 R2 это учетная запись Network Service. для Windows Server 2008 учетная запись NT Authority\Network service. для Windows XP и Windows Server 2003 учетная запись — ASPNET.

  9. Запустите файлSetupcerttool.bat. Этот скрипт выполняет следующие задачи:

    • Создает средство FindPrivateKey.

    • Создает каталог с именем%Програмфилес%\сервицемоделсамплетулс.

    • Копирует новое средство FindPrivateKey в этот каталог.

    Данное средство необходимо для образцов, в которых используются сертификаты и которые размещены в службах IIS.

    Примечание

    В целях безопасности не забудьте удалить определение виртуального каталога и разрешения, предоставленные в описанных выше шагах установки, запустив пакетный файл с именем cleanupvroot.bat после завершения работы с примерами.

  10. Резидентным образцам (не размещенным в службах IIS) требуется разрешение на регистрацию HTTP-адресов на компьютере для прослушивания. Разрешение на резервирование пространства имен HTTP поступает от учетной записи пользователя, используемой для выполнения образца. По умолчанию учетные записи администратора имеют разрешение на регистрацию любых HTTP-адресов. Неадминистративным учетным записям должно быть предоставлено разрешение на использование пространства имен HTTP, применяемых в образцах кода. Дополнительные сведения о настройке резервирования пространств имен см. в разделе Настройка протоколов HTTP и HTTPS.

  11. Для некоторых примеров требуется очередь сообщений. Инструкции по установке см. в разделе Установка очереди сообщений (MSMQ) .

    Примечание

    Перед запуском всех образцов, использующих очереди сообщений, необходимо убедиться, что запущена служба очередей сообщений.

  12. Для некоторых образцов требуются сертификаты. см. инструкции по установке сертификата сервера службы IIS (IIS).