Share via

Retractwppack: Stsadm operation (Windows SharePoint Services)

  • Article

Applies To: Windows SharePoint Services 3.0

 

Topic Last Modified: 2007-04-23

Operation name: Retractwppack

Description

Retracts the deployment of a specified Web Part package.

Syntax

stsadm -o retractwppack

**   -name <name>**

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

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

**\[-immediate\]**

**\[-local\]**

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

Parameters

Parameter

Value

Required?

Description

name

A valid Web Part name, such as ”SampleWebPart.wpp”

Yes

Name of the Web Part package to remove

url

A valid URL, such as http://server_name

No

URL of the virtual server to which the Web Part package needs to be deployed

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 format 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 -time 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 parameters is not specified, the following 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