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:

Default

Intranet

Internet

Extranet

Custom

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:

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.