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
From the Objects pane, drag an Start/Stop Service object to the active Policy.
Double-click the Start/Stop Service object icon. The Properties dialog opens.
For information about the settings on the Details tab, see the following table.
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. |