Define managed paths (SharePoint Foundation 2010)

 

Applies to: SharePoint Foundation 2010

By defining managed paths, you can specify which paths in the URL namespace of a Web application are used for site collections. You can specify that one or more site collections exists at a specified path. This can be a convenient method of consolidating multiple site access for users in various departments.

An explicitly named path (for example, https://server/sites/team) is used for a single site collection. A wildcard path of "sites" (for example, https://server/sites/) indicates that child URLs of the path are site collections.

Important

Do not use “/*” to indicate wildcard managed sites at the root of the site collection. Using this wildcard prevents a site from being created at the root of the Web application, which is required for some Microsoft SharePoint Foundation 2010 features to work.

In this article:

Define managed paths for a Web application by using Central Administration

Use the procedures described here to add or delete managed paths for a Web application by using Central Administration.

To add a managed path by using Central Administration

  1. Verify that the user account that is performing this task is a member of the Farm Administrators SharePoint group.

  2. On the SharePoint Central Administration Web site, click Application Management.

  3. On the Application Management page, click Manage Web Applications.

  4. Click the Web application for which you want to manage paths. The ribbon becomes active.

  5. On the ribbon, click Managed Paths.

  6. On the Define Managed Paths page, in the Add a New Path section, type the path to include.

  7. Click Check URL to confirm the path name.

  8. Use the Type dropdown menu to identify the path as either Wildcard inclusion or Explicit inclusion. The Wildcard inclusion type includes all paths that are subordinate to the specified path. The Explicit inclusion type includes only the site that is indicated by the specified path. Sites subordinate to the specified path are not included.

  9. Click Add Path.

  10. When you have finished adding paths, click OK.

To remove a managed path by using Central Administration:

  1. Verify that the user account that is performing this task is a member of the Farm Administrators SharePoint group.

  2. On the SharePoint Central Administration Web site, click Application Management.

  3. On the Application Management page, click Manage Web Applications.

  4. Click the Web application for which you want to manage paths. The ribbon becomes active.

  5. On the ribbon, click Managed Paths.

  6. On the Define Managed Paths page, in the Included Paths section, click the check box next to the path that you want to remove.

  7. Click Delete selected paths.

    Warning

    Be sure that you want to remove the selected path before performing this action. You will have no additional opportunity to confirm. Deletion is immediate.

  8. When you have finished removing paths, click OK.

Define managed paths for a Web application by using Windows Powershell

You can use the New-SPManagedPath cmdlet to add managed paths for a Web application. You can use the Remove-SPManagedPath cmdlet to remove managed paths from a Web application.

The New-SPManagedPath cmdlet adds a new managed path to a given Web application or for use with all host header site collections. If the HostHeader switch is provided, the managed path is shared among all host header site collections; otherwise, you must specify a Web application in which to create this managed path. The relative URL is a partial URL that represents the managed path. When the slash mark (/) is used, the root is defined. If the Explicit parameter is not provided, the new managed path is a wildcard path.

To add a managed path by using Windows PowerShell

  1. Verify that you meet the following minimum requirements: See Add-SPShellAdmin.

  2. On the Start menu, click All Programs.

  3. Click Microsoft SharePoint 2010 Products.

  4. Click SharePoint 2010 Management Shell.

  5. At the Windows PowerShell command prompt, type the following command:

    New-SPManagedPath [-RelativeURL] "</RelativeURL>" -WebApplication <WebApplication>
    

    Where:

    • </RelativeURL> is the relative URL for the new managed path. The type must be a valid partial URL, such as site or sites/teams/.

    • <WebApplication> is the Web application group to add this path.

For more information, see New-SPManagedPath.

To remove a managed path by using Windows PowerShell

  1. Verify that you meet the following minimum requirements: See Add-SPShellAdmin.

  2. On the Start menu, click All Programs.

  3. Click Microsoft SharePoint 2010 Products.

  4. Click SharePoint 2010 Management Shell.

  5. At the Windows PowerShell command prompt, type the following command:.

    Remove-SPManagedPath [-Identity] <ManagedPathName> -WebApplication <WebApplication>
    

    Where:

    • <ManagedPathName> is the name of the managed path to delete.

    • <WebApplication> is the identity of the Web application that hosts the managed path to delete.

    You are prompted to confirm the deletion.

For more information, see Remove-SPManagedPath.

We recommend that you use Windows PowerShell when performing command-line administrative tasks. The Stsadm command-line tool has been deprecated, but is included to support compatibility with previous product versions.

See Also

Reference

Get-SPManagedPath

Concepts

Plan for collaboration sites (SharePoint Foundation 2010)