Addzoneurl：Stsadm 操作 (Office SharePoint Server)

  • 项目

说明

配置公用 URL 并将其映射到 Web 应用程序或外部资源的五个 URL 区域之一。

此属性相当于位于 SharePoint 管理中心网站的“编辑公用区域 URL”页上的“公用 URL”用户界面设置。

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

语法

stsadm -o addzoneurl

   -url <URL name>

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

   -zonemappedurl <http://public.url>

   -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。

urlzone

以下任一值：

  • Default

  • Intranet

  • Internet

  • Extranet

  • Custom

是

公用 URL 相关联的五个区域之一。

zonemappedurl

一个有效的 URL，例如 https://www.contoso.com

是

要添加的公用 URL。此公用 URL 用作在从 Web 服务器发送到反向代理服务器或客户端的网页或电子邮件上的超链接中使用的基 URL。此 URL 是最终用户可以到达的 URL。此步骤可确保最终用户在 URL 从服务器返回到客户端时看到正确的 URL。

resourcename

一个有效的名称，例如“Resource1”

否。但是，如果使用 resourcename 参数，则不能使用 url 参数。

需要使用 addzoneurl 操作创建一个新资源名称，并且其默认区域中包含一个公用 URL。一旦创建此资源名称，就可以使用现有资源名称向其他区域添加公用 URL 并更新现有公用 URL。

此参数等效于 SharePoint 管理中心网站的“创建外部资源映射”页上的“外部资源映射”用户界面设置。

备注

在 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。映射集合与以下身份验证区域对应：

  • 默认

  • Internet

  • Intranet

  • Extranet

  • 自定义

默认区域必须始终包含一个公用 URL。

有关区域、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 区域的公用 URL，请使用以下语法：

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

若要确认对公用 URL 的更改，请使用以下语法：

stsadm -o enumalternatedomains -url https://sharepoint:1234

另请参见

概念

Enumalternatedomains
Deletezoneurl
Addalternatedomain
Enumzoneurls