Enumalternatedomains: Stsadm operation (Windows SharePoint Services)
Applies To: Windows SharePoint Services 3.0
Topic Last Modified: 2007-12-11
Operation name: Enumalternatedomains
Description
Lists the internal URLs and specifies the URL zones and public URLs to which they are mapped.
This property is equivalent to the Alternate Access Mappings page of the SharePoint Central Administration Web site.
For more information, see Configure alternate access mapping.
Syntax
stsadm -o enumalternatedomains
** -url <URL name>**
** -resourcename <non-Web application name>**
Parameters
Parameter name |
Value |
Required? |
Description |
url |
A valid URL, such as http://server_name or https://sharepoint:1234 |
No. However, if the url or resourcename parameters are not specified, the result is the public alternate access mappings (AAM) URLs for all of the Web applications and external resources in your farm are returned. If the url parameter is specified, the result is the public AAM URLs for the Web application that is specified. Note If the url parameter is used, then the resourcename parameter cannot be used. |
URL of the Web application. This parameter should be an existing 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. |
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. |
Outputs the AAM information for the external resource you specify. |
Remarks
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.
The enumalternatedomains operation is especially useful when a support engineer needs to troubleshoot an AAM issue but does not have immediate access to your farm to view the settings. When the enumalternatedomains operation is run without any parameters, the result is a list of all the Web applications, external resources, and zones in your farm. It clearly identifies the public and internal URLs and the zones to which they are mapped. You can redirect the output to a text file by using the following command:
stsadm -o enumalternatedomains > C:\foldername\output.txt
Once the text file is created, you can send this file to the support engineer for them to review.
Examples
If you want display AAM information for all Web applications and external resources, such as which zones are in use, the public URL for those zones, and the internal URLs in those zones, use the following syntax:
stsadm -o enumalternatedomains
If you want to display AAM information for a specific Web application, such as which zones are in use, the public URL for those zones, and the internal URLs in those zones, use the following syntax:
stsadm -o enumalternatedomains -url https://www.contoso.com
See Also
Concepts
Addzoneurl
Deletealternatedomain
Deletezoneurl
Addalternatedomain
Enumzoneurls