Services - Resume

Declaration

<AMSERVICES ACTIVITY="resume" SERVICE="text" REMOTEMACHINE="text" 
REMOTEDOMAIN="text" REMOTEUSERNAME="text" 
REMOTEPASSWORD="text (encrypted)" />

Description: Resumes a local or remote service that's currently in a paused state.

Practical Usage

Commonly used to resume a service that was initially paused with the use of the Pause Service activity. A running service may need to be paused to make minor modifications to a resource. This activity resumes the service without terminating user connection.

Service Parameters

Property	Type	Required	Default	Markup	Description
Service Name	Text	Yes	(Empty)	SERVICENAME="Task Scheduler"	The name of the service in which to resume.
Include devices in the list of services (local connection only)					If enabled, indicates that device drivers will be included in the Service name parameter's drop-down list of services. This parameter is disabled by default and is not available if a remote service is specified. This is a design time parameter and therefore includes no markups.

Computer Parameters

Property	Type	Required	Default	Markup	Description
Local computer					If enabled, indicates that this activity will resume a service on the local computer. This parameter is enabled by default. If this parameter is selected, the Another computer parameter becomes inactive. This is a visual mode parameter used during design time only, therefore, it contains no markups.
Another computer					If enabled, indicates that this activity will resume a service on a remote computer. The parameters below become active if this parameter is enabled. This is a visual mode parameter used during design time only, therefore, it contains no markups.
Computer	Text	Yes	(Empty)	REMOTEMACHINE="MachineName"	The computer name of the remote machine in which to connect to.
Domain	Text	Yes	(Empty)	REMOTEDOMAIN="DomainName"	The domain that the remote machine belongs to.
Username	Text	Yes	(Empty)	REMOTEUSERNAME="Username"	A valid username used to log onto the remote machine. This user must have proper permissions to modify services on the remote machine.
Password	Text	Yes	(Empty)	REMOTEPASSWORD="password"	The password associated with the username entered above.

Description tab - A custom description can be provided on the Description tab to convey additional information or share special notes about a task step.

Error Causes tab - Specify how this step should behave upon the occurrence of an error. (Refer to Task Builder > Error Causes Tab for details.)

On Error tab - Specify what AWE should do if this step encounters an error as defined on the Error Causes tab. (Refer to Task Builder > On Error Tab for details.)

Example

The sample AML code below can be copied and pasted directly into the Steps panel of the Task Builder.

Description: Resume service "Task Scheduler" on "machineName"

<AMSERVICES ACTIVITY="resume" SERVICE="Task Scheduler" 
REMOTEMACHINE="machineName" REMOTEDOMAIN="domainName" 
REMOTEUSERNAME="User" REMOTEPASSWORD="AM1OiXpJbSzJyjOlojMcSAm1fn5M3MxiXeEaME" />