List Services Action

Declaration

<AMGETSERVICESLIST RESULTDATASET="ServicesDataset" />

See Also

Install Service Action, Pause Service Action, Remove Service Action, Resume Service Action, Start Service Action, Stop Service Action

Description

Creates and populates a dataset with all the services installed on the system along with their current states (e.g. running, stopped, etc.).

NOTE: Services do not run on Windows 95/98/ME.

Practical Usage

Used to place a list of all system services into an AutoMate dataset. Once the dataset is created, other actions such as Loop Dataset can be used to access the data.

Parameters

General Tab

Create Dataset With Services

Text, Required
MARKUP: RESULTDATASET="ServicesDataset"

Specifies the name of the dataset to create and populate the list of services.

The available dataset fields are listed in the table below (assuming the dataset name assigned is theDataset):

Name

Data Type

Return Value

theDataset.ServiceName

Text

The name of the service as it appears in the General tab of the service's properties under Service Name.

theDataset.DisplayName

Text

The friendly name of the service as it appears in the General tab of the service's properties under Display Name.

theDataset.Status

Text

The current state of the service. Possible values for a service state are:

    • Stopped

    • StartPending

    • StopPending

    • Running

    • ContinuePending

    • PausePending

    • Paused

 

Notes

Custom Description

This action includes the Description tab for entering a custom step description.

More on setting custom step description

Standard Error Handling Options

This action also includes the standard Error Causes and On Error failure handling options/tabs.

More on Error Handling Options

Variables and Expressions

All text fields allow the use of expressions, which can be entered by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, you can open Expression Builder from these fields by pressing F2.

More on variables
More on expressions

More on the expression builder

Example

NOTE: The code below can be copied and pasted directly into the Steps pane of the Task Builder.

<AMGETSERVICESLIST RESULTDATASET="ServicesDataset" />