New-SPAlternateURL

Riferimento

Modulo:: sharepoint-server

Si applica a:: SharePoint Server Subscription Edition

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" -internal

Questo 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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

Share via