Retractsolution: Stsadm operation (Windows SharePoint Services)

Applies To: Windows SharePoint Services 3.0

 

Topic Last Modified: 2007-04-23

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