Addzoneurl : opération Stsadm (Office SharePoint Server)
Mise à jour : 2007-12-13
Description
Configure l’URL publique et la mappe à l’une des cinq zones d’URL d’une application Web ou d’une ressource externe.
Cette propriété est équivalente au paramètre de l’interface utilisateur URL publiques qui se trouve sur la page Modifier les URL publiques du site Web Administration centrale de SharePoint.
Pour plus d’informations, voir Configurer le mappage des accès de substitution.
Syntaxe
stsadm -o addzoneurl
-url <URL>
-urlzone {Default | Internet | Intranet | Extranet | Custom}
-zonemappedurl <http://public.url>/
-resourcename <nom de ressource qui n’appartient pas à l’application Web>
Paramètres
Nom du paramètre |
Valeur |
Requis ? |
Description |
url |
Une URL valide, telle que 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 de mappage des accès de substitution existante qui est attribuée à une application Web de sorte que Stsadm puisse déterminer quelle application Web vous ciblez. L’URL peut être une URL publique ou une URL interne de n’importe quelle zone associée à l’application Web ciblée. |
urlzone |
Une des valeurs suivantes :
|
Oui |
Une des cinq zones à laquelle l’URL publique est associée. |
zonemappedurl |
Une URL valide, par exemple https://www.microsoft.com/fr/fr/default.aspx |
Oui |
L’URL publique que vous souhaitez ajouter. Elle est utilisée comme l’URL de base dans les liens hypertexte sur les pages Web ou des messages électroniques allant du serveur Web au serveur proxy inverse ou au client. Cette URL est celle qui est accessible par l’utilisateur final. Cette étape garantit que l’utilisateur final voit l’URL correcte lorsque l’URL est retournée du serveur au client. |
resourcename |
Un nom valide, tel que « Ressource1 » |
Non. Toutefois, si le paramètre resourcename est utilisé, le paramètre url ne peut pas être utilisé. |
Un nouveau nom de ressource avec une URL publique dans sa zone par défaut doit être créé à l’aide de l’opération addzoneurl. Une fois que le nom de la ressource est créé, vous pouvez utiliser le nom de la ressource existante pour ajouter les URL publiques dans des zones supplémentaires ou mettre à jour des URL publiques existantes. Ce paramètre est équivalent au paramètre de l’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
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.0 détermine le protocole, l’en-tête d’hôte et le port de la demande et recherche une URL interne correspondante qui a été précédemment entrée. S’il existe une URL interne correspondante, Windows SharePoint Services 3.0 détermine ensuite la zone à utiliser pour mettre en forme les liens hypertexte dans la réponse. Une zone 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 Microsoft Office SharePoint Server 2007. Publique se rapporte à l’URL d’un site Web accessible en externe. L’URL publique est l’URL de base utilisée par Office SharePoint Server 2007 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 :
Par défaut
Internet
Intranet
Extranet
Personnalisée
La zone par défaut doit toujours contenir une URL publique.
Pour plus d’informations sur les zones, les URL et pour afficher un scénario de déploiement en entreprise de chaque zone, voir Modèle d’architecture logique : déploiement d’entreprise.
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 équilibreur de charge reçoit une demande de l’utilisateur en tant que https://technet.microsoft.com/fr-fr/library/cc706993.aspx et la transmet au serveur exécutant Windows SharePoint Services 3.0 en tant que 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
Dans cet exemple, https://sharepoint:1234/ est une URL de mappage des accès de substitution déjà attribuée à une application Web et la zone Internet utilisées.
Pour définir l’URL publique d’une zone URL, utilisez la syntaxe suivante :
stsadm -o addzoneurl -url https://sharepoint:1234/ -urlzone Internet -zonemappedurl https://technet.microsoft.com/fr-fr/library/cc706993.aspx
Pour confirmer la modification de l’URL publique, utilisez la syntaxe suivante :
stsadm -o enumalternatedomains -url https://sharepoint:1234/
Voir aussi
Concepts
Enumalternatedomains
Deletezoneurl
Addalternatedomain
Enumzoneurls