Upgradetargetwebapplication: 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: Upgradetargetwebapplication


Prepares the environment for the gradual upgrade of a specific version 2.0 Web application by moving the existing version 2.0 Web application to a new URL and making a new version 3.0 Web application that is based on the existing version 2.0 Web application and associated settings. The version 3.0 Web application is set up to redirect any requests for content from sites that have not yet been upgraded back to the version 2.0 Web application.


stsadm.exe -o upgradetargetwebapplication

**   -url <URL to upgrade>**

**   -relocationurl <new URL for non-upgraded content>**

**   -apidname <new app pool name>**

**\[-apidtype {configurableID | NetworkService}\]**

**\[-apidlogin \<domain\\name\>\]**

**\[-apidpwd \<app pool password\>\]**



Parameter name Value Required? Description


A valid URL, such as http://server_name


The URL name that is to be upgraded.


A valid port number, such as "12345" or a host header


Relocates the existing SharePoint Web application to a new IIS site, and creates the newer version at the original location. The IIS site and existing Web application that are moved must have a new port or domain name.

An HTTP request for all content will be redirected to the proper domain throughout the gradual upgrade process.


A new port or host header must be specified.


A valid application pool name, such as "Test1"


The application pool ID.

The application pool defines the account and credentials that are used by the upgraded version 3.0 Web application.


One of the following types:

  • NetworkService

  • ConfigurableID


    If the ConfigurableID value is used, you must use the apidlogin parameter to specify a user name and password.


The identity type to use for the application pool.


You cannot use the same application pool that you used for the previous version.
You can use the same user account, but you must create a new application pool, or use an application pool that you already created for your upgraded sites.


A valid user name in the form domain\username


The user name to use for running processes in the application pool.

This parameter must be a Windows user name, and must be qualified with a domain name.


A valid Windows password to the application pool.


The password that is used in conjunction with the apidlogin parameter.




Specifies to exclusively use NTLM authentication instead of Negotiate (Kerberos). Kerberos requires the application pool account to be a Network Service or special configuration by the domain administrator. NTLM authentication works with any application pool account and the default domain configuration.