Addzoneurl : opération Stsadm (Windows SharePoint Services)
Mise à jour : 2007-12-13
Nom de l’opération : Addzoneurl
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é équivaut au paramètre d’interface utilisateur URL publiques qui se trouve dans la page Modifier les URL des zones publiques 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 addzoneurl
-url <nom_URL>
-urlzone {Default | Internet | Intranet | Extranet | Custom}
-zonemappedurl <http://public.url>/
-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. Cependant, si le paramètre url est utilisé, le paramètre resourcename ne peut pas l’être. |
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 |
Nom valide, par exemple « 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 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
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 requête 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 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
La zone Default doit toujours contenir une URL publique.
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 qu’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 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