New-SPAlternateURL
Crea un nuovo URL pubblico o interno per l'area o la risorsa dell'applicazione Web specificata.
Sintassi
New-SPAlternateURL
[-Url] <String>
-WebApplication <SPWebApplicationPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Internal]
[-WhatIf]
[-Zone <SPUrlZone>]
[<CommonParameters>]New-SPAlternateURL
[-Url] <String>
-ResourceName <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Internal]
[-WhatIf]
[-Zone <SPUrlZone>]
[<CommonParameters>]Descrizione
Questo cmdlet include più set di parametri. È possibile utilizzare solo i parametri di un set di parametri e non è possibile combinare parametri appartenenti a set di parametri diversi. Per altre informazioni su come usare i set di parametri, vedere Set di parametri del cmdlet.
Il cmdlet New-SPAlternateUrl crea un nuovo URL pubblico o interno per l'area o la risorsa dell'applicazione Web specificata. Utilizzare il parametro ResourceName se l'URL alternativo deve essere creato per una risorsa esterna.
Ogni applicazione Web può essere associata a un insieme di mapping tra gli URL interni e pubblici. Sia gli URL interni che gli URL pubblici sono costituiti dalla parte del protocollo e del dominio dell'URL completo; Ad esempio, https://www.fabrikam.com. Gli utenti digitano un URL pubblico per accedere al sito di SharePoint e tale URL viene visualizzato nei collegamenti nelle pagine. Gli URL interni sono inclusi nelle richieste di URL inviate al sito di SharePoint. Molti URL interni possono essere associati a un singolo URL pubblico in farm multiserver; Ad esempio, quando un servizio di bilanciamento del carico instrada le richieste a indirizzi IP specifici a vari server nel cluster di bilanciamento del carico.
Ogni applicazione Web supporta cinque insiemi di mapping per URL, che corrispondono a cinque aree: area predefinita, Intranet, Extranet, Internet e area personalizzata. Quando l'applicazione Web riceve la richiesta di un URL interno in un'area particolare, i collegamenti alle pagine restituite all'utente includono l'URL pubblico per tale area.
Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.
Esempio
------------------ESEMPIO-----------------------
#create the public URL
New-SPAlternateURL https://www.contoso.com -Zone "Internet"
#create the internal URL
New-SPAlternateURL https://sharepoint.contoso.com -Zone "Internet" -internalQuesto esempio converte le richieste in ingresso per https://www.contoso.com in https://sharepoint.contoso.com (nell'area Internet).
Quando si imposta un proxy inverso per gestire la terminazione SSL di URL pubblici, è necessario configurare mapping di accesso alternativo per gestire la conversione degli URL.
Parametri
-AssignmentCollection
Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.
Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.
| Type: | SPAssignmentCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Confirm
Richiede la conferma prima di eseguire il comando.
Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Internal
Imposta questo URL alternativo come URL interno. Se non si specifica questo parametro, l'URL sarà pubblico.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-ResourceName
Specifica il nome della risorsa, se l'URL alternativo viene creato per una risorsa esterna. Se non si specifica alcun valore, questo valore viene lasciato vuoto.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Url
Specifica l'URL pubblico utilizzato dagli utenti per accedere all'applicazione Web.
Il tipo deve essere un URL valido nel formato https://server_name.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-WebApplication
Specifica il nome, l'URL o il GUID dell'applicazione Web per cui creare il mapping.
Il tipo deve essere un nome valido nel formato ApplicazioneWeb-1212, un URL nel formato https://server_name oppure un GUID nel formato 1234-5678-9876-0987.
| Type: | SPWebApplicationPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-WhatIf
Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando.
Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Zone
Specifica una delle cinque aree a cui è associato l'URL alternativo.
Il tipo deve essere un'area valida, ovvero Default, Intranet, Internet, Extranet o Custom
| Type: | SPUrlZone |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |