Services - Resume

 

Declaration

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

Related Topics   

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 in order to make minor modifications to a resource. This activity resumes the service without terminating user connection.

Parameters

Service

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

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

Error Causes

On Error

example

NOTE:
  • The sample AML code below can be copied and pasted directly into the Steps Panel of the Task Builder.
  • Parameters containing user credentials, files, file paths, and/or other information specific to the task must be customized before the sample code can run successfully.

Description

Resume service "Task Scheduler" on "machineName."

NOTE: This example is for the purpose of viewing AML syntax only. Changing the state of a service might yield negative results.

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