Addzoneurl: operación de Stsadm (Windows SharePoint Services)

  • Artículo

Nombre de la operación: Addzoneurl

Descripción

Configura la dirección URL pública y la asigna a una de las cinco zonas de dirección URL de una aplicación web o recurso externo.

Esta propiedad es equivalente a la opción Direcciones URL públicas de la interfaz de usuario que se encuentra en la página Editar direcciones URL públicas de zona del sitio web de Administración central de SharePoint.

Para obtener más información, vea Configuración de asignaciones de acceso alternativas (Windows SharePoint Services).

Sintaxis

stsadm -o addzoneurl

-url <nombre de dirección URL>

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

-zonemappedurl <http://public.url>

-resourcename <nombre de recurso de la aplicación no web>

Parámetros

Nombre de parámetro

Valor

¿Necesario?

Descripción

url

Una dirección URL válida, como http://nombre_de_servidor o http://nombre_de_servidor:1234

No. Sin embargo, si se usa el parámetro url, no se puede usar el parámetro resourcename.

Dirección URL de la aplicación web. Este parámetro debe ser una dirección URL de asignación de acceso alternativa existente asignada a una aplicación web de forma que Stsadm pueda determinar cuál es la aplicación web de destino. La dirección URL puede ser una dirección URL pública o una dirección URL interna de cualquier zona asociada con la aplicación web de destino.

urlzone

Cualquiera de los siguientes valores:

  • Default

  • Intranet

  • Internet

  • Extranet

  • Custom

Sí

Una de las cinco zonas a las que está asociada la dirección URL pública.

zonemappedurl

Una dirección URL válida, como https://www.contoso.com

Sí

La dirección URL pública que desea agregar. Se usa como dirección URL base utilizada en los hipervínculos de las páginas web o los mensajes de correo electrónico que van del servidor web al servidor proxy inverso o al cliente. Esta dirección URL es la que está accesible para el usuario final. Este paso garantiza que el usuario final vea la dirección URL correcta cuando el servidor devuelve la dirección URL al cliente.

resourcename

Un nombre válido, como "Recurso1"

No. Sin embargo, si se utiliza el parámetro resourcename, no se puede utilizar el parámetro url.

Es necesario crear un nuevo nombre de recurso con una dirección URL pública en su zona predeterminada mediante la operación addzoneurl . Una vez creado el nombre del recurso, puede utilizar el nombre de recurso existente para agregar direcciones URL públicas a otras zonas o actualizar direcciones URL públicas existentes.

Este parámetro es equivalente a la configuración de la interfaz de usuario Asignación a recursos externos que se encuentra en la página Crear asignaciones a recursos externos del sitio web de Administración central de SharePoint.

Comentarios

En Windows SharePoint Services 2.0, una dirección URL interna se conocía como dirección URL entrante y una dirección URL pública se denominaba dirección URL saliente.

Para cada solicitud web, Windows SharePoint Services 3.0 determina el protocolo, el encabezado de host y el puerto de la solicitud y busca la dirección URL interna correspondiente que se especificó anteriormente. Si se encuentra una dirección URL interna coincidente, Windows SharePoint Services 3.0 determina qué zona se utilizará para dar formato a los hipervínculos de la respuesta. Una zona de direcciones URL contiene una dirección URL pública y una o varias direcciones URL internas.

Las asignaciones de acceso alternativas permiten que una aplicación web que recibe una solicitud para una dirección URL interna, en una de las cinco zonas de autenticación, devuelva las páginas con vínculos a la dirección URL pública para la zona. Puede asociar una aplicación web a una colección de asignaciones entre direcciones URL internas y públicas.

Interna hace referencia a la dirección URL de una solicitud web cuando la recibe Windows SharePoint Services 3.0. Pública hace referencia a la dirección URL de un sitio web accesible desde el exterior. La dirección URL pública es la dirección URL base que Windows SharePoint Services 3.0 utiliza en las páginas que devuelve.

Si la dirección URL interna ha sido modificada por un dispositivo de proxy inverso, puede que sea diferente de la dirección URL pública.

Es posible asociar varias direcciones URL internas con una sola dirección URL pública. Las colecciones de asignaciones pueden contener hasta cinco zonas de autenticación, pero cada zona no puede tener más de una dirección URL pública. Las colecciones de asignaciones corresponden a las zonas de autenticación siguientes:

  • Predeterminado

  • Internet

  • Intranet

  • Extranet

  • Personalizada

La zona predeterminada siempre debe contener una dirección URL pública.

Para obtener más información acerca de las zonas, las direcciones URL y la arquitectura lógica, vea Diseño de la arquitectura lógica (Windows SharePoint Services)

Las colecciones de sitios con nombre de host no pueden usar asignaciones de acceso alternativas. De forma automática, se considera que dichas colecciones se encuentran en la zona predeterminada y la dirección URL de la solicitud no puede modificarse entre el usuario final y el servidor.

Ejemplos

Si un servidor proxy inverso o un equilibrador de carga recibe una solicitud del usuario del tipo https://www.contoso.com y la reenvía al servidor en que se ejecuta Windows SharePoint Services 3.0 como http://sharepoint.courses.contoso.com:1234, el administrador configuraría las siguientes direcciones URL para una aplicación web de SharePoint:

Dirección URL interna: http://sharepoint.courses.contoso.com:1234

Dirección URL pública: https://www.contoso.com

Para este ejemplo, https://sharePoint:1234 ya es una dirección URL de asignación de acceso alternativa que se asigna a una aplicación web y se usa la zona de Internet.

Para establecer la dirección URL pública de una zona de URL, utilice la siguiente sintaxis:

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

Para confirmar el cambio a la dirección URL pública, utilice la siguiente sintaxis:

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

Vea también

Conceptos

Enumalternatedomains
Deletezoneurl
Addalternatedomain
Enumzoneurls