TechNet
Export (0) Print
Expand All

Define managed paths (SharePoint Server 2010)

 

Applies to: SharePoint Foundation 2010, SharePoint Server 2010

Topic Last Modified: 2016-05-11

You can specify the paths in the URL namespace of a web application to use for site collections. This is known as a managed path. You can specify that one or more site collections exist at a specified path.

There are two types of managed paths that you can create:

  • A wildcard inclusion allows you to append multiple site collections to the path that you specify. For example, if you add /engineering as a wildcard inclusion off of your root site of http://contoso, then you'll be able to create multiple site collections off of http://contoso/engineering.

  • An explicit inclusion allows you to create a single site collection with the specified address. For example, if you add /finance as an explicit inclusion off of your root site of http://contoso, then you'll be able to create a single site collection with the address http://contoso/finance.

Note that the root of a web application is automatically included as an explicit inclusion. Changing the root to a wildcard inclusion is not supported.

In this article:

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.

    warningWarning
    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.

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.

noteNote
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.
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.

noteNote
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.

Show:
© 2016 Microsoft