Поделиться через

Средство редактирования конфигурации (SvcConfigEditor.exe)

  • Статья

Редактор конфигураций служб Windows Communication Foundation (WCF) (SvcConfigEditor.exe) позволяет администраторам и разработчикам создавать и изменять параметры конфигурации служб WCF с помощью графического пользовательского интерфейса. С помощью этого средства можно управлять параметрами привязок, поведений, служб и диагностики WCF без необходимости непосредственного изменения XML-файлов конфигурации.

Редактор конфигураций служб находится в папке C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin.

Редактор конфигураций WCF

Редактор конфигураций служб поставляется с мастером, который используется для настройки служб и клиентов WCF. Настоятельно рекомендуется использовать этот мастер, а не сам редактор.

Если уже имеются файлы конфигурации, которые соответствуют стандартной схеме System.Configuration, с помощью пользовательского интерфейса можно управлять специальными параметрами привязок, поведений, служб и диагностики. Редактор конфигураций служб позволяет управлять параметрами существующих файлов конфигурации WCF, а также исполняемых файлов, служб COM+ и служб, размещенных на веб-сервере. Когда служба, размещаемая на веб-сервере, открывается в редакторе конфигурации служб, то отображается и собственная конфигурация служб, и разделы конфигурации, унаследованные от узлов верхнего уровня.

Поскольку параметры конфигурации WCF находятся в разделе <system.serviceModel> файла конфигурации, редактор работает исключительно с содержимым этого элемента и не осуществляет доступ к другим элементам в данном файле. Можно напрямую перейти к существующим файлам конфигурации или выбрать сборку, содержащую службу, виртуальный каталог или службу COM+. Редактор загружает файл конфигурации для конкретной службы и позволяет пользователю добавить новые или изменить существующие элементы, расположенные в разделе <system.serviceModel> файла конфигурации.

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

ms732009.Caution(ru-ru,VS.100).gifВнимание!
После изменения элемента конфигурации редактор не позволяет удалить его из файла конфигурации. Например, при использовании редактора для задания и сохранения непустого строкового имени конечной точки файл конфигурации будет включать содержимое, показанное в следующем примере.

<endpoint binding="basicHttpBinding" name="somename" />

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

<endpoint binding="basicHttpBinding" name="" />

Чтобы удалить атрибут, необходимо вручную изменить элемент с помощью другого текстового редактора.

Это особенно следует учитывать при использовании элемента issueToken поведения clientCredential конечной точки. В частности, атрибут address вложенного элемента localIssuer не должен быть пустой строкой. Чтобы удалить атрибут address, измененный с помощью редактора конфигураций, необходимо использовать средство, отличное от этого редактора. В противном случае атрибут будет содержать пустую строку и в приложении возникнет исключение.

Использование редактора конфигураций

Редактор конфигураций служб находится в папке установки Windows SDK:

C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin\SvcConfigEditor.exe

После запуска редактора конфигураций служб можно воспользоваться командой Файл/Открыть, чтобы выбрать службу или сборку, с которой требуется работать. Можно непосредственно открывать файлы конфигурации, выбирать службы WCF/COM+ и открывать файлы конфигурации для служб, размещенных на веб-сервере.

Пользовательский интерфейс редактора конфигураций служб разделен на следующие области.

  • Область дерева, в которой элементы конфигурации отображаются в виде древовидной структуры слева. Операции в дереве можно выполнять, щелкая узлы правой кнопкой мыши.

  • Область задач, где в левой нижней части окна показаны распространенные задачи для текущих элементов

  • Область сведений, где подробно отображаются параметры узла конфигурации, выбранного в области дерева справа.

Открытие файла конфигурации

  1. Запустите редактор конфигураций служб: используя командное окно, перейдите в папку установки WCF и введите команду SvcConfigEditor.exe.

  2. В меню Файл выберите Открыть и щелкните тип файла, с которым требуется работать.

  3. В диалоговом окне Открытие файла перейдите к нужному файлу и дважды щелкните его.

Средство просмотра автоматически следует пути слияния конфигураций и создает представление объединенной конфигурации. Например, фактической конфигурацией внепроцессной службы является сочетание файлов Machine.config и App.config. Все изменения применяются к активному файлу в SvcConfigEditor. Чтобы изменить конкретный файл в пути слияния конфигураций, его необходимо открыть напрямую.

ms732009.note(ru-ru,VS.100).gifПримечание
Редактор конфигураций повторно загружает открытый в данный момент файл конфигурации при его изменении вне редактора. Когда это происходит, теряются все изменения, которые не были сохранены в редакторе. Наиболее вероятной причиной постоянной повторной загрузки является постоянный доступ к файлу конфигурации со стороны некоторой службы, например антивирусной программы, работающей в фоновом режиме. Для решения этой проблемы обеспечьте, чтобы редактор конфигураций был единственным процессом, который может осуществлять доступ к файлу, когда он открыт.

Службы

В узле Службы отображаются все службы, назначенные в файле конфигурации. Каждый подузел в дереве соответствует подэлементу элемента <services> в файле конфигурации.

При выборе узла Службы можно просматривать или выполнять задачи на странице сводных сведений службы в Области сведений.

Создание конфигурации службы

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

  • Создание с помощью мастера: щелкните ссылку Создать новую службу в области задач или на странице сводных данных, чтобы запустить мастер. Это же действие можно выполнить в меню Файл -> с помощью команды Добавить новый элемент.

  • Создание вручную: щелкните правой кнопкой мыши узел Службы и выберите Создать службу.

Создание новой конфигурации конечной точки службы

Новую конфигурацию конечной точки службы можно создать одним из следующих способов.

  • Создание с помощью мастера: щелкните ссылку Создать конечную точку службы в области задач или на странице сводных данных, чтобы запустить мастер. Это же действие можно выполнить в меню Файл -> с помощью команды Добавить новый элемент.

  • Создание вручную: после создания службы можно щелкнуть правой кнопкой мыши узел Конечные точки и выбрать Создать конечную точку службы.

Изменение конфигурации службы

  1. Щелкните узел Служба.

  2. Измените параметры в сетках свойств.

Изменение конфигурации конечной точки службы

  1. Щелкните узел Конечная точка службы.

  2. Измените параметры в сетках свойств.

Добавление базового адреса

  1. Щелкните узел Узел.

  2. Нажмите кнопку Создать в разделе Базовые адреса.

  3. Введите URI базового адреса в диалоговом окне.

  4. Нажмите кнопку ОК.

ms732009.note(ru-ru,VS.100).gifПримечание
В этом средстве нельзя изменять значение <baseAddressPrefixFilters>. Чтобы добавить или изменить данный элемент, используйте текстовый редактор или Visual Studio.

Клиент

В узле Клиент отображаются все конечные точки клиента в файле конфигурации. Каждый вложенный узел в дереве соответствует вложенному элементу элемента <client> в файле конфигурации.

При выборе узла Клиент можно просматривать или выполнять задачи на Странице сводных сведений клиента в Области сведений.

Создание конфигурации конечной точки клиента

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

  • Создание с помощью мастера: щелкните ссылку Создать клиент в левой нижней части окна Область задач или на странице Сводные данные, чтобы запустить мастер. Это же действие можно выполнить с помощью команды Добавить новый элемент из меню> Файл. Мастер предложит указать расположение конфигурации службы, из которой создается конфигурация клиента. Затем можно выбрать конечную точку службы для подключения.

  • Создание вручную: щелкните правой кнопкой мыши узел Конечные точки в узле Клиент и выберите команду Создать конечную точку клиента.

Изменение конфигурации конечной точки клиента

  1. Щелкните узел Конечная точка клиента.

  2. Измените параметры в таблицах свойств.

Стандартная конечная точка

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

Такие параметры конфигурации хранятся в узле Стандартная конечная точка. В узле Стандартная конечная точка выводятся все параметры стандартной конечной точки в файле конфигурации. Каждый вложенный узел в дереве соответствует вложенному элементу элемента <standardEndpoints> в файле конфигурации.

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

Создание новой конфигурации стандартной конечной точки

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

  • Щелкните правой кнопкой мыши узел Стандартная конечная точка и выберите команду Создать конфигурацию стандартной конечной точки, а затем выберите тип привязки в диалоговом окне и нажмите кнопку ОК.

  • Выберите узел Стандартная конечная точка и щелкните ссылку Создать конфигурацию стандартной конечной точки в области задач в левой нижней части окна.

Открывается диалоговое окно Создание новой стандартной конечной точки, в котором перечислены все зарегистрированные типы стандартных конечных точек.

Просмотр и изменение конфигурации стандартной конечной точки

Конфигурацию стандартной конечной точки можно открыть для просмотра и изменения следующими способами.

  • Разверните узел Стандартная конечная точка и щелкните вложенный узел, соответствующий конечной точке.

  • Щелкните узел Стандартная конечная точка и щелкните соответствующую конечную точку в области сведений.

Атрибуты конечной точки будут доступны для изменения в правой области окна.

Удаление конфигурации стандартной конечной точки

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

  • Разверните узел Стандартная конечная точка и щелкните правой кнопкой мыши вложенный узел, соответствующий конечной точке. В контекстном меню выберите команду Удалить конфигурацию стандартной конечной точки, чтобы удалить конечную точку.

  • Щелкните узел Стандартная конечная точка. В области задач щелкните ссылку Удалить конфигурацию стандартной конечной точки.

Если стандартная конечная точка в данный момент используется, то при попытке ее удалить появится предупреждение: «Стандартная конечная точка находится в использовании. Если сейчас ее удалить, также необходимо удалить все ссылки на нее в других частях конфигурации (например, в конечной точке службы или клиентской конечной точке). В противном случае конфигурация станет недопустимой, и в следующий раз ее будет невозможно открыть. Удалить стандартную конечную точку?»

Привязка

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

В узле Привязки отображаются все параметры привязок, заданные в файле конфигурации. Каждый вложенный узел в дереве соответствует вложенному элементу элемента <bindings> в файле конфигурации.

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

Создание конфигурации привязки

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

  • Щелкните правой кнопкой мыши узел Привязки и выберите Создать конфигурацию привязки…, затем выберите тип привязки в диалоговом окне и нажмите кнопку ОК.

  • Выберите узел Привязки и щелкните ссылку Создать конфигурацию привязки в области задач в левой нижней части окна.

  • На странице сводных данных клиента или службы выберите значение Щелкните, чтобы создать в поле Конфигурация привязки, чтобы создать конфигурацию привязки для соответствующей конечной точки.

Добавление расширений элементов привязки в пользовательскую привязку

  1. Выберите привязку, в которую требуется добавить элемент расширения.

  2. Нажмите кнопку Добавить.

  3. В списке доступных расширений выберите расширение элемента привязки, которое требуется добавить. Чтобы выбрать несколько элементов, удерживайте нажатой клавишу CTRL.

  4. Нажмите кнопку Добавить.

Настройка положения расширения в пользовательской привязке

Пользовательская привязка — это коллекция элементов привязки, образующих стек. Каждый элемент привязки в стеке имеет собственные параметры конфигурации. Порядок расширений элементов привязки в пользовательской привязке определяет их положение в стеке. Верхние элементы стека применяются в первую очередь. Чтобы изменить порядок, выполните следующие действия.

  1. Выберите узел пользовательской привязки.

  2. Выберите один элемент расширения привязки в разделе Положение расширения элемента привязки.

  3. Используйте кнопки Вверх или Вниз, расположенные слева от списка, чтобы изменить положение выбранного элемента.

Изменение конфигурации расширений элементов привязки в пользовательской привязке

  1. Выберите узел привязки в дереве.

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

  3. Выберите расширение элемента привязки, которое необходимо изменить. Настройки элемента отобразятся в области справа, где их можно будет изменить.

Диагностика

В узле Диагностика отображаются все параметры диагностики, заданные в файле конфигурации. Этот узел позволяет включать и отключать счетчики производительности, включать и отключать инструментарий управления Windows (WMI), а также настраивать трассировки WCF и ведение журнала сообщений WCF. Параметры в узле Диагностика соответствуют заданным в разделах <system.diagnostics> и <diagnostics><system.serviceModel>, которые находятся в разделе файла конфигурации.

При выборе узла Диагностика можно просматривать или выполнять задачи на Странице сводных сведений диагностики в Области сведений.

Настройка счетчиков производительности и инструментария WMI

  1. Выберите узел Диагностика.

  2. Щелкните Переключение счетчиков производительности. Счетчик производительности может находиться в трех состояниях: Off (по умолчанию), ServiceOnly и All. Для переключения между этими тремя состояниями следует щелкнуть ссылку соответствующее число раз.

Настройка поставщика WMI

  1. Выберите узел Диагностика.

  2. Чтобы включить поставщик WMI, щелкните ссылку Включить поставщик WMI.

Включение трассировки WCF

Можно создать файл трассировки WCF со стандартными свойствами или пользовательский файл трассировки.

  1. Выберите узел Диагностика.

  2. Щелкните Включить трассировку.

  3. Щелкните ссылку Уровень трассировки, чтобы настроить уровень трассировки. Существует шесть уровней трассировки: Off, Critical, Error, Warning, Information и Verbose. Параметры Трассировка действий и Распространять действие позволяют использовать функцию трассировки действий WCF.

  4. Выберите имя прослушивателя трассировки, чтобы задать файл трассировки и параметры.

Включение ведения журнала WCF

Можно создать файл трассировки WCF со стандартными свойствами или пользовательский файл трассировки.

  1. Выберите узел Диагностика.

  2. Щелкните Включить ведение журнала сообщений.

  3. Щелкните ссылку Уровень ведения журнала, чтобы настроить уровень ведения журнала. Существует три уровня ведения журнала: Повреждения, Службы и Транспорт.

  4. Выберите имя прослушивателя, чтобы задать файл журнала и параметры.

ms732009.note(ru-ru,VS.100).gifПримечание
Чтобы журналы трассировки и сообщений автоматически очищались при закрытии приложения, включите параметр Автоматическая очистка.

Страница сводных сведений в узле Диагностика позволяет выполнять наиболее распространенные задачи, связанные с настройкой диагностики. Чтобы изменить параметры прослушивателей и источников вручную, необходимо развернуть узел Диагностика и настроить параметры в узлах Ведение журнала сообщений, Прослушиватели и Источники.

Включение пользовательской трассировки или ведения журналов сообщений WCF

  1. Щелкните узел Диагностика и разверните его.

  2. Щелкните правой кнопкой мыши узел Прослушиватели и выберите пункт Новый прослушиватель.

  3. Введите имя файла трассировки в поле Исходные данные. Чтобы указать путь, можно нажать кнопку «…».

  4. При щелчке поля Ввод имени отображается кнопка "…". Нажмите эту кнопку, чтобы открыть Обозреватель типов прослушивателя трассировки, с помощью которого можно найти предварительно настроенные прослушиватели трассировки, которые уже установлены.

  5. Обратите внимание на раздел Источник. Нажмите кнопку Добавить в этом разделе, чтобы открыть диалоговое окно с раскрывающимся меню, в котором перечислены доступные источники трассировки. Выберите источник трассировки и нажмите кнопку ОК.

  6. Чтобы изменить параметры ведения журнала сообщений, выберите узел Ведение журнала сообщений. Параметры можно изменять в сетке свойств.

Дополнительные параметры

Поведения

В узле Поведения отображаются поведения, заданные в файле конфигурации.

Конфигурации поведения используются для настройки поведений конечных точек и служб. Эти параметры конфигурации хранятся в узле Дополнительно под узлами Поведения служб и Поведения конечных точек. Поведения служб используются службами, а поведения конечных точек — конечными точками.

Поведения — это коллекции элементов расширения, образующих стек. Верхний элемент стека применяется в первую очередь. Каждый элемент расширения может иметь собственную конфигурацию.

Создание новой конфигурации поведения

Новую конфигурацию поведения можно создать одним из двух способов.

  • Щелкните правой кнопкой мыши один из узлов поведения и выберите Создать конфигурацию поведения….

  • Выберите один из узлов поведения и щелкните ссылку Создать конфигурацию поведения в области задач в левой нижней части окна.

Добавление расширений элементов поведения в поведение

  1. Выберите один из узлов поведения.

  2. Выберите поведение, которое требуется изменить.

  3. Нажмите кнопку Добавить.

  4. В списке доступных расширений выберите расширение элемента поведения, которое требуется добавить.

  5. Нажмите кнопку Добавить.

Настройка положения расширения в поведении

Поведения — это коллекции элементов, образующих стек. Каждый элемент в стеке имеет собственную конфигурацию. Порядок расширений элементов поведения в поведении определяет их положение в стеке. Верхние элементы стека применяются в первую очередь. Чтобы изменить порядок, выполните следующие действия.

  1. Выберите один из узлов поведения.

  2. Выберите поведение, которое требуется изменить.

  3. Выберите элемент расширения поведения в разделе Положение расширения элемента поведения.

  4. Используйте кнопки Вверх или Вниз, расположенные слева от списка, чтобы изменить положение выбранного элемента.

Изменение конфигурации расширений элементов поведения

  1. Выберите один из узлов поведения в дереве.

  2. Выберите поведение, содержащее элемент, который необходимо изменить.

  3. Выберите расширение элемента поведения, которое необходимо изменить. Настройки элемента отобразятся в области справа, где их можно изменить.

ProtocolMapping

В этом разделе можно задавать типы привязки по умолчанию для различных протоколов, таких как HTTP, TCP, MSMQ или net.pipe, посредством определенного сопоставления между адресными схемами протоколов и возможными привязками. Также можно добавлять новые сопоставления для других протоколов.

Расширения

Новые расширения привязки, расширения элементов привязки, расширения стандартных конечных точек и расширения поведения можно зарегистрировать для использования в конфигурации WCF. Расширения представляют собой пары «имя/тип». Имя определяет имя расширения в конфигурации, а тип реализует расширение. Существует четыре типа расширений.

  • Расширения привязки определяют общий тип привязки. Пример: basicHttpBinding.

  • Расширения элементов привязки определяют элемент привязки. Пример: textMessageEncoding.

  • Расширения стандартных конечных точек определяют целую стандартную конечную точку. Пример: discoveryEndpoint.

  • Расширения элементов поведения определяют элемент поведения. Пример: clientVia.

Расширения, зарегистрированные в конфигурации, могут быть использованы как любой другой компонент WCF такого же типа.

Добавление нового расширения

Выберите один из узлов расширения среди дополнительных узлов.

  1. Нажмите кнопку Создать.

  2. Введите имя и тип.

  3. Нажмите кнопку ОК.

  4. Теперь расширение отображается в соответствующем месте редактора. Например, если добавить расширение элемента поведения, то оно появится в списке доступных расширений.

Среда размещения

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

Создание файла конфигурации с помощью мастера

Один из способов создания нового файла конфигурации — использование мастера создания элементов службы. Мастер находит установленные на компьютере типы служб и другие элементы, совместимые с WCF, включая каталоги COM+ и виртуальные каталоги, размещенные на веб-сервере, и выполняет их загрузку, чтобы ускорить создание конфигурации.

Создание файла конфигурации

  1. Запустите редактор конфигураций служб: используя командное окно, перейдите в папку установки WCF и введите команду SvcConfigEditor.exe.

  2. В меню Файл выберите Открыть и щелкните Исполняемый файл, Служба COM+ или Служба, размещенная в Интернете в зависимости от типа файла конфигурации, который требуется создать.

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

  4. В меню Файл выберите команду Добавить новый элемент и щелкните Служба. Откроется мастер создания элементов службы.

  5. Для создания новой службы следуйте инструкциям мастера.

ms732009.note(ru-ru,VS.100).gifПримечание
Чтобы использовать привязку NetPeerTcpBinding из файла конфигурации, созданного мастером, необходимо вручную добавить элемент конфигурации привязки и изменить значение атрибута mode элемента security на «Нет».

Настройка COM+

Редактор конфигураций служб позволяет создавать новые файлы конфигурации для существующих приложений COM+, а также изменять имеющиеся конфигурации COM+. Узел COM-контракт отображается, только если в файле конфигурации существует раздел <comContract>.

Создание новой конфигурации COM+

Перед созданием конфигурации COM+ следует убедиться, что приложение COM+ установлено в службах компонентов и зарегистрировано в глобальном кэше сборок.

  1. Выберите в меню Файл -> команду Интегрировать -> Приложение COM+. В результате этого действия открытый в данный момент файл закрывается. Если в текущем файле есть несохраненные данные, то появится диалоговое окно сохранения. После этого запускается Мастер интеграции COM+.

  2. В дереве на первой странице выберите приложение COM+. Если приложение COM+ не удается найти в дереве, проверьте, установлено ли оно в службах компонентов и зарегистрировано ли в глобальном кэше сборок.

  3. На следующей странице выберите методы, которые будут предоставлены как службы WCF. Все поддерживаемые в приложении COM+ методы отображаются и выбираются по умолчанию.

  4. Выберите метод размещения.

  5. Настройте остальные параметры в соответствии с указаниями мастера.

  6. Редактор конфигураций служб использует средство ComSvcConfig.exe, запущенное в фоновом режиме, для создания файла конфигурации. После выполнения этих действий можно просмотреть отчет и выйти из мастера. Созданный файл конфигурации открывается для непосредственного изменения.

Изменение существующей конфигурации COM+

  1. Выберите в меню Файл -> команду Открыть -> Служба COM+.

  2. Выберите в списке службу COM+, которую требуется изменить.

  3. Измените параметры конфигурации в узле COM-контракты.

    ms732009.note(ru-ru,VS.100).gifПримечание
    Также можно напрямую открыть и отредактировать файл конфигурации, в котором содержатся COM-контракты.

Безопасность

Редактор конфигураций, с помощью которого создаются файлы конфигурации служб, не гарантирует безопасность. Сведения об обеспечении безопасности служб WCF см. в документации Безопасность Windows Communication Foundation.

Кроме того, редактор конфигураций может использоваться только для чтения и записи допустимых элементов конфигурации WCF. Он пропускает пользовательские элементы, совместимые со схемой. Более того, этот редактор не предпринимает попыток удаления этих элементов из файла конфигурации или определения их воздействия на известные элементы WCF. Пользователю необходимо самостоятельно определять, представляют ли эти элементы угрозу для приложения или системы.