Share via


Addpath: Stsadm operation (Windows SharePoint Services)

Applies To: Windows SharePoint Services 3.0

 

Topic Last Modified: 2008-10-09

Operation name: Addpath

Description

Adds a managed path inclusion to a Web application.

Syntax

stsadm -o addpath

**   -url <URL name>**

**   -type <explicit or wildcard inclusions>**

Parameters

Parameter name Value Required? Description

url

A valid URL name, such as http://server_name/inclusion_name

Yes

The URL of the inclusion you want to add to a Web application.

type (t)

One of the following values:

  • Explicit

  • Wildcard

Yes

Explicit: Specifies that a single path-based site collection can be created at the specified URL path.

Wildcard: Specifies that multiple path-based site collections can be created below the specified URL path.

Note

If you do not specify the type parameter, an error message is displayed. There is no default for this parameter.

Remarks

The addpath operation specifies where new site collections can be created by using the URL parameter.

You cannot have both an explicit inclusion and a wildcard inclusion using the same path on a Web application.

You may use non-ASCII characters in your inclusion path name.

Note

In Windows SharePoint Services 2.0, you could only use ASCII characters.

The following table shows example URLs and explains the types of paths.

Path type Example URL Path name Comments

Explicit inclusion

http://server1/site1

/site1

Identifies the Web site at /site1 as a SharePoint site.

Wildcard inclusion

http://server1/sites

/sites

Identifies all sites below the /sites/ path as SharePoint sites.

 

Top-level Web site explicit inclusion

http://server1

/

Indicates an explicit inclusion for the top-level Web site. Only the top-level Web site is a SharePoint site; any sites below the top-level Web site are not.

Top-level Web site wildcard inclusion

http://server1

/*

Indicates a wildcard inclusion for the top level of the virtual server. Every directory under the specified path is a top-level SharePoint site.

Important

Do not use “/*” to indicate wildcard managed sites at the root of the site collection. Using this wildcard prevents a site being created at the root of the Web application. Many SharePoint features rely on having a site collection at the root of the Web application, and if this is missing, these features will not work correctly. For example, Explorer View will not work for a document library.

Web server performance declines linearly with the number of inclusions and exclusions. You can minimize performance impact by using wildcard inclusions rather than many explicit inclusions, and by putting as many excluded applications under the same excluded path as possible.