Online Manual: "User Management Resource Adminstrator"
Go to: User Management Resource Administrator homepage
Script action: List services status
Function
With this script action, the name and status of services and drivers
installed on a computer are collected and stored in an output variable.
Once you have collected these data, you can manage the listed services
using the Execute service command
script action. For more detailed information, see the document UMRA
Example projects: Service Management in the UMRA document library
on the website.
Deployment
Although this script action can be used in all UMRA modules, the most
common usage would be an F&D implementation to collect and manage
services. This would require two projects, Project A and Project B. Project
A will contain the script action List services status to retrieve the
services information. In Project B you define the columns you wish to
display and the associated actions (Stop service, Start service, etc.)
Properties
|
Property Name |
Description |
Typical setting |
Remarks |
|
Computer |
The name of the computer where the services
/ drivers have been installed |
|
|
|
Include services |
Select "No" if you do not wish to
include the name and status of services in the output table. |
Default value is "Yes" |
Optional |
|
Include drivers |
Select "Yes" if you wish to include
the name and status of drivers in the output table. |
Default value is "No" |
Optional |
|
Include non-stopped |
Select "No" if you do not wish to
include services and drivers that are NOT in the stopped state |
Default value is "Yes" |
Optional |
|
Include stopped |
Select "No" if you do not wish to
include services and drivers that are in the stopped state |
Default value is "Yes" |
Optional |
|
Include configuration info |
Select "Yes" if you wish to include
configuration info in the output table. |
Default value is "No" |
Optional - If "Yes" is selected,
the columns "startup type" (text), "startup type"
(Code), "binary file" and "logon as" will be added
to the output table |
|
Services table |
%ServicesTable% is the default name of the
output variable containing the list of services |
%ServicesTable% |
|
The output variable (by default %ServicesTable%) may contain the following
columns:
|
Column
name (key name) |
Description |
|
computer name |
Name of the computer where the drivers / services
are installed |
|
ServiceName |
Key name for the service |
|
service display name |
A Windows service has two names. The long
name you see in the Control Panel is the display name of the service.
The internal shorter name of the serivce is called the key name. |
|
state (text) |
Returned as text |
|
state (code) |
Returned as code
1 - Service stopped
2 - Service start pending
3 - Service stop pending
4 - Service running
5 - Service continue pending
6 - Service pause pending
7 - Service error |
|
process ID |
|
|
svc type (text) |
Returned as text |
|
svc type (code) |
Returned as code
1 - Kernel driver
2 - File System Driver
16 - Own Process
32 - Shared Process |
|
interactive |
Yes or No |
Please note that a Windows service has two names. The long name as shown
in the Control Panel is the display name of the service. The internal,
shorter name of the serivce is called the key name. When you specify the
name of a column, the key name must be used.
It is also possible to retrieve the configuration details of each service.
If this option is selected, the following columns will be added:
|
Column name (key name) |
Description |
|
start up type (text) |
Returned as text |
|
start up type (code) |
Returned as code
0 - Boot start
1 - System start
2 - Auto start
3 - Demand start
4 - Disabled |
|
binary file |
|
|
log on as |
|
|