Addalternatedomain: Stsadm operations (Windows SharePoint Services)
Applies To: Windows SharePoint Services 3.0
Topic Last Modified: 2009-03-10
Operation name: Addalternatedomain
Description
Adds an internal URL and maps it to one of the five URL zones of a Web application or external resource.
This operation is equivalent to the Add Internal URLs user interface setting that is located on the Alternate Access Mappings page of the SharePoint Central Administration Web site.
For more information, see Configure alternate access mapping (Windows SharePoint Services).
Syntax
stsadm -o addalternatedomain
** -url <URL name>**
** -incomingurl <http://internal.url>**
** -urlzone {Default | Internet | Intranet | Extranet | Custom}**
** -resourcename <non-Web application resource name>**
Parameters
Parameter name |
Value |
Required? |
Description |
url |
A valid URL, such as http://server_name or http://server_name:1234 |
No. However, if the url parameter is used then the resourcename parameter cannot be used. |
URL of the Web application. This parameter should be an existing alternate access mappings (AAM) URL that is assigned to a Web application so that stsadm can determine which Web application you are targeting. The URL can be a public URL or an internal URL from any zone associated with the targeted Web application. |
incomingurl |
A valid URL, such as "http://sharepoint.courses.contoso.com:1234" |
Yes |
The internal URL that you want to add. This parameter should be limited to the protocol scheme, host name, and port number portions of the URL. It should not contain any other portions of an URL. You can map multiple internal URLs to the same URL zone. |
urlzone |
Any one of the following values:
|
Yes |
One of the five zones with which the internal URL is associated. |
resourcename |
A valid name, such as "Resource1" |
No. However, a resource name must already exist before this parameter can be used. You can create a new resource name using the Addzoneurl operation. Note If the resourcename parameter is used, then the url parameter cannot be used. . |
Specifies the external resource which the internal URL should be added to. This parameter is equivalent to the External Resource Mapping user interface setting that is located on the Create External Resource Mapping page of the SharePoint Central Administration Web site. |
Remarks
A separate zone mapping for each Web application can be performed.
In Windows SharePoint Services 2.0, an internal URL was referred to as an incoming URL and a public URL was referred to as an outgoing URL.
For each Web request, Windows SharePoint Services 3.0 determines the protocol, host header, and port of the request and looks for a matching internal URL that was previously entered. If a matching internal URL is found, Windows SharePoint Services 3.0 then determines which zone will be used to format the hyperlinks in the response. A URL zone contains one public URL and one or more internal URLs.
Alternate access mappings enable a Web application that receives a request for an internal URL, in one of the five authentication zones, to return pages that contain links to the public URL for the zone. You can associate a Web application with a collection of mappings between internal and public URLs. Internal refers to the URL of a Web request as it is received by Windows SharePoint Services 3.0. Public refers to the URL of an externally accessible Web site. The public URL is the base URL that Windows SharePoint Services 3.0 uses in the pages that it returns. If the internal URL has been modified by a reverse proxy device, it can differ from the public URL.
Multiple internal URLs can be associated with a single public URL. Mapping collections can contain up to five authentication zones, but each zone can only have a single public URL. Mapping collections correspond to the following authentication zones:
Default
Internet
Intranet
Extranet
Custom
For additional information about zones, URLs, and logical architecture, see the Design logical architecture (Windows SharePoint Services)
Host-named site collections cannot use alternate access mappings. Host-named site collections are automatically considered to be in the Default zone, and the URL of the request must not be modified between the end user and the server.
Examples
If a reverse proxy server or load balancer receives a request from the user as https://www.contoso.com and forwards it to the server running Windows SharePoint Services 3.0 as http://sharepoint.courses.contoso.com:1234, the administrator would configure the following URLs for a SharePoint Web application:
Internal URL: http://sharepoint.courses.contoso.com:1234
Public URL: https://www.contoso.com
For this example, https://sharepoint:1234 is already an AAM URL that is assigned to a Web application and the Internet zone is used.
To configure an internal URL, use the following syntax:
stsadm -o addalternatedomain -url https://sharepoint:1234 -urlzone Internet -incomingurl http://sharepoint.courses.contoso.com:1234
To map the public URL to the URL zone, use the following syntax:
stsadm -o addzoneurl -url https://sharepoint:1234 -urlzone Internet -zonemappedurl https://www.contoso.com
Note
There can be only one public URL per URL zone. This is the URL used in Web pages or e-mail messages going from the Web server to the reverse proxy server or the client.
To confirm the change to the internal URL, use the following syntax:
stsadm -o enumalternatedomains -url http://sharepoint.courses.contoso.com:1234