npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

windows-service-manager

v0.1.2

Published

A node module to query, stop (optionally forcefully) and start Windows services

Downloads

223

Readme

Windows Service Manager

A node module to query, start and stop Windows services. Uses the sc and taskkill programs which is present on every version of Windows since Windows XP.

Usage

Service objects

The functions return service objects containing the following fields:

  • name: the service name
  • description: the optional service description, may not be present
  • state: an integer state code with the following possible values
    • 1: STOPPED
    • 2: STOP PENDING
    • 3: START PENDING
    • 4: STARTED
    • 5: CONTINUE PENDING
    • 6: PAUSE PENDING
    • 7: PAUSED
  • stateDescription: the textual description of the state as shown above
  • pid: the process identifier for the service, if it is running

Query all services

queryServices asynchronously returns an array of service objects, for all services installed on the system.

Parameters:

  • callback: a callback function function(error, service):
    • error: error that occured or null if no error
    • service: an array of service objects for all installed services.

Example:

var serviceManager = require('./windows-service-manager');

serviceManager.queryServices(function(error, services) {
    console.log(error || services);
});

Query a single service

queryService asynchronously returns an service object for the service with the specified name.

Parameters:

  • name: the name of the service to query.
  • callback: a callback function function(error, service):
    • error: error that occured or null if no error
    • service: a service object for the service named name.

Example:

var serviceManager = require('./windows-service-manager');

serviceManager.queryService('puppet' ,function(error, services) {
    console.log(error || services);
});

Start a service

startService asynchronously starts a service with the specified name. If the service is already started, no error is returned.

Parameters:

  • name: the name of the service to start.
  • timeoutSeconds: number of seconds to poll before returning. If 0, no polling is done. If a non-zero value, service status is polled. If the service has not started before the timeout expires, the callback error will be the string 'timeout'.
  • callback: a callback function function(error, service):
    • error: error that occured or null if no error
    • service: a service object for the service named name.

Example:

var serviceManager = require('./windows-service-manager');

serviceManager.startService('puppet', 5, function(error, services) {
    console.log(error || services);
});

Stop a service

stopService asynchronously stops a service with the specified name. If the service is already stopped, no error is returned.

Parameters:

  • name: the name of the service to stop.
  • timeoutSeconds: number of seconds to poll before returning. If 0, no polling is done. If a non-zero value, service status is polled. If the service has not stopped before the timeout expires, the callback error will be the string 'timeout'.
  • forceKill: boolean that specifies whether the service process should be killed if the service has not stopped within a non zero timeout interval.
  • callback: a callback function function(error, service):
    • error: error that occured or null if no error
    • service: a service object for the service named name.

Example:

var serviceManager = require('./windows-service-manager');

serviceManager.stopService('puppet', 20, true, function(error, services) {
    console.log(error || services);
});