Addalternatedomain：Stsadm 操作 (Office SharePoint Server)

操作名称：Addalternatedomain

说明

添加内部 URL，并将其映射到 Web 应用程序或外部资源的五个 URL 区域之一。

此操作与位于 SharePoint 管理中心网站的“备用访问映射”页上的“添加内部 URL”用户界面设置等效。

有关详细信息，请参阅配置备用访问映射。

语法

stsadm -o addalternatedomain

   -url <URL name>

   -incomingurl <http://internal.url>

   -urlzone {Default | Internet | Intranet | Extranet | Custom}

   -resourcename <non-Web application resource name>

参数

参数名	值	是否必需	说明
url	一个有效的 URL，例如 http://server_name 或 http://server_name:1234	否。但是，如果使用 url 参数，则将无法使用 resourcename 参数。	Web 应用程序的 URL。此参数应为分配给一个 Web 应用程序的现有备用访问映射 (AAM) URL，以便 Stsadm 可以确定您所需的 Web 应用程序。URL 可以是公用 URL，也可以是来自与目标 Web 应用程序关联的任何区域的内部 URL。
incomingurl	一个有效的 URL，例如“http://sharepoint.courses.contoso.com:1234”	是	要添加的内部 URL。 此参数应限于 URL 的协议方案、主机名和端口号部分。此参数不应包含 URL 的任何其他部分。您可以将多个内部 URL 映射到同一 URL 区域。
urlzone	以下任一值： Default Intranet Internet Extranet Custom	是	与内部 URL 关联的五个区域之一。
resourcename	一个有效的名称，例如“Resource1”	否。但是必须首先存在一个资源名称才能使用此参数。您可以使用 Addzoneurl 操作来创建一个新资源名。 注意： 如果使用 resourcename 参数，则不能使用 url 参数。 .	指定应将内部 URL 添加到的外部资源。 此参数等效于 SharePoint 管理中心网站的“创建外部资源映射”页上的“外部资源映射”用户界面设置。

备注

可以单独执行每个 Web 应用程序的区域映射。

在 Windows SharePoint Services 2.0 中，内部 URL 称为入站 URL，公用 URL 称为出站 URL。

对于每个 Web 请求，Windows SharePoint Services 3.0 会确定请求的协议、主机标头和端口，并查找先前输入的匹配的内部 URL。如果找到匹配的内部 URL，Windows SharePoint Services 3.0 稍后会确定将使用哪个区域来设置响应中的超链接的格式。一个 URL 区域包含一个公用 URL 和一个或多个内部 URL。

通过备用访问映射，接收到有关内部 URL（在五个身份验证区域之一中）的请求的 Web 应用程序能够返回包含指向该区域的公用 URL 的链接的页面。可以将 Web 应用程序与内部 URL 和公用 URL 之间的映射集合关联。内部 URL 是指 Microsoft Office SharePoint Server 2007 接收的 Web 请求的 URL。公用 URL 是指可从外部访问的网站的 URL。公用 URL 是 Office SharePoint Server 2007 在它返回的页中使用的基 URL。如果反向代理设备已修改内部 URL，则它将与公用 URL 不同。

可以将多个内部 URL 与一个公用 URL 相关联。映射集合最多可以包含五个身份验证区域，但每个区域只能具有一个公用 URL。映射集合与以下身份验证区域对应：

• Default

• Internet

• Intranet

• Extranet

• Custom

有关区域、URL 以及查看每个区域的企业部署方案的更多信息，请参阅 逻辑体系结构模型：企业部署。

以主机命名的网站集不能使用备用访问映射。以主机命名的网站集将会被自动视为在默认区域中，且不得在最终用户和服务器之间修改请求的 URL。

示例

如果反向代理服务器或负载平衡器从用户收到 https://www.contoso.com 形式的请求，并将该请求以 http://sharepoint.courses.contoso.com:1234 的形式转发到运行 Windows SharePoint Services 3.0 的服务器，则管理员将为 SharePoint Web 应用程序配置下面的 URL：

内部 URL：http://sharepoint.courses.contoso.com:1234

公用 URL：https://www.contoso.com

在此示例中，https://sharepoint:1234 已是指定给 Web 应用程序的 AAM URL，并使用了 Internet 区域。

若要配置内部 URL，请使用下面的语法：

stsadm -o addalternatedomain -url https://sharepoint:1234 -urlzone Internet -incomingurl http://sharepoint.courses.contoso.com:1234

若要将公用 URL 映射到 URL 区域，请使用下面的语法：

stsadm -o addzoneurl -url https://sharepoint:1234 -urlzone Internet -zonemappedurl https://www.contoso.com

若要确认对内部 URL 所做的更改，请使用以下语法：

stsadm -o enumalternatedomains -url http://sharepoint.courses.contoso.com:1234

另请参见

概念

Addzoneurl
Deletealternatedomain
Enumalternatedomains