Contents

OperatingSystem.ControlService

Method

ControlService

ModuleOperatingSystem
LibraryCore
Action

Action to start, stop, etc. a service or daemon.

Parameters

Service (string): The service or daemon name. See Notes below.

Action (string; optional, default empty): One (or none) of "start", "stop", "restart", "pause" or "resume". Case is not significant. At least one of Action and/or Startup must be specified. "pause" and "resume" are only supported for Windows.

Startup (string; optional, default empty): If a non-empty string, the service startup type, one of "automatic", "delayed", "disabled" or "manual". Case is not significant. At least one of Action and/or Startup must be specified. Only used on Windows.

IncludeDependents (boolean; optional, default false): If specified and true and the action failed because of dependencies, perform the same action on the services that depend on this service then try the service action again. Only used on Windows. From v5.3 onwards.

StopDependencies (boolean; optional, default false): Old name up to v5.2 for IncludeDependents. Deprecated from v5.3 onwards.

If the Action is "restart", the dependent services are always restarted automatically regardless of IncludeDependents / StopDependencies.
Return values

Action (string): A list of the action(s) successfully performed, with an empty value indicating that the action failed.

Example
OperatingSystem.ControlService(Service:"MisbehaveSvc", Startup:"Disabled");

For backwards compatibility this example use the deprecated "StopDependencies" name rather than "IncludeDependents":

 OperatingSystem.ControlService(Service:"MisbehaveSvc", Action:"Stop", StopDependencies:true);
Platforms
  • Windows
  • Linux
  • MacOS
  • Solaris Intel
  • Solaris Sparc
Notes

This cannot be used to stop, pause or disable the Tachyon and 1E Client services/daemons but start, restart and resume operations are allowed.

For Windows, the Service parameter is the service's name, not the service's display name. For example, to stop the 'Background Intelligent Transfer Service' service, supply 'BITS'.

For Linux systems that use systemd to control daemons, the Service parameter should be the name as known to systemd, e.g. "cups.service". For older Linuxes that still use /etc/init.d, the Service parameter should be the name of a script in the /etc/init.d directory, e.g. "cups".

For Mac, the Service parameter is the full path of the daemon's plist file, e.g. "/Library/LaunchDaemons/com.1E.Daemon.plist". Beware, because as Apple documentation states:

"Due to bugs in the previous implementation [of launchd and the launchctl command] and long-standing client expectations, ... zero is always returned."

So the method will always appear to succeed on the Mac even if the specified service does not exist or some other error occurs.

For Solaris, the Service parameter is the name of a service as known by the svcadm command, e.g. "cups/scheduler".

WarningSetting Startup parameter to 'Manual' for Tachyon and 1E Client services is allowed, but the user needs to exercise caution using this functionality as it can lead to problems with the services not starting up correctly.