Retractsolution: Stsadm operation (Office SharePoint Server)

Applies To: Office SharePoint Server 2007

This Office product will reach end of support on October 10, 2017. To stay supported, you will need to upgrade. For more information, see , Resources to help you upgrade your Office 2007 servers and clients.

 

Topic Last Modified: 2015-03-09

Operation name: Retractsolution

Description

Retracts the specified solution’s deployment. The retractsolution operation removes files from the front-end Web server. The deletesolution operation deletes the solution package in the solution store of the configuration, and should only be called after solution packages have been retracted.

Syntax

stsadm -o retractsolution

**-name \<solution name\>**

**\[-url\] \<URL name\>**

**\[-allcontenturls\]**

**\[-time\] \<time to remove\>**

**\[-immediate\]**

**\[-local\]**

**\[-lcid\] \<language\>**

Parameters

Parameter

Value

Required?

Description

name

A valid name of the solution in the solution store, such as “SampleSolution.wsp”

Yes

Enables the administrator to specify the name of a solution inside of the solution store.

url

A valid URL, such as http://server_name

No

URL location of a virtual server

allcontenturls

<none>

No

Equivalent to deploying the package to all nonadministrative virtual servers that are in the farm.

time

A valid date:time format that is culture-specific to the administrative language, such as “2/16/2007 12:15:12”

The -time parameter is not required if either the immediate or local parameter is specified. Otherwise, the -time parameter is required.

Enables the administrator to schedule the time that the deployment should occur.

Time requires that a user use a time format acceptable to the DateTime.Parse method. If the date time does not parse correctly, the following error message is displayed:

"‘<time user entered>’ is not a valid time format. Deployment was not initiated."

immediate

<none>

No

Causes the deployment to occur immediately after the command is executed.

local

<none>

The -local parameter is not required if either the immediate or time parameter is specified. Otherwise, the -local parameter is required.

Deploys the solution synchronously on the local computer only. The timer service is not used.

A developer must specify the -immediate, -local, or -time parameter. If one of these is not specified, the following error message is displayed:

"Deployment type was not specified. You must specify a deployment to just this server (-local), to all servers in the farm (-immediate), or a delayed deployment to all servers in the farm (-time)."

lcid

A valid locale ID, such as "1033" for English

No

Language locale ID of the solution to be retracted