Services - Uninstall

Declaration

<AMSERVICES ACTIVITY="uninstall" SERVICE="text" REMOTEMACHINE="text" REMOTEDOMAIN="text" REMOTEUSERNAME="text" REMOTEPASSWORD="text" />

Description:

Uninstalls a local or remote service.

Practical Usage

Used to the process of uninstalling a particular service, either on the local or remote machine.

Parameters

Service

Property

Type

Required

Default

Markup

Description

Service Name

Text

Yes

(Empty)

SERVICENAME="Task Scheduler"

The name of the service to uninstall.

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 uninstall 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 uninstall 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.

Description: Uninstall a remote service.

<AMSERVICES ACTIVITY="uninstall" SERVICE="Task Scheduler" REMOTEMACHINE="machine_name" REMOTEDOMAIN="domain.name" REMOTEUSERNAME="user" REMOTEPASSWORD="AM1H2tpzU1xiDL5+TNzMYl3hA==aME" />