Addalternatedomain: operaciones de Stsadm (Windows SharePoint Services)
Nombre de la operación: Addalternatedomain
Descripción
Agrega una dirección URL interna y la asigna a una de las cinco zonas de dirección URL de una aplicación web o un recurso externo.
Esta operación equivale a la opción Agregar direcciones URL internas de la interfaz de usuario, que se encuentra en la página Asignaciones de acceso alternativas 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 addalternatedomain
-url <nombre de la dirección URL>
-incomingurl <http://internal.url>
-urlzone {Predeterminada | Internet | Intranet | Extranet | Personalizada}
-resourcename <Nombre de recurso de la aplicación no web>
Parámetros
Nombre de parámetro |
Valor |
¿Obligatorio? |
Descripción |
url |
Una dirección URL válida, como http://nombre_servidor o http://nombre_servidor:1234 |
No. Sin embargo, si se usa el parámetro url, no se podrá usar el parámetro resourcename. |
Dirección URL de la aplicación web. Este parámetro debe ser una dirección URL existente de asignaciones alternativas de acceso (AAM) que se asigna a una aplicación web para que stsadm pueda determinar a qué aplicación web se dirige. La dirección URL puede ser una dirección URL pública o una dirección URL interna de cualquier zona asociada a la aplicación web de destino. |
incomingurl |
Una dirección URL válida, como "http://sharepoint.courses.contoso.com:1234" |
Sí |
La dirección URL interna que desea agregar. Este parámetro debe limitarse a las partes de la dirección URL relativas al esquema de protocolo, el nombre de host y el número de puerto. No debe contener ninguna otra parte de una dirección URL. Puede asignar varias direcciones URL internas a la misma zona URL. |
urlzone |
Cualquiera de los siguientes valores:
|
Sí |
Una de las cinco zonas a las que está asociada la dirección URL interna. |
resourcename |
Un nombre válido, como "Resource1" |
No. Sin embargo, debe existir un nombre de recurso antes de poder usar este parámetro. Puede crear un nombre de recurso nuevo mediante la operación Addzoneurl. Nota Si se usa el parámetro resourcename, el parámetro url no se puede usar. . |
Especifica el recurso externo al que debe agregarse la dirección URL interna. 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
Se puede realizar una asignación de zona independiente para cada aplicación web.
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 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 usará para aplicar 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 de una dirección URL interna, de una de las cinco zonas de autenticación, devuelva páginas que contienen vínculos a la dirección URL pública de la zona. Se puede asociar una aplicación web a una colección de asignaciones entre direcciones URL internas y públicas. Una dirección URL interna es la dirección URL de una solicitud web tal como la recibe Windows SharePoint Services 3.0. La dirección URL pública es la dirección URL de un sitio web al que se puede obtener acceso de forma externa. La dirección URL pública es la dirección URL base que Windows SharePoint Services 3.0 usa 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 asignar varias direcciones URL internas con una sola dirección URL pública. Las colecciones de asignaciones pueden contener un máximo de cinco zonas de autenticación; sin embargo, cada zona sólo puede tener una sola dirección URL pública. Las colecciones de asignaciones corresponden a las zonas de autenticación siguientes:
Predeterminado
Internet
Intranet
Extranet
Personalizado
Para obtener información adicional 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 alternativas de acceso. 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 AAM que se asigna a una aplicación web y se usa la zona de Internet.
Para configurar una dirección URL interna, use la sintaxis siguiente:
stsadm -o addalternatedomain -url https://sharepoint:1234 -urlzone Internet -incomingurl http://sharepoint.courses.contoso.com:1234
Para asignar la dirección URL pública a la zona de la dirección URL, use la siguiente sintaxis:
stsadm -o addzoneurl -url https://sharepoint:1234 -urlzone Internet -zonemappedurl https://www.contoso.com
Nota
Sólo puede haber una dirección URL pública por zona de dirección URL. Ésta es la dirección URL que se usa en las páginas web o los mensajes de correo electrónico que van desde el servidor web al servidor proxy inverso o el cliente.
Para confirmar el cambio a la dirección URL interna, use la sintaxis siguiente:
stsadm -o enumalternatedomains -url http://sharepoint.courses.contoso.com:1234