Start/Stop Service

Applies To: Opalis 6.3

The Start/Stop Service object will start, stop, pause, or restart a Windows service.This object uses a satellite license.

The Start/Stop Service object can be used to restart a service that has stopped responding or to shut down a service in preparation for a backup.

Configuring the Start/Stop Service Object

To configure the Start/Stop Service object you will need to know the name of the service as well as the computer where the service is running. Depending on the service that you are interacting with, you may need to know parameters that are required to start the service.

To configure the Start/Stop Service object

  1. From the Objects pane, drag an Start/Stop Service object to the active Policy.

  2. Double-click the Start/Stop Service object icon. The Properties dialog opens.

  3. For information about the settings on the Details tab, see the following table.

  4. For information about the settings on the General tab, the Run Behavior tab, and other tabs if applicable, see Common Tabs.

Details Tab

Element Configuration Instructions

Action

Select the action that you want to take on the service:

Start service - Start the service if it is stopped. This action is ignored if the service is already running.

Stop service - Stop a running service. This action is ignored if the service is already stopped.

Pause service - Pause a running service. This action is ignored if the service is already stopped or paused.

Restart service - Stop then start a running service. If the service is already stopped it will only be started.

Computer

Type the computer where this service is running. Type localhost to specify the Action Server where the Policy is being processed. You can also use the ellipsis ( ... ) button to browse for the computer.

Service

Type the name of the service. You can also use the ellipsis ( ... ) button to browse for the service. Browsing is only available if you have specified a valid Computer.

Parameters

Type any parameters that are required to interact with the Service.

Action must complete in less than

Specify the maximum amount of time in which the action must complete. After the time has expired, the Start/Stop Service object will timeout and return a failure.

Start/Stop Service Published Data

The following table lists the element names and descriptions of the data published by this object. For information about the published data elements that are common to all objects, see Policy Workflow Rules.

Element Name Description

Service display name

The name of the service as it appears in the Windows Services control panel utility.

Service real name

The name of the executable file that the service is running.

Service status

The current status of the service.

Service computer

The name of the computer where the service is located.

Control Parameters

The parameters that were passed to the service when it was started, stopped, paused or restarted.

Control Time Allowance

The maximum amount of time that was specified to complete the action of starting, stopping, pausing, or restarting the service.

Control Action

The action that was taken on the service: Start, Stop, Pause, or Restart.