Addalternatedomain : opération Stsadm (Windows SharePoint Services)

Article
05/17/2012

Mise à jour : 2007-12-13

Nom de l’opération : Addalternatedomain

Description

Ajoute une URL interne et la mappe à l’une des cinq zones d’URL d’une application Web ou ressource externe.

Cette opération est équivalente au paramètre d’interface utilisateur Ajouter des URL internes qui se trouve sur la page Mappages des accès de substitution du site Web Administration centrale de SharePoint.

Pour plus d’informations, voir Configurer le mappage des accès de substitution (Windows SharePoint Services).

Syntaxe

stsadm -o addalternatedomain

-url <nom_URL>

-incomingurl <http://interne.url>

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

-resourcename <nom de ressource d’application non-Web>

Paramètres

Nom du paramètre	Valeur	Obligatoire ?	Description
url	URL valide, par exemple http://nom_serveur ou http://nom_serveur:1234	Non. Toutefois, si le paramètre url est utilisé, le paramètre resourcename ne peut pas être utilisé.	URL de l’application Web. Ce paramètre doit être une URL des mappages des accès de substitution, qui est attribuée à une application Web de sorte que stsadm puisse déterminer l’application Web ciblée. L’URL peut être une URL publique ou une URL interne de n’importe quelle zone associée à l’application Web ciblée.
incomingurl	URL valide, par exemple « http://sharepoint.courses.contoso.com:1234/ »	Oui	URL interne que vous voulez ajouter. Ce paramètre doit être limité aux parties de l’URL relatives au modèle de protocole, au nom d’hôte et au numéro de port. Il ne doit pas contenir les autres parties d’une URL. Vous pouvez mapper plusieurs URL internes à la même zone d’URL.
urlzone	Une des valeurs suivantes : Default Intranet Internet Extranet Custom	Oui	Une des cinq zones auxquelles l’URL interne est associée.
resourcename	Nom valide, par exemple « Ressource1 »	Non. Toutefois, un nom de ressource doit déjà exister pour que ce paramètre puisse être utilisé. Vous pouvez créer un nom de ressource à l’aide de l’opération Addzoneurl. Notes Si le paramètre resourcename est utilisé, le paramètre url ne peut pas être utilisé. .	Spécifie la ressource externe à laquelle l’URL interne doit être ajoutée. Ce paramètre est équivalent au paramètre d’interface utilisateur Mappage des ressources externes qui se trouve sur la page Créer un mappage des ressources externes du site Web Administration centrale de SharePoint.

Notes

Un mappage de zone distinct peut être effectué pour chaque application Web.

Dans Windows SharePoint Services 2.0, une URL interne était appelée une URL entrante et une URL publique était appelée une URL sortante.

Pour chaque demande Web, Windows SharePoint Services 3.0détermine le protocole, l’en-tête d’hôte et le port de la demande, puis il recherche une URL interne correspondante ayant été précédemment entrée. Si une URL interne correspondante est trouvée, Windows SharePoint Services 3.0 détermine ensuite la zone à utiliser pour mettre en forme les liens hypertexte de la réponse. Une zone d’URL contient une URL publique et une ou plusieurs URL internes.

Les mappages des accès de substitution permettent à une application Web qui reçoit une demande pour une URL interne, dans l’une des cinq zones d’authentification, de renvoyer les pages contenant des liens vers l’URL publique de la zone. Vous pouvez associer une application Web à une collection de mappages entre des URL internes et publiques. Interne fait référence à l’URL d’une demande Web, telle qu’elle est reçue par Windows SharePoint Services 3.0. Publique se rapporte à l’URL d’un site Web accessible en externe. L’URL publique est l’URL de base utilisée par Windows SharePoint Services 3.0 dans les pages qu’il renvoie. Si l’URL interne a été modifiée par un périphérique proxy inverse, elle peut être différente de l’URL publique.

Plusieurs URL internes peuvent être associées à une seule URL publique. Les collections de mappages peuvent contenir jusqu’à cinq zones d’authentification, mais chaque zone ne peut contenir qu’une seule URL publique. Les collections de mappages correspondent aux zones d’authentification suivantes :

Default
Internet
Intranet
Extranet
Custom

Pour plus d’informations sur les zones, les URL et l’architecture logique, voir Concevoir l’architecture logique (Windows SharePoint Services)

Les collections de sites nommées par l’hôte ne peuvent pas utiliser les mappages des accès de substitution. Elles sont automatiquement considérées comme étant dans la zone Par défaut, et l’URL de la demande ne doit pas être modifiée entre l’utilisateur final et le serveur.

Exemples

Si un serveur proxy inverse ou un équilibrage de charge reçoit une demande de l’utilisateur sous la forme https://technet.microsoft.com/fr-fr/library/cc706993.aspx et s’il la transmet au serveur exécutant Windows SharePoint Services 3.0 sous la forme http://sharepoint.courses.contoso.com:1234/, l’administrateur doit configurer les URL suivantes pour une application Web SharePoint :

URL interne : http://sharepoint.courses.contoso.com:1234/

URL publique : https://technet.microsoft.com/fr-fr/library/cc706993.aspx

Pour cet exemple, https://sharepoint:1234/ est déjà une URL des mappages des accès de substitution attribuée à une application Web ; en outre, la zone Internet est utilisée.

Pour configurer une URL interne, utilisez la syntaxe suivante :

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

Pour mapper l’URL publique à la zone d’URL, utilisez la syntaxe suivante :

stsadm -o addzoneurl -url https://sharepoint:1234/ -urlzone Internet -zonemappedurl https://technet.microsoft.com/fr-fr/library/cc706993.aspx

Remarque :
Il ne peut y avoir qu’une seule URL publique par zone d’URL. Il s’agit de l’URL utilisée dans les pages Web ou les messages électroniques provenant du serveur Web et destinés au serveur proxy inverse ou au client.