Addzoneurl: operazione di Stsadm (Windows SharePoint Services)
Nome dell'operazione: addzoneurl
Descrizione
Configura l'URL pubblico e ne esegue il mapping a una delle cinque aree URL di un'applicazione Web o di una risorsa esterna.
Questa proprietà è l'equivalente dell'impostazione dell'interfaccia utente URL pubblici presente nella pagina Modifica URL pubblici di area del sito Web Amministrazione centrale SharePoint.
Per ulteriori informazioni, vedere Configurare il mapping di accesso alternativo (Windows SharePoint Services).
Sintassi
stsadm -o addzoneurl
-url <nome URL>
-urlzone {Default | Internet | Intranet | Extranet | Custom}
-zonemappedurl <http://url.pubblico>
-resourcename <nome risorsa applicazione non Web>
Parametri
Nome del parametro |
Valore |
Obbligatorio |
Descrizione |
url |
URL valido, ad esempio http://nome_server o http://nome_server:1234 |
No. Se però viene utilizzato il parametro url, non è possibile utilizzare il parametro resourcename. |
URL dell'applicazione Web. Questo parametro dovrebbe essere un URL con mapping di accesso alternativo esistente assegnato a un'applicazione Web, in modo che Stsadm possa determinare l'applicazione Web di destinazione. L'URL può essere pubblico o interno a qualunque area associata all'applicazione Web di destinazione. |
urlzone |
Uno dei valori seguenti:
|
Sì |
Una delle cinque aree a cui è associato l'URL pubblico. |
zonemappedurl |
URL valido, ad esempio https://www.microsoft.com/it/it/default.aspx |
Sì |
URL pubblico che si desidera aggiungere. Viene utilizzato come URL di base nei collegamenti ipertestuali nelle pagine Web o nei messaggi di posta elettronica provenienti dal server Web per il server proxy inverso o il client. Questo URL corrisponde all'URL raggiungibile dall'utente finale. L'esecuzione di questo passaggio garantisce che all'utente finale verrà visualizzato l'URL corretto quando l'URL viene restituito dal server al client. |
resourcename |
Nome valido, ad esempio "Risorsa1" |
No. Se però viene utilizzato il parametro resourcename, non è possibile utilizzare il parametro url. |
È necessario creare un nuovo nome di risorsa con un URL pubblico nell'area predefinita corrispondente utilizzando l'operazione addzoneurl. Dopo aver creato il nome di risorsa, sarà possibile utilizzare il nome di risorsa esistente per aggiungere gli URL pubblici in altre aree o aggiornare gli URL pubblici esistenti. Questo parametro è l'equivalente dell'impostazione dell'interfaccia utente Mapping risorsa esterna presente nella pagina Crea mapping risorsa esterna del sito Web Amministrazione Centrale SharePoint. |
Osservazioni
In Windows SharePoint Services 2.0 un URL interno è detto URL in ingresso, mentre un URL pubblico è detto URL in uscita.
Per ogni richiesta Web, in Microsoft Windows SharePoint Services 3.0 vengono determinati il protocollo, l'intestazione host e la porta della richiesta e viene cercato un URL interno corrispondente specificato in precedenza. Se viene trovato, in Microsoft Windows SharePoint Services 3.0 viene determinata l'area che verrà utilizzata per formattare i collegamenti ipertestuali nella risposta. Un'area URL contiene un URL pubblico e uno o più URL interni.
I mapping di accesso alternativo consentono a un'applicazione Web che riceve una richiesta per un URL interno in una delle cinque aree di autenticazione di restituire pagine contenenti collegamenti all'URL pubblico dell'area. È possibile associare un'applicazione Web a un insieme di mapping tra gli URL interni e pubblici.
Interno fa riferimento all'URL di una richiesta Web così come è ricevuto da Microsoft Windows SharePoint Services 3.0. Pubblico fa riferimento all'URL di un sito Web accessibile esternamente. L'URL pubblico corrisponde all'URL di base utilizzato da Microsoft Windows SharePoint Services 3.0 nelle pagine restituite.
Se l'URL interno è stato modificato da un dispositivo proxy inverso, può essere diverso dall'URL pubblico.
È possibile associare più URL interni a un solo URL pubblico. Gli insiemi di mapping possono contenere fino a cinque aree di autenticazione, ma ogni area non può essere associata a più di un URL pubblico. Gli insiemi di mapping corrispondono alle aree di autenticazione seguenti:
Predefinita (Default)
Internet
Intranet
Extranet
Personalizzata (Custom)
L'area Predefinita deve sempre contenere un URL pubblico.
Per ulteriori informazioni sulle aree, gli URL e l'architettura logica, vedere Progettare l'architettura logica (Windows SharePoint Services)
Le raccolte siti con nome basato sull'host non possono utilizzare mapping di accesso alternativo. Tali raccolte vengono considerate automaticamente come appartenenti all'area predefinita e l'URL della richiesta non deve essere modificato tra l'utente finale e il server.
Esempi
Se un server proxy inverso o un servizio di bilanciamento del carico riceve una richiesta dall'utente come https://www.contoso.com e la inoltra al server che esegue Microsoft Windows SharePoint Services 3.0 come http://sharepoint.corsi.contoso.com:1234, l'amministratore dovrà configurare gli URL seguenti per un'applicazione Web SharePoint:
URL interno: http://sharepoint.corsi.contoso.com:1234
URL pubblico: https://www.contoso.com
Per questo esempio, https://sharepoint:1234 è già un URL dell'elenco dei mapping di accesso alternativo assegnato a un'applicazione Web e viene utilizzata l'area Internet.
Per impostare l'URL pubblico di un'area URL, utilizzare la sintassi seguente:
stsadm -o addzoneurl -url https://sharepoint:1234 -urlzone Internet -zonemappedurl https://www.contoso.com
Per verificare la modifica apportata all'URL pubblico, utilizzare la sintassi seguente:
stsadm -o enumalternatedomains -url https://sharepoint:1234
Vedere anche
Concetti
Enumalternatedomains
Deletezoneurl
Addalternatedomain
Enumzoneurls