Средство редактирования конфигурации (SvcConfigEditor.exe)
Редактор конфигурации служб Windows Communication Foundation (WCF) (SvcConfigEditor.exe) позволяет администраторам и разработчикам создавать и изменять параметры конфигурации служб WCF при помощи графического пользовательского интерфейса. С помощью этого средства можно управлять параметрами привязок WCF, поведений, служб и диагностики без необходимости непосредственного изменения XML-файлов конфигурации.
Редактор конфигураций служб находится в папке C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin.
Редактор конфигураций WCF
Редактор конфигурации служб поставляется с мастером, который используется для настройки служб и клиентов WCF. Настоятельно рекомендуется использовать этот мастер, а не сам редактор.
Если уже имеются файлы конфигурации, которые соответствуют стандартной схеме системной конфигурации, то с помощью пользовательского интерфейса можно управлять специальными параметрами привязок, поведения, служб и диагностики. Редактор конфигурации служб позволяет управлять параметрами существующих файлов конфигурации WCF, а также исполняемых файлов, служб COM+ и служб, размещенных на веб-сервере. Когда служба, размещаемая на веб-сервере, открывается в редакторе конфигурации служб, то отображается и собственная конфигурация служб, и разделы конфигурации, унаследованные от узлов верхнего уровня.
Поскольку параметры конфигурации WCF находятся в разделе <system.serviceModel> файла конфигурации, редактор работает исключительно с содержимым этого элемента и не осуществляет доступ к другим элементам в данном файле. Можно напрямую перейти к существующим файлам конфигурации или выбрать сборку, содержащую службу, виртуальный каталог или службу COM+. Редактор загружает файл конфигурации для конкретной службы и позволяет пользователю добавить новые или изменить существующие элементы, расположенные в разделе <system.serviceModel> файла конфигурации.
Редактор поддерживает технологию IntelliSense и обеспечивает соответствие схеме. Редактор гарантирует, что результирующие выходные данные будут соответствовать схеме файла конфигурации и иметь синтаксически правильные значения. Однако редактор не гарантирует, что файл конфигурации будет допустимым с точки зрения семантики. Другими словами, редактор не гарантирует, что файл конфигурации будет работать со службой, которая в нем настраивается.
Внимание
После изменения элемента конфигурации редактор не позволяет удалить его из файла конфигурации. Например, при использовании редактора для задания и сохранения непустого строкового имени конечной точки файл конфигурации будет включать содержимое, показанное в следующем примере.
<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+ и открывать файлы конфигурации для служб, размещенных на веб-сервере.
Пользовательский интерфейс редактора конфигураций служб разделен на следующие области.
Область дерева, в которой элементы конфигурации отображаются в виде древовидной структуры слева. Операции в дереве можно выполнять, щелкая узлы правой кнопкой мыши.
Область задач, где в левой нижней части окна показаны распространенные задачи для текущих элементов
Область сведений, где подробно отображаются параметры узла конфигурации, выбранного в области дерева справа.
Открытие файла конфигурации
Запустите редактор конфигурации службы с помощью командного окна, чтобы перейти к расположению установки WCF, а затем введите
SvcConfigEditor.exe.В меню "Файл" выберите "Открыть" и выберите тип файла, которым требуется управлять.
В диалоговом окне "Открыть" перейдите к конкретному файлу, которому нужно управлять, и дважды щелкните его.
Средство просмотра автоматически следует пути слияния конфигураций и создает представление объединенной конфигурации. Например, действующая конфигурация неразмещенной службы представляет собой сочетание файлов Machine.config и App.config. Любые изменения, вносимые в редакторе SvcConfigEditor, применяются к активному файлу. Чтобы изменить конкретный файл в пути слияния конфигураций, его необходимо открыть напрямую.
Примечание.
Редактор конфигураций повторно загружает открытый в данный момент файл конфигурации при его изменении вне редактора. Когда это происходит, теряются все изменения, которые не были сохранены в редакторе. Наиболее вероятной причиной постоянной повторной загрузки является постоянный доступ к файлу конфигурации со стороны некоторой службы, например антивирусной программы, работающей в фоновом режиме. Для решения этой проблемы обеспечьте, чтобы редактор конфигураций был единственным процессом, который может осуществлять доступ к файлу, когда он открыт.
Службы
Узел служб отображает все службы, назначенные в файле конфигурации. Каждый вложенный узел в дереве соответствует подэлеку элемента <services> в файле конфигурации.
Щелкнув узел "Службы" , вы можете просматривать или выполнять задачи на странице сводки службы в области сведений .
Создание конфигурации службы
Новую конфигурацию службы можно создать одним из следующих способов.
С помощью мастера щелкните ссылку "Создать службу"... на панели задач или на странице сводки, чтобы запустить мастер. Это также можно сделать в меню "Файл " ->Добавить новый элемент.
Создайте вручную: узел служб можно щелкнуть правой кнопкой мыши и выбрать новую службу.
Создание новой конфигурации конечной точки службы
Новую конфигурацию конечной точки службы можно создать одним из следующих способов.
Создайте с помощью мастера: щелкните ссылку Создать конечную точку службы... на панели задач или на странице сводки, чтобы запустить мастер. Это также можно сделать в меню "Файл " ->Добавить новый элемент.
Создайте вручную: после создания службы щелкните правой кнопкой мыши узел конечных точек и выберите "Новая конечная точка службы".
Изменение конфигурации службы
Щелкните узел службы.
Измените параметры в сетках свойств.
Изменение конфигурации конечной точки службы
Щелкните узел конечной точки службы.
Измените параметры в сетках свойств.
Добавление базового адреса
Щелкните узел узла.
Нажмите кнопку "Создать..." в разделе "Базовые адреса".
Введите URI базового адреса в диалоговом окне.
Щелкните OK.
Примечание.
Нельзя изменить значение <baseAddressPrefixFilters> внутри этого средства. Чтобы добавить или изменить данный элемент, используйте текстовый редактор или среду Visual Studio.
Клиент
Узел клиента отображает все конечные точки клиента в файле конфигурации. Каждый вложенный узел в дереве соответствует подэлеку элемента <client> в файле конфигурации.
Щелкнув узел клиента, вы можете просматривать или выполнять задачи на странице сводки клиента в области сведений.
Создание конфигурации конечной точки клиента
Новую конфигурацию конечной точки клиента можно создать одним из следующих способов.
Создание по мастеру: щелкните ссылку "Создать новый клиент"... в области задач в нижней левой части окна или на странице сводки, чтобы запустить мастер. Это также можно сделать в меню "Файл " ->Добавить новый элемент. Мастер предложит указать расположение конфигурации службы, из которой создается конфигурация клиента. Затем можно выбрать конечную точку службы для подключения.
Создайте вручную: щелкните правой кнопкой мыши узел конечных точек в разделе "Клиент" и выберите новую конечную точку клиента.
Изменение конфигурации конечной точки клиента
Щелкните узел конечной точки клиента.
Измените параметры в сетках свойств.
Стандартная конечная точка
Стандартные конечные точки - это специальные точки, в которых один или несколько аспектов адреса, контракта и привязки установлены в значения по умолчанию.
Такие параметры конфигурации хранятся в узле стандартной конечной точки . Узел стандартной конечной точки отображает все стандартные параметры конечной точки в файле конфигурации. Каждый вложенный узел в дереве соответствует подэлеку в элементе <standardEndpoints> в файле конфигурации.
Щелкнув узел "Стандартная конечная точка", вы можете просмотреть или выполнить задачи на стандартной странице сводки конечной точки в области сведений.
Создание новой конфигурации стандартной конечной точки
Новую конфигурацию стандартной конечной точки можно создать одним из следующих способов.
Щелкните правой кнопкой мыши узел "Стандартная конечная точка" и выберите "Новая конфигурация стандартной конечной точки" ... Выберите тип привязки в диалоговом окне и нажмите кнопку "ОК".
Выберите узел "Стандартная конечная точка" и щелкните "Новая конфигурация стандартной конечной точки" в области задач слева от окна.
В диалоговом окне "Создание стандартной конечной точки " отображаются все зарегистрированные стандартные типы конечных точек.
Просмотр и изменение конфигурации стандартной конечной точки
Конфигурацию стандартной конечной точки можно открыть для просмотра и изменения следующими способами.
Щелкните, чтобы развернуть узел стандартной конечной точки и щелкните соответствующий подузл конечной точки.
Щелкните узел стандартной конечной точки и щелкните соответствующую конечную точку на панели сведений.
Атрибуты конечной точки будут доступны для изменения в правой области окна.
Удаление конфигурации стандартной конечной точки
Конфигурацию стандартной конечной точки можно удалить одним из следующих способов.
Щелкните узел стандартной конечной точки и щелкните правой кнопкой мыши соответствующий подузл конечной точки. Чтобы удалить конечную точку, используйте команду контекста Delete Standard Endpoint Configuration .
Щелкните узел стандартной конечной точки . В области задач щелкните "Удалить стандартную конфигурацию конечной точки".
Если используется стандартная конечная точка, при попытке удалить ее отображается предупреждение: стандартная конечная точка используется. Если удалить ее сейчас, обязательно удалите все ссылки в других частях конфигурации (например, в конечной точке службы или конечной точке клиента). В противном случае конфигурация будет недопустимой и не может быть открыта в следующий раз. Вы действительно хотите удалить стандартную конечную точку?"
Привязка
Конфигурации привязок используются для настройки привязок на конечных точках. Такие параметры конфигурации хранятся в узле привязки . Конечные точки обращаются к конфигурации привязки по имени, причем к одной конфигурации привязки может обращаться несколько конечных точек.
Узел "Привязки" отображает все параметры привязки в файле конфигурации. Каждый вложенный узел в дереве соответствует подэлеку в элементе <bindings> в файле конфигурации.
Щелкнув узел "Привязки", вы можете просмотреть или выполнить задачи на странице сводки привязки в области сведений.
Создание конфигурации привязки
Новую конфигурацию привязки можно создать одним из следующих способов.
Щелкните правой кнопкой мыши узел "Привязки" и выберите "Создать конфигурацию привязки" ... Выберите тип привязки в диалоговом окне и нажмите кнопку "ОК".
Выберите узел "Привязки" и нажмите кнопку "Создать конфигурацию привязки" ... в области задач слева от окна.
На странице сводки службы или клиента нажмите кнопку "Создать " в поле "Конфигурация привязки", чтобы создать конфигурацию привязки для соответствующей конечной точки.
Добавление расширений элементов привязки в пользовательскую привязку
Выберите привязку, в которую требуется добавить элемент расширения.
Нажмите кнопку Добавить.
В списке доступных расширений выберите расширение элемента привязки, которое требуется добавить. Чтобы выбрать несколько элементов, удерживайте нажатой клавишу CTRL.
Нажмите кнопку Добавить.
Настройка положения расширения в пользовательской привязке
Пользовательская привязка - это коллекция элементов привязки, образующих стек. Каждый элемент привязки в стеке имеет собственные параметры конфигурации. Порядок расширений элементов привязки в пользовательской привязке определяет их положение в стеке. Верхние элементы стека применяются в первую очередь. Чтобы изменить порядок, выполните следующие действия.
Выберите узел пользовательской привязки.
Выберите один элемент расширения привязки в разделе "Позиция расширения элемента привязки".
Нажмите кнопку "Вверх " или "Вниз " в левой части списка, чтобы изменить положение выбранного элемента.
Изменение конфигурации расширений элементов привязки в пользовательской привязке
Выберите узел привязки в дереве.
Выберите пользовательскую привязку, содержащую элемент, который требуется изменить.
Выберите расширение элемента привязки, которое необходимо изменить. Параметры элемента отображаются в области справа, где их можно изменить.
Диагностика
Узел диагностики отображает все параметры диагностики в файле конфигурации. Он позволяет включить или отключить счетчики производительности, включить или отключить инструментарий управления Windows (WMI), настроить трассировку WCF и настроить ведение журнала сообщений WCF. Параметры в узле диагностики соответствуют <>system.diagnosticsразделу и <diagnostics> разделу в <system.serviceModel> файле конфигурации.
Щелкнув узел диагностики, вы можете просмотреть или выполнить задачи на странице сводки диагностика в области сведений.
Настройка счетчиков производительности и инструментария WMI
Щелкните узел диагностики.
Щелкните Переключатель счетчиков производительности. Счетчик производительности может находиться в трех состояниях: Off (по умолчанию), ServiceOnly и All. Для переключения между этими тремя состояниями следует щелкнуть ссылку соответствующее число раз.
Настройка поставщика WMI
Щелкните узел диагностики.
Чтобы включить поставщик WMI, щелкните ссылку "Включить поставщик WMI".
Включение трассировки WCF
Можно создать файл трассировки WCF со стандартными параметрами или пользовательский файл трассировки.
Щелкните узел диагностики.
Нажмите кнопку "Включить трассировку".
Щелкните ссылку "Уровень трассировки", чтобы настроить уровень трассировки. Существует шесть уровней трассировки: Off, Critical, Error, Warning, Information и Verbose. Параметр трассировки действий и распространения действий позволяет использовать функцию трассировки действий WCF.
Выберите имя прослушивателя трассировки, чтобы задать файл трассировки и параметры.
Включение ведения журнала WCF
Можно создать файл трассировки WCF со стандартными параметрами или пользовательский файл трассировки.
Щелкните узел диагностики.
Нажмите кнопку "Включить ведение журнала сообщений".
Щелкните ссылку "Уровень журнала", чтобы настроить уровень журнала. Существует три уровня ведения журнала: Повреждения, Службы и Транспорт.
Выберите имя прослушивателя, чтобы задать файл журнала и параметры.
Примечание.
Если вы хотите, чтобы журналы трассировки и сообщений автоматически сбрасывались при закрытии приложения, включите параметр автозапуска .
Страница сводки диагностики позволяет выполнять наиболее распространенные задачи при настройке диагностика. Однако если вы хотите вручную изменить параметры прослушивателей и источников, необходимо развернуть узел диагностики и изменить параметры в узле "Ведение сообщений", "Прослушиватели" и "Источники".
Включение пользовательской трассировки или ведения журналов сообщений WCF
Щелкните узел диагностики и разверните его.
Щелкните правой кнопкой мыши узел прослушивателей и выберите новый прослушиватель.
Введите имя файла трассировки в поле InitData . Вы можете щелкнуть "..." кнопка для перехода к пути.
При щелчке строки TypeName отображается "..." пуговица. Нажмите эту кнопку, чтобы открыть браузер типов прослушивателя трассировки, который можно использовать для поиска предварительно настроенных прослушивателей трассировки, которые уже установлены.
Обратите внимание на раздел "Источник ". Нажмите кнопку "Добавить " в этом разделе, чтобы открыть диалоговое окно с раскрывающимся меню, в котором перечислены доступные источники трассировки. Выберите источник трассировки и нажмите кнопку "ОК".
Чтобы изменить параметры ведения журнала сообщений, щелкните узел ведения журнала сообщений. Параметры можно изменять в сетке свойств.
Расширенные
Поведение
Узел "Поведение" отображает поведение, которое в настоящее время определено в файле конфигурации.
Конфигурации поведения используются для настройки поведений конечных точек и служб. Такие параметры конфигурации хранятся на узле Advanced в разделе "Поведение службы" и "Поведение конечной точки". Поведения служб используются службами, а поведения конечных точек - конечными точками.
Поведения - это коллекции элементов расширения, образующих стек. Верхний элемент стека применяется в первую очередь. Каждый элемент расширения может иметь собственную конфигурацию.
Создание новой конфигурации поведения
Новую конфигурацию поведения можно создать одним из двух способов.
Щелкните правой кнопкой мыши один из узлов поведения и выберите "Создать конфигурацию поведения...
Выберите один из узлов поведения и щелкните новую конфигурацию поведения... в области задач слева от окна.
Добавление расширений элементов поведения в поведение
Выберите один из узлов поведения.
Выберите поведение, которое требуется изменить.
Нажмите кнопку Добавить.
В списке доступных расширений выберите расширение элемента поведения, которое требуется добавить.
Нажмите кнопку Добавить.
Настройка положения расширения в поведении
Поведения — это коллекции элементов, образующих стек. Каждый элемент в стеке имеет собственную конфигурацию. Порядок расширений элементов поведения в поведении определяет их положение в стеке. Верхние элементы стека применяются в первую очередь. Чтобы изменить порядок, выполните следующие действия.
Выберите один из узлов поведения.
Выберите поведение, которое требуется изменить.
Выберите элемент расширения поведения в разделе "Позиция расширения элемента поведения".
Нажмите кнопку "Вверх " или "Вниз " в левой части списка, чтобы изменить положение выбранного элемента.
Изменение конфигурации расширений элементов поведения
Выберите один из узлов поведения в дереве.
Выберите поведение, содержащее элемент, который необходимо изменить.
Выберите расширение элемента поведения, которое необходимо изменить. Параметры элемента отображаются в области справа, где их можно изменить.
ProtocolMapping
В этом разделе можно задавать типы привязки по умолчанию для различных протоколов, таких как HTTP, TCP, MSMQ или net.pipe, посредством определенного сопоставления между адресными схемами протоколов и возможными привязками. Также можно добавлять новые сопоставления для других протоколов.
Расширения
Новые расширения привязки, расширения элементов привязки, стандартные расширения конечных точек и расширения поведения можно зарегистрировать для использования в конфигурации WCF. Расширения представляют собой пары "имя/тип". Имя определяет имя расширения в конфигурации, а тип реализует расширение. Существует четыре типа расширений.
Расширения привязки определяют общий тип привязки. Пример:
basicHttpBinding.Расширения элементов привязки определяют элемент привязки. Пример:
textMessageEncoding.Расширения стандартных конечных точек определяют целую стандартную конечную точку. Пример:
discoveryEndpoint.Расширения элементов поведения определяют элемент поведения. Пример:
clientVia.
Расширения, зарегистрированные в конфигурации, могут быть использованы как любой другой компонент WCF такого же типа.
Добавление нового расширения
Выберите один из узлов расширения среди дополнительных узлов.
Нажмите кнопку Создать.
Введите имя и тип.
Щелкните OK.
Теперь расширение отображается в соответствующем месте редактора. Например, если добавить расширение элемента поведения, оно появится в списке доступных расширений.
Среда размещения
В этом разделе можно определять параметры создания экземпляров для среды, где размещается служба.
Создание файла конфигурации с помощью мастера
Один из способов создания нового файла конфигурации — использование мастера создания элементов службы. Мастер находит установленные типы служб и другие элементы, совместимые с WCF на компьютере, включая COM+ и размещенные в Интернете виртуальные каталоги, и загружает их, чтобы упростить создание конфигурации.
Создание файла конфигурации
Запустите редактор конфигурации службы с помощью командного окна, чтобы перейти к расположению установки WCF, а затем введите
SvcConfigEditor.exe.В меню "Файл" выберите "Открыть" и щелкните "Исполняемый файл", "Com+ Service" или "WebHosted Service" (В зависимости от типа файла конфигурации, который требуется создать).
В диалоговом окне "Открыть" перейдите к конкретному файлу, для которого нужно создать файл конфигурации и дважды щелкните его.
В меню "Файл" наведите указатель мыши на добавление нового элемента и щелкните "Служба". Откроется мастер создания элементов службы.
Для создания новой службы следуйте инструкциям мастера.
Примечание.
Чтобы использовать привязку NetPeerTcpBinding из файла конфигурации, созданного мастером, необходимо вручную добавить элемент конфигурации привязки и изменить значение атрибута mode элемента security на «Нет».
Настройка COM+
Редактор конфигураций служб позволяет создавать новые файлы конфигурации для существующих приложений COM+, а также изменять имеющиеся конфигурации COM+. Узел контракта COM отображается только в том случае, если <comContract> раздел существует в файле конфигурации.
Создание новой конфигурации COM+
Перед созданием конфигурации COM+ следует убедиться, что приложение COM+ установлено в службах компонентов и зарегистрировано в глобальном кэше сборок.
Выберите меню "Файл " ->Интеграция с приложением ->COM+. Эта операция закрывает текущий открытый файл. Если в текущем файле есть несохраненные данные, то появится диалоговое окно сохранения. Затем запускается мастер интеграции COM+ .
В дереве на первой странице выберите приложение COM+. Если приложение COM+ не удается найти в дереве, проверьте, установлено ли оно в службах компонентов и зарегистрировано ли в глобальном кэше сборок.
На следующей странице выберите метод(ы), которые будут отображаться как службы WCF. Все поддерживаемые в приложении COM+ методы отображаются и выбираются по умолчанию.
Выберите метод размещения.
Настройте остальные параметры в соответствии с указаниями мастера.
Редактор конфигураций служб использует средство ComSvcConfig.exe, запущенное в фоновом режиме, для создания файла конфигурации. После выполнения этих действий можно просмотреть отчет и выйти из мастера. Созданный файл конфигурации открывается для непосредственного редактирования.
Изменение существующей конфигурации COM+
Выберите меню "Файл " ->Open ->COM+ Service...
Выберите в списке службу COM+, которую требуется изменить.
Изменение параметров конфигурации в узле COM Contracts .
Примечание.
Также можно напрямую открыть и отредактировать файл конфигурации, в котором содержатся COM-контракты.
Безопасность
Редактор конфигураций, с помощью которого создаются файлы конфигурации служб, не гарантирует безопасность. Ознакомьтесь с документацией по безопасности , чтобы узнать, как защитить службы WCF.
Кроме того, редактор конфигурации может использоваться только для чтения и записи допустимых элементов конфигурации WCF. Он пропускает пользовательские элементы, совместимые со схемой. Более того, этот редактор не предпринимает попыток удаления таких элементов из файла конфигурации или определения их воздействия на известные элементы WCF. Пользователю необходимо самостоятельно определять, представляют ли эти элементы угрозу для приложения или системы.