Учебник. Создание приложения службы 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, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.
Создание службы в Windows 10
Бывает, что имеется некий исполняемый файл, который необходимо зарегистрировать в системе как службу Windows 10. Существует множество различных способов, которые позволяют это сделать. Сейчас мы рассмотрим два основных и проверенных метода создания службы Windows.
Создание службы с помощью программы Sc.exe
Первый способ позволяет создавать службы, используя утилиты, работающие через командную строку. В данном случае, используется инструмент sc.exe. Он позволяет взаимодействовать с функциями API и выполнять операции со службами Windows 10. Несмотря на то, что данная программа даже не обладает графическим интерфейсом, она является мощным инструментом и может контролировать состояние служб, создавать, редактировать и управлять ими.
Если создавать службу, с помощью sc.exe, то не возникает необходимости в изменении параметров реестра и списка служб в диспетчере. Кроме того, утилита способна работать со службами на локальном компьютере, и выполнять те же действия на удаленных машинах.
Чтобы создать новый сервис, откройте командную строку от имени администратора и запустите команду «Sc create». Она запишет новую службу к базе диспетчера служб. Синтаксис команды представлен следующим образом:
sc create [ServiceName] [binPath= ]
- ServiceName — данным параметром определяется имя раздела службы в реестре;
Данное имя не совпадает с тем именем, которое будет отображаться диспетчере (например, в Services). - BinPath — в этом параметре записываем путь, где хранится исполняемый файл.
Чтобы было понятнее, в качестве примера, мы создадим службу «MySevice». При этом, отображаемое имя будет «My New Service». Указываем тип службы и включаем автозапуск:
Sc create MyService binPath=C:\MyService\MyService.exe DisplayName=″My New Service″ type=own start=auto
Теперь откройте оснастку «Services» и взгляните на то, что получилось:
Параметры службы, которая уже была создана и запущена, можно изменить при помощи команды Sc config. К примеру, мы заменим имя службы, которое отображается как:
Sc config MyService DisplayName=″My Service″
А еще можно избавиться от службы полным ее удалением. Для этого используйте такую команду:
С помощью утилиты PowerShell
Ну а с помощью такого мощного инструмента, как PowerShell можно хоть горы двигать. Он обладает большими возможностями и способен работать с различными службами. Здесь, для добавления новой службы, существует специальная команда «New -Service». Давайте попробуем новую службу, как и в прошлом примере, будем использовать те же имена и значения, только добавим дополнительный параметр, в виде описания. И так, команда, для создания нового сервиса, выглядит следующим образом:
New-Service -Name MyService -BinaryPathName C:\MyService\MyService.exe` -DisplayName ″My New Service″ -Description ″Very Important Service . ″
Для изменения параметров служб, существует команда «Set -Service»:
Set-Service -Name MyService -Description ″Not Very Important Service″ -StartupType Manual
Если не считать дополнительную возможность добавления описаний к службам, PowerShell обладает таким же функционалом, как и утилита Sc.exe. Но есть один маленький минус — здесь нет простой команды для удаления службы. Поэтому приходиться использовать такой вот, немного мудреный, код:
(Get-WmiObject win32_service -Filter ″name=′MyService′″).delete()
Так что утилита sc.exe, в этом плане будет получше. И по этой причине я предпочитаю именно ее.
Автор статьи: Сергей Windows 6 50103
Это может пригодиться:
Комментарии: 6 Оставить комментарий
Вархан 03.12.2018 в 05:53 (5 лет назад)
в таком варианте не срабатывает
Sc create MyService binPath=C:\MyService\MyService.exe DisplayName=″My New Service″ type=own start=auto
Работает только в таком варианте
sc create MyService binPath= «C:\MyService\MyService.exe» DisplayName= ″My New Service″ type= own start= auto
т.е. с пробелами после «=» и путь в кавычках.
Сергей 03.12.2018 в 10:53 (5 лет назад)
Спасибо за подсказку.
Денис 08.05.2022 в 23:57 (2 года назад)
Все здорово и замечательно но, как быть параметрами командной строки куда их писать очевидно в параметр1….параметр n ??
Александр 10.03.2020 в 13:36 (4 года назад)
Действительно! После каждого знака «=» нужен пробел. У меня работает без кавычек в пути. И работает из командного файла (в моем случае c.bat).
Вот строка из файла:
Sc create Service2020 binpath= c:\du1\slugba2020.exe displayname= «ATEST» type= own start= auto
Макс 15.09.2022 в 22:06 (1 год назад)
У меня не работало ни в одном из прошлых вариантов, заработало в таком виде:
sc create MyService binPath= «C:\MyService\MyService.exe» DisplayName= «My New Service» type= own start= auto
Внимание на кавычки, их есть 3 вида: « ″ » — у меня система (windows 10) понимает только »
Не понимаю как система может понимать кириллические кавычки елочкой:
sc create MyService binPath= «C:\MyService\MyService.exe» DisplayName= ″My New Service″ type= own start= auto
Макс 15.09.2022 в 22:09 (1 год назад)
UPD: Обратите внимание на скрин, оказывается сам сайт не отображает те кавычки, которые нужны.
Нам нужны прямые кавычки, кроме них есть кириллические елочки, на которые сайт заменяет прямые, и косые кавычки, это не то
Добавить комментарий Отменить ответ
Выберите изображение для вашего комментария (GIF, PNG, JPG, JPEG):
Новые статьи
Популярное
721105
Практическое руководство. Установка и удаление служб Windows
Эта документация не относится к последней версии службы Windows. Последние сведения о службах Windows, использующих BackgroundService и шаблон службы рабочих ролей, см. в следующих разделах:
- Службы рабочей роли в .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 10
Назначить любой процесс системной службой в Windows 10 можно с помощью маленькой консольной утилиты sc.exe, входящей в состав операционной системы. Для обращения к ней можно использовать как классическую «Командную строку», так и консоль «PowerShell».
- Запустите от имени администратора «Командную строку» или «PowerShell». Первую можно открыть из поиска Windows, вторую – из контекстного меню кнопки «Пуск».
- Сформируйте команду следующего вида: sc create MyService binPath=»C:\MyService.exe» DisplayName= «MyNewService» type=own start=auto . В качестве параметра MyService binPath укажите свой путь к исполняемому файлу создаваемой службы, а в качестве параметра DisplayName — имя службы, которое станет отображаться в оснастке управления службами.
- Вставьте сформированную команду в консоль и нажмите клавишу ввода.
Готово, осталось только проверить корректность создания службы в системной оснастке «Службы», запустить которую можно командой services.msc в диалоговом окошке, вызванном клавишами Win + R.
Способ 2: Консоль «PowerShell»
Необходимыми средствами создания служб в Windows 10 располагает другой штатный инструмент – консоль «PowerShell».
- Запустите «PowerShell» от имени администратора.
- Сформируйте команду вида New-Service -Name MyService -BinaryPathName C:\MyService.exe -DisplayName «Отображаемое имя службы» -Description «Описание службы» . Имя и описание службы могут быть произвольными.
- Вставьте команду в консоль и нажмите клавишу ввода.
Проверьте корректность работы в оснастке управления службами, там же ее можно настроить.
Способ 3: Сторонние программы
Также для создания собственных служб в Windows 10 можно использовать специализированные сторонние утилиты, например Non-Sucking Service Manager. Утилита работает через «Командную строку», но у нее также имеется и графический интерфейс.
Скачать Non-Sucking Service Manager с официального сайта
- Скачайте архив с утилитой с сайта разработчика и распакуйте в удобное расположение — к примеру, поместите исполняемый файл nssm.exe в корень системного диска.
- Запустите «Командную строку» от имени администратора.
- Выполните команду C:\nssm.exe install MyService , где MyService – название создаваемой службы.
- В открывшемся окошке инсталлятора в поле «Patch» укажите полный путь к исполняемому файлу службы и нажмите кнопку «Install service».
- Служба будет установлена, подтверждением чему станет появление окошка с уведомлением «Service *Name* installed successfully!». Нажмите в нем «OK» и закройте «Командную строку».
Остальные поля в окошке инсталлятора службы заполнять не обязательно, кроме тех случаев, когда в качестве службы устанавливается командный файл, например CMD, BAT или PS1. В этом случае в поле «Patch» указывается путь к приложению-обработчику, а в поле «Arguments» – путь к файлу скрипта.