Практическое руководство. Установка и удаление служб Windows
Эта документация не относится к последней версии службы Windows. Последние сведения об использовании BackgroundService служб Windows и шаблоне рабочей службы см. в следующих статье:
- Службы рабочей роли в .NET
- Создание службы Windows с использованием BackgroundService
Если вы разрабатываете службу Windows, используя .NET Framework, можно быстро установить приложение службы с помощью служебной программы командной строки InstallUtil.exe или PowerShell. Если вы являетесь разработчиком и хотите создать службу Windows, которую пользователи могут устанавливать и удалять, можно использовать бесплатный набор инструментов WiX Toolset или коммерческие средства, такие как Advanced Installer, InstallShield и другие. См. сведения о создании пакета установщика (классическое приложение Windows).
Если вы хотите удалить службу на своем компьютере, не выполняйте процедуру, описанную в этой статье. Вместо этого определите, какая программа (или программный пакет) установила эту службу, а затем выберите Приложения в параметрах, чтобы удалить эту программу. Многие службы являются составной частью ОС Windows. Если их удалить, это может привести к нестабильной работе системы.
Чтобы использовать процедуру, описанную в этой статье, сначала необходимо добавить установщик службы в свою службу Windows. Дополнительные сведения см. в пошаговом руководстве. Создание приложения службы Windows.
Проекты служб Windows нельзя запускать напрямую из среды разработки Visual Studio путем нажатия клавиши F5 . Перед запуском проекта необходимо установить службу в проекте.
Запустите обозреватель сервера и убедитесь, что служба установлена или удалена.
Установка с помощью программы InstallUtil.exe
- В меню Пуск выберите каталог Visual Studio версия>, а затем выберите Командная строка разработчика для VS версия>. Появится командная строка разработчика для Visual Studio.
- Откройте каталог, где находится скомпилированный исполняемый файл вашего проекта.
- Запустите InstallUtil.exe из командной строки, указав исполняемый файл проекта в качестве параметра:
installutil .exe
- Для 32-разрядной версии .NET Framework 4 или 4.5 и более поздних версий: если каталог установки Windows — C:\Windows, по умолчанию используется путь C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe.
- Для 64-разрядной версии .NET Framework 4 или 4.5 и более поздних версий: по умолчанию используется путь C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe.
Удаление с помощью служебной программы InstallUtil.exe
- В меню Пуск выберите каталог Visual Studio версия>, а затем выберите Командная строка разработчика для VS версия>. Появится командная строка разработчика для Visual Studio.
- Запустите InstallUtil.exe из командной строки, указав выходные данные проекта в качестве параметра:
installutil /u .exe
Установка с помощью PowerShell
- В меню Пуск выберите Каталог Windows PowerShell и Windows PowerShell.
- Откройте каталог, где находится скомпилированный исполняемый файл вашего проекта.
- Запустите командлет New-Service, используя имя службы и выходные данные проекта в качестве аргументов.
New-Service -Name "YourServiceName" -BinaryPathName .exe
Удаление с помощью PowerShell
- В меню Пуск выберите Каталог Windows PowerShell и Windows PowerShell.
- Выполните командлет Remove-Service, указав в качестве аргумента имя службы.
Remove-Service -Name "YourServiceName"
Примечание. Чтобы использовать этот командлет, требуется PowerShell 6 или более поздней версии. Дополнительные сведения см. в статье Установка PowerShell в Windows.
sc.exe delete "YourServiceName"
См. также
- Знакомство с приложениями служб Windows
- Практическое руководство. Создание служб Windows
- Практическое руководство. Добавление установщиков в приложение службы
- Installutil.exe (установщик)
Совместная работа с нами на GitHub
Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.
Практическое руководство. Создание служб Windows
Эта документация не относится к последней версии службы Windows. Последние сведения об использовании BackgroundService служб Windows и шаблоне рабочей службы см. в следующих статье:
- Службы рабочей роли в .NET
- Создание службы Windows с использованием BackgroundService
При создании службы можно использовать шаблон проекта Visual Studio, который называется Служба Windows. Этот шаблон автоматически выполняет основную часть работы, ссылаясь на необходимые классы и пространства имен, устанавливая наследование от базового класса для служб и переопределяя некоторые методы, которые вы обычно хотите переопределять.
Шаблон проекта «Службы Windows» в экспресс-выпуске Visual Studio отсутствует.
Для создания функциональной службы необходимо выполнить, как минимум, следующее:
- Задайте свойство ServiceName.
- Создайте установщики, необходимые для приложения службы.
- Переопределите и задайте код для методов OnStart и OnStop для настройки режимов поведения службы.
Создание приложения службы Windows
- Создайте проект Служба Windows.
Примечание. Инструкции по созданию службы без использования шаблона см. в статье Практическое руководство. Создание службы программным способом.
В окне Свойства задайте для своей службы свойство ServiceName.
Примечание. Значение ServiceName свойства всегда должно соответствовать имени, указанному в классах установщика. При изменении этого свойства необходимо также обновить свойство ServiceName классов установщика.
Свойство | Параметр |
---|---|
CanStop | True , чтобы указать, что служба может принимать запросы на останов работы; false для предотвращения останова службы. |
CanShutdown | True , чтобы указать, что служба хочет принимать уведомления о выключении компьютера, на котором она работает, позволяя ему вызывать процедуру OnShutdown. |
CanPauseAndContinue | True , чтобы указать, что служба может принимать запросы на приостановку или возобновление выполнения; false для предотвращения приостановки и возобновления работы службы. |
CanHandlePowerEvent | True , чтобы указать, что служба может обрабатывать уведомления об изменениях состояния питания компьютера; false , чтобы не сообщать службе об этих изменениях. |
AutoLog | True для внесения информационных записей в журнал событий приложения, когда служба выполняет некоторое действие; false для отключения этой функции. Дополнительные сведения см. в статье Практическое руководство. Запись сведений о службах в журнал. Примечание. По умолчанию свойство AutoLog имеет значение true . |
Примечание. Когда CanStop или CanPauseAndContinue имеют значение false , диспетчер служб будет отключать пункты меню, отвечающие за остановку, приостановку или возобновление работы службы.
Примечание. Не нажимайте клавишу F5 для запуска проекта — таким способом нельзя запустить проект службы.
См. также
- Знакомство с приложениями служб Windows
- Практическое руководство. Создание службы программным способом
- Практическое руководство. Добавление установщиков в приложение служб
- Практическое руководство. Запись сведений о службах в журнал
- Практическое руководство. Запуск служб
- Практическое руководство. Назначение службам контекста безопасности
- Практическое руководство. Установка и удаление служб
- Пошаговое руководство. Создание приложения служб Windows в конструкторе компонентов
Совместная работа с нами на GitHub
Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.
Создание определяемой пользователем службы
В этой статье описано, как создать Windows NT определяемую пользователем службу.
Область применения: Windows 10 — все выпуски
Оригинальный номер базы знаний: 137890
Эта статья содержит сведения о редактировании реестра. Перед изменением реестра убедитесь, что вы понимаете, как восстановить его в случае возникновения проблемы. Дополнительные сведения о том, как это сделать, см. в разделах справки по восстановлению реестра или разделу реестра в интернете в редакторе реестра.
Сводка
Набор ресурсов Windows NT предоставляет две служебные программы, которые позволяют создать Windows NT определяемую пользователем службу для Windows NT приложений и некоторых 16-разрядных приложений, но не для пакетных файлов.
Instrsrv.exe устанавливает и удаляет системные службы из Windows NT, а Srvany.exe позволяет любому приложению Windows NT запускаться как служба.
Действия по созданию определяемой пользователем службы
Чтобы создать Windows NT определяемую пользователем службу, выполните следующие действия.
-
В командной строке MS-DOS (выполняется CMD.EXE) введите следующую команду:
path \INSTSRV.EXE My Service path \SRVANY.EXE
где path — это диск и каталог Windows NT Resource Kit (например, C:\RESKIT ), а My Service — имя создаваемой службы. Пример: C:\Program Files\Resource Kit\Instsrv.exe Notepad C:\Program Files\Resource Kit\Srvany.exe
Примечание. Чтобы убедиться, что служба создана правильно, проверка реестр, чтобы убедиться, что для параметра HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\service name ImagePath задано значение SRVANY.EXE. Если этот параметр задан неправильно, служба будет остановлена вскоре после запуска и вернет событие с идентификатором 7000 (не удалось запустить имя службы ).
Предупреждение Неправильное использование редактора реестра может привести к серьезным проблемам, которые могут потребовать переустановки операционной системы. Корпорация Майкрософт не может гарантировать, что проблемы, возникающие в результате неправильного использования редактора реестра, могут быть устранены. При изменении реестра полагайтесь на свой опыт и знания.
- Изменение ключей и значений
- Добавление и удаление сведений в реестре
- Изменение данных реестра
Перед изменением реестра необходимо создать резервную копию.
- Имя ключа: Параметры
- Класс:
- Имя значения: Приложение
- Тип данных: REG_SZ
- Строка: \
где \ — это диск и полный путь к исполняемому файлу приложения, включая расширение (например, C:\WinNT\Notepad.exe).
По умолчанию только что созданная служба настроена для автоматического запуска при перезапуске системы. Чтобы изменить этот параметр на Вручную, запустите апплет Службы из панель управления. Затем измените значение параметра Запуск на Вручную. Службу, заданную как Ручная , можно запустить одним из нескольких способов:
- Из апплета Службы в панель управления
- В командной строке MS-DOS введите следующую команду:
NET START
\Sc.exe start
Дополнительные сведения об установке и удалении определяемой пользователем службы см. в документе Srvany.wri, предоставленном вместе со служебными программами Windows NT Resource Kit (например, C:\Reskit\Srvany.wri ). Этот документ также можно найти на компакт-диске Windows NT Resource Kit в каталоге Common\Config .
Сбор данных
Если вам нужна помощь службы поддержки Microsoft, мы рекомендуем собирать информацию путем выполнения действий, описанных в разделе Сбор информации с помощью TSS для решения проблем, связанных с развертыванием.
Учебник. Создание приложения службы Windows
Эта документация не относится к последней версии службы Windows. Последние сведения о службах Windows, использующих BackgroundService и шаблон службы рабочих ролей, см. в следующих разделах:
- Службы рабочей роли в .NET
- Создание службы Windows с использованием BackgroundService
Из этой статьи вы узнаете, как создать в Visual Studio приложение службы Windows, которое записывает сообщения в журнал событий.
Создание службы
Для начала создайте проект и настройте значения, необходимые для правильной работы службы.
- В Visual Studio в меню Файл последовательно выберите пункты Создать>Проект (или нажмите клавиши CTRL + SHIFT + N ), чтобы открыть окно Новый проект.
- Найдите и выберите шаблон проекта Служба Windows (платформа .NET Framework).
Примечание Если шаблон службы Windows не отображается, может потребоваться установить рабочую нагрузку разработка классических приложений .NET с помощью Visual Studio Installer.
Переименование службы
Измените имя службы с Service1 на MyNewService.
- В Обозреватель решений выберите Service1.cs или Service1.vb, а затем в контекстном меню выберите Переименовать. Переименуйте файл в MyNewService.cs или MyNewService.vb, а затем нажмите клавишу ВВОД . Появится всплывающее окно, предлагающее переименовать все ссылки на элемент кода Service1.
- Выберите Да.
- На вкладке Проект выберите в контекстном меню пункт Свойства. В окне Свойства измените значение ServiceName на MyNewService.
- В меню Файл выберите команду Сохранить все.
Добавление компонентов в службу
В этом разделе к службе Windows будет добавлен настраиваемый журнал событий. Компонент EventLog — это пример типа компонента, который можно добавить в службу Windows.
Добавление возможности работы с настраиваемым журналом событий
- В Обозреватель решений в контекстном меню myNewService.cs или MyNewService.vb выберите Просмотреть Designer.
- На панели элементов разверните узел Компоненты, а затем перетащите компонент EventLog на вкладку Service1.cs [Конструктор] или Service1.vb [Конструктор] .
- В Обозреватель решений в контекстном меню myNewService.cs или MyNewService.vb выберите Просмотреть код.
- Определите пользовательский журнал событий. Для C# измените существующий MyNewService() конструктор, как показано в следующем фрагменте кода. Для Visual Basic добавьте New() конструктор, как показано в следующем фрагменте кода.
public MyNewService() < InitializeComponent(); eventLog1 = new System.Diagnostics.EventLog(); if (!System.Diagnostics.EventLog.SourceExists("MySource")) < System.Diagnostics.EventLog.CreateEventSource( "MySource","MyNewLog"); >eventLog1.Source = "MySource"; eventLog1.Log = "MyNewLog"; >
' To access the constructor in Visual Basic, select New from the ' method name drop-down list. Public Sub New() MyBase.New() InitializeComponent() Me.EventLog1 = New System.Diagnostics.EventLog If Not System.Diagnostics.EventLog.SourceExists("MySource") Then System.Diagnostics.EventLog.CreateEventSource("MySource", "MyNewLog") End If EventLog1.Source = "MySource" EventLog1.Log = "MyNewLog" End Sub
using System.Diagnostics;
Imports System.Diagnostics
Определение действий при запуске службы
В редакторе кода для MyNewService.cs или MyNewService.vb найдите OnStart метод . Visual Studio автоматически создал пустое определение метода при создании проекта. Добавьте код, с помощью которой запись сохраняется в журнале событий при запуске службы:
protected override void OnStart(string[] args)
' To access the OnStart in Visual Basic, select OnStart from the ' method name drop-down list. Protected Overrides Sub OnStart(ByVal args() As String) EventLog1.WriteEntry("In OnStart") End Sub
Опрос
Так как приложение службы предполагает длительное время выполнения, оно обычно опрашивает или отслеживает систему. Отслеживание настраивается в методе OnStart. После начала работы службы метод OnStart должен возвращать управление операционной системе, чтобы она не блокировалась.
Для создания простого механизма опроса используйте компонент System.Timers.Timer. Таймер через определенные интервалы времени генерирует событие Elapsed, при возникновении которых служба может выполнять отслеживание. Компонент Timer используется следующим образом:
- Задайте свойства компонента Timer в методе MyNewService.OnStart .
- Запустите таймер, вызвав метод Start.
Настройка механизма опроса
- Добавьте оператор using в файл MyNewService.cs или оператор Imports в файл MyNewService.vb для пространства имен System.Timers.
using System.Timers;
Imports System.Timers
// Set up a timer that triggers every minute. Timer timer = new Timer(); timer.Interval = 60000; // 60 seconds timer.Elapsed += new ElapsedEventHandler(this.OnTimer); timer.Start();
' Set up a timer that triggers every minute. Dim timer As Timer = New Timer() timer.Interval = 60000 ' 60 seconds AddHandler timer.Elapsed, AddressOf Me.OnTimer timer.Start()
private int eventId = 1;
Private eventId As Integer = 1
public void OnTimer(object sender, ElapsedEventArgs args) < // TODO: Insert monitoring activities here. eventLog1.WriteEntry("Monitoring the System", EventLogEntryType.Information, eventId++); >
Private Sub OnTimer(sender As Object, e As Timers.ElapsedEventArgs) ' TODO: Insert monitoring activities here. eventLog1.WriteEntry("Monitoring the System", EventLogEntryType.Information, eventId) eventId = eventId + 1 End Sub
Задачи можно выполнять с помощью фоновых рабочих потоков, а не выполнять всю работу в основном потоке. Для получения дополнительной информации см. System.ComponentModel.BackgroundWorker.
Определение действий при остановке службы
Вставьте в метод OnStop строку кода, с помощью которой запись сохраняется в журнале событий при остановке службы:
protected override void OnStop()
Protected Overrides Sub OnStop() EventLog1.WriteEntry("In OnStop.") End Sub
Определение других действий для службы
Вы можете переопределить методы OnPause, OnContinue и OnShutdown, добавив дополнительные процессы обработки.
В следующем коде показано, как можно переопределить OnContinue метод в MyNewService классе :
protected override void OnContinue()
Protected Overrides Sub OnContinue() EventLog1.WriteEntry("In OnContinue.") End Sub
Установка состояния службы
Службы сообщают о своем состоянии диспетчеру служб, чтобы пользователь мог определить, работает ли служба правильно. По умолчанию служба, которая наследуется от ServiceBase, сообщает ограниченный набор состояний, включая SERVICE_STOPPED, SERVICE_PAUSED и SERVICE_RUNNING. Если служба запускается не сразу, полезно обеспечить сообщение состояния SERVICE_START_PENDING.
Состояния ERVICE_START_PENDING и SERVICE_STOP_PENDING можно реализовать путем добавления кода, вызывающего функцию Windows SetServiceStatus.
Реализация состояния ожидания службы
- Добавьте оператор using в файл MyNewService.cs или оператор Imports в файл MyNewService.vb для пространства имен System.Runtime.InteropServices.
using System.Runtime.InteropServices;
Imports System.Runtime.InteropServices
public enum ServiceState < SERVICE_STOPPED = 0x00000001, SERVICE_START_PENDING = 0x00000002, SERVICE_STOP_PENDING = 0x00000003, SERVICE_RUNNING = 0x00000004, SERVICE_CONTINUE_PENDING = 0x00000005, SERVICE_PAUSE_PENDING = 0x00000006, SERVICE_PAUSED = 0x00000007, >[StructLayout(LayoutKind.Sequential)] public struct ServiceStatus < public int dwServiceType; public ServiceState dwCurrentState; public int dwControlsAccepted; public int dwWin32ExitCode; public int dwServiceSpecificExitCode; public int dwCheckPoint; public int dwWaitHint; >;
Public Enum ServiceState SERVICE_STOPPED = 1 SERVICE_START_PENDING = 2 SERVICE_STOP_PENDING = 3 SERVICE_RUNNING = 4 SERVICE_CONTINUE_PENDING = 5 SERVICE_PAUSE_PENDING = 6 SERVICE_PAUSED = 7 End Enum Public Structure ServiceStatus Public dwServiceType As Long Public dwCurrentState As ServiceState Public dwControlsAccepted As Long Public dwWin32ExitCode As Long Public dwServiceSpecificExitCode As Long Public dwCheckPoint As Long Public dwWaitHint As Long End Structure
Примечание Диспетчер служб использует члены dwWaitHint и dwCheckpoint структуры SERVICE_STATUS, чтобы определить время, в течение которого нужно ожидать запуска или завершения работы службы Windows. Если методы OnStart и OnStop выполняются долго, служба может запросить больше времени, повторно вызвав функцию SetServiceStatus с увеличенным значением dwCheckPoint .
[DllImport("advapi32.dll", SetLastError = true)] private static extern bool SetServiceStatus(System.IntPtr handle, ref ServiceStatus serviceStatus);
Declare Auto Function SetServiceStatus Lib "advapi32.dll" (ByVal handle As IntPtr, ByRef serviceStatus As ServiceStatus) As Boolean
// Update the service state to Start Pending. ServiceStatus serviceStatus = new ServiceStatus(); serviceStatus.dwCurrentState = ServiceState.SERVICE_START_PENDING; serviceStatus.dwWaitHint = 100000; SetServiceStatus(this.ServiceHandle, ref serviceStatus);
' Update the service state to Start Pending. Dim serviceStatus As ServiceStatus = New ServiceStatus() serviceStatus.dwCurrentState = ServiceState.SERVICE_START_PENDING serviceStatus.dwWaitHint = 100000 SetServiceStatus(Me.ServiceHandle, serviceStatus)
// Update the service state to Running. serviceStatus.dwCurrentState = ServiceState.SERVICE_RUNNING; SetServiceStatus(this.ServiceHandle, ref serviceStatus);
' Update the service state to Running. serviceStatus.dwCurrentState = ServiceState.SERVICE_RUNNING SetServiceStatus(Me.ServiceHandle, serviceStatus)
// Update the service state to Stop Pending. ServiceStatus serviceStatus = new ServiceStatus(); serviceStatus.dwCurrentState = ServiceState.SERVICE_STOP_PENDING; serviceStatus.dwWaitHint = 100000; SetServiceStatus(this.ServiceHandle, ref serviceStatus); // Update the service state to Stopped. serviceStatus.dwCurrentState = ServiceState.SERVICE_STOPPED; SetServiceStatus(this.ServiceHandle, ref serviceStatus);
' Update the service state to Stop Pending. Dim serviceStatus As ServiceStatus = New ServiceStatus() serviceStatus.dwCurrentState = ServiceState.SERVICE_STOP_PENDING serviceStatus.dwWaitHint = 100000 SetServiceStatus(Me.ServiceHandle, serviceStatus) ' Update the service state to Stopped. serviceStatus.dwCurrentState = ServiceState.SERVICE_STOPPED SetServiceStatus(Me.ServiceHandle, serviceStatus)
Добавление установщиков в службу
Перед тем как запускать службу Windows, ее нужно установить. При этом она регистрируется в диспетчере служб. В проект можно добавить установщики, которые обрабатывают сведения о регистрации.
- В обозревателе решений в контекстном меню для файла MyNewService.cs или MyNewService.vb выберите пункт Показать конструктор.
- В представлении Конструктор щелкните область фона правой кнопкой мыши и выберите в контекстном меню команду Добавить установщик. По умолчанию Visual Studio добавляет в проект класс компонента ProjectInstaller , содержащий два установщика. Они предназначены для установки службы и связанного со службой процесса.
- В представлении Конструктор для ProjectInstaller выберите serviceInstaller1 для проекта Visual C# или ServiceInstaller1 для проекта Visual Basic. Затем в контекстном меню выберите пункт Свойства.
- Убедитесь в том, что в окне Свойства свойство ServiceName имеет значение MyNewService.
- Введите для свойства Description какой нибудь текст, например Пример службы. Этот текст отображается в столбце Описание в окне Службы и помогает пользователю понять, для чего служба нужна.
- Введите текст для свойства DisplayName, например Отображаемое имя MyNewService. Этот текст отображается в столбце Отображаемое имя в окне Службы. Это имя может отличаться от значения свойства ServiceName, которое представляет собой имя, используемое в системе (например, когда вы запускаете службу с помощью команды net start ).
- Выберите для свойства StartType значение Automatic в раскрывающемся списке.
- В итоге окно Свойства должно выглядеть так:
- В представлении Конструктор для ProjectInstaller выберите serviceProcessInstaller1 для проекта Visual C# или ServiceProcessInstaller1 для проекта Visual Basic. Затем в контекстном меню выберите пункт Свойства. Выберите для свойства Account значение LocalSystem в раскрывающемся списке. Это позволит установить и запускать службу от имени локальной системной учетной записи.
Важно! У учетной записи LocalSystem имеется множество разрешений, включая разрешение на запись в журнал событий. Эту учетную запись следует использовать с осторожностью, поскольку это может увеличить риск атак с помощью вредоносных программ. Для других задач следует рассмотреть возможность использования учетной записи LocalService , которая аналогична учетной записи непривилегированного пользователя локального компьютера. Удаленным серверам при этом передаются учетные данные анонимного пользователя. В этом примере произойдет ошибка, если вы попытаетесь использовать учетную запись LocalService , так как для нее требуется разрешение на запись в журнал событий.
Дополнительные сведения об установщиках см. в руководстве по добавлению установщиков в приложение-службу.
Установка параметров запуска (необязательно)
Прежде чем добавлять параметры запуска, решите, является ли это наилучшим способом передачи информации в службу. Хотя параметры запуска просты для использования и синтаксического анализа и пользователи могут легко их переопределять, для пользователей их поиск и применение могут оказаться затрудненными (без документации). Как правило, если вашей службе требуется всего несколько параметров запуска, то следует использовать реестр или файл конфигурации.
Служба Windows может принимать аргументы командной строки или параметры запуска. При добавлении кода в параметры запуска процесса пользователь может запускать службу со своими собственными специальными параметрами из окна свойств службы. Однако эти параметры запуска не сохраняются при следующем запуске службы. Задать постоянные параметры запуска можно в реестре.
Для каждой службы Windows создается запись в разделе реестра HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services. Для хранения информации, к которой может обращаться ваша служба, в разделе службы можно использовать подраздел Parameters. Файлы конфигурации приложения для службы Windows можно использовать так же, как и для программ других типов. Пример кода см. в разделе ConfigurationManager.AppSettings.
Добавление параметров запуска
- Выберите файл Program.cs или MyNewService.Designer.vb, а затем в контекстном меню выберите пункт Просмотреть код. Измените код метода Main , добавив входной параметр, который будет передаваться в конструктор службы:
static void Main(string[] args) < ServiceBase[] ServicesToRun; ServicesToRun = new ServiceBase[] < new MyNewService(args) >; ServiceBase.Run(ServicesToRun); >
Shared Sub Main(ByVal cmdArgs() As String) Dim ServicesToRun() As System.ServiceProcess.ServiceBase = New System.ServiceProcess.ServiceBase() System.ServiceProcess.ServiceBase.Run(ServicesToRun) End Sub
using System.Diagnostics; public MyNewService(string[] args) < InitializeComponent(); string eventSourceName = "MySource"; string logName = "MyNewLog"; if (args.Length >0) < eventSourceName = args[0]; >if (args.Length > 1) < logName = args[1]; >eventLog1 = new EventLog(); if (!EventLog.SourceExists(eventSourceName)) < EventLog.CreateEventSource(eventSourceName, logName); >eventLog1.Source = eventSourceName; eventLog1.Log = logName; >
Imports System.Diagnostics Public Sub New(ByVal cmdArgs() As String) InitializeComponent() Dim eventSourceName As String = "MySource" Dim logName As String = "MyNewLog" If (cmdArgs.Count() > 0) Then eventSourceName = cmdArgs(0) End If If (cmdArgs.Count() > 1) Then logName = cmdArgs(1) End If eventLog1 = New EventLog() If (Not EventLog.SourceExists(eventSourceName)) Then EventLog.CreateEventSource(eventSourceName, logName) End If eventLog1.Source = eventSourceName eventLog1.Log = logName End Sub
protected override void OnBeforeInstall(IDictionary savedState)
Protected Overrides Sub OnBeforeInstall(ByVal savedState As IDictionary) Dim parameter As String = "MySource1"" ""MyLogFile1" Context.Parameters("assemblypath") = """" + Context.Parameters("assemblypath") + """ """ + parameter + """" MyBase.OnBeforeInstall(savedState) End Sub
Сборка службы
- В обозревателе решений выберите пункт Свойства в контекстном меню проекта MyNewService. Отобразятся страницы свойств для проекта.
- На вкладке Приложение в списке Автоматически запускаемый объект выберите MyNewService.Program (или Sub Main для проекта Visual Basic).
- Чтобы выполнить сборку проекта, в обозревателе решений выберите в контекстном меню проекта пункт Сборка (или нажмите клавиши CTRL + SHIFT + B ).
Установка службы
После создания службы Windows ее можно установить. Чтобы установить службу Windows, необходимо иметь разрешения администратора на том компьютере, где выполняется установка.
- Откройте Командную строку разработчика Visual Studio с учетными данными администратора.
- В командной строке разработчика для Visual Studio перейдите к папке, которая содержит выходные данные проекта (по умолчанию это подкаталог \bin\Debug проекта).
- Введите следующую команду:
installutil MyNewService.exe
- Класс RunInstallerAttribute отсутствует в классе ProjectInstaller .
- Значение атрибута отличается от true .
- Класс ProjectInstaller не определен как public .
Запуск и выполнение службы
- В Windows откройте классическое приложение Службы. Нажмите клавиши Windows+R, чтобы открыть окно Выполнить, введите services.msc и нажмите клавишу ВВОД или кнопку ОК. Заданное вами отображаемое имя службы отобразится в списке Службы, представленном в алфавитном порядке.
- Чтобы запустить службу, в ее контекстном меню выберите пункт Запустить.
- Чтобы остановить службу, в ее контекстном меню выберите пункт Остановить.
- Для запуска и остановки службы в командной строке можно использовать команды net start и net stop (необязательно).
Проверка журнала событий для службы
- В Windows откройте классическое приложение Просмотр событий. Введите строку Просмотр событий в поле поиска Windows и выберите Просмотр событий в результатах поиска.
Совет В Visual Studio доступ к журналам событий можно получить, открыв обозреватель сервера в меню Вид (или нажав клавиши CTRL + ALT + S ) и развернув узел Журналы событий для локального компьютера.
Очистка ресурсов
Если приложение службы Windows вам больше не нужно, его можно удалить.
- Откройте Командную строку разработчика Visual Studio с учетными данными администратора.
- В окне Командная строка разработчика для Visual Studio перейдите к папке, которая содержит выходные данные проекта.
- Введите следующую команду:
installutil.exe /u MyNewService.exe
Следующие шаги
Теперь, после создания службы, можно выполнить указанные ниже действия.
- Создайте автономную программу установки, с помощью которой другие пользователи могут устанавливать вашу службу Windows. Создать установщик для службы Windows можно с помощью набора инструментов WiX. Другие идеи можно почерпнуть в статье о создании пакета установщика.
- Изучите возможности компонента ServiceController, который позволяет отправлять команды в установленную службу.
- Для создания журнала событий при установке приложения, а не во время его запуска, можно воспользоваться установщиком. В этом случае журнал событий удаляется установщиком при удалении приложения. Для получения дополнительной информации см. EventLogInstaller.
См. также
- Приложения служб Windows
- Знакомство с приложениями служб Windows
- Практическое руководство. Отладка приложений служб Windows
- Службы (Windows)
Совместная работа с нами на GitHub
Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.