New-SPWebApplication

Riferimento

Modulo:: SharePointServer

Si applica a:: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Crea una nuova applicazione Web all'interno della farm locale.

Sintassi

New-SPWebApplication
   -ApplicationPool <String>
   -Name <String>
   [-AdditionalClaimProvider <SPClaimProviderPipeBind[]>]
   [-AllowAnonymousAccess]
   [-ApplicationPoolAccount <SPProcessAccountPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-AuthenticationMethod <String>]
   [-AuthenticationProvider <SPAuthenticationProviderPipeBind[]>]
   [-Confirm]
   [-DatabaseCredentials <PSCredential>]
   [-DatabaseName <String>]
   [-DatabaseServer <String>]
   [-HostHeader <String>]
   [-Path <String>]
   [-Port <UInt32>]
   [-SecureSocketsLayer]
   [-ServiceApplicationProxyGroup <SPServiceApplicationProxyGroupPipeBind>]
   [-SignInRedirectProvider <SPTrustedIdentityTokenIssuerPipeBind>]
   [-SignInRedirectURL <String>]
   [-Url <String>]
   [-UserSettingsProvider <SPUserSettingsProviderPipeBind>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

Crea una nuova applicazione Web specificata dal parametro Name. L'utente specificato dal parametro DatabaseCredentials deve essere membro del ruolo predefinito del server dbcreator nel server di database.

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 1-----------------------

New-SPWebApplication -Name "Contoso Internet Site" -Port 80 -HostHeader sharepoint.contoso.com -URL "http://www.contoso.com" -ApplicationPool "ContosoAppPool" -ApplicationPoolAccount (Get-SPManagedAccount "DOMAIN\wa")

In questo esempio viene creata una nuova applicazione Web usando un'intestazione host interna di sharepoint.contoso.com e un URL pubblico di http://www.contoso.com.

------------------ESEMPIO 2-----------------------

New-SPWebApplication -Name "Contoso Internet Site" -Port 443 -SecureSocketsLayer -HostHeader sharepoint.contoso.com -URL "https://www.contoso.com:443" -ApplicationPool "ContosoAppPool" -ApplicationPoolAccount (Get-SPManagedAccount "DOMAIN\wa")

In questo esempio viene creata una nuova applicazione Web abilitata per SSL usando un'intestazione host interna di sharepoint.contoso.com e un URL pubblico di https://www.contoso.com.

------------------ESEMPIO 3-----------------------

$ap = New-SPAuthenticationProvider
New-SPWebApplication -Name "Contoso Internet Site" -URL "https://www.contoso.com"  -Port 443 
-ApplicationPool "ContosoAppPool" 
-ApplicationPoolAccount (Get-SPManagedAccount "DOMAIN\wa") 
-AuthenticationProvider $ap -SecureSocketsLayer

Crea un'applicazione Web Attestazioni Windows nell'URL https://www.contoso.com usando il dominio dell'account di dominio\wa.

Parametri

-AdditionalClaimProvider

Aggiunge un provider di attestazioni specifico all'applicazione Web definita.

Type:	SPClaimProviderPipeBind[]
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

-AllowAnonymousAccess

Consente l'accesso anonimo all'applicazione Web.

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

-ApplicationPool

Specifica il nome di un pool di applicazioni da usare; Ad esempio, SharePoint - 1213. Se non esiste un pool di applicazioni con il nome indicato, sarà necessario specificare il parametro ApplicationPoolAccount in modo che venga creato un nuovo pool di applicazioni. Se non si specifica un valore, verrà utilizzato il pool di applicazioni predefinito.

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

-ApplicationPoolAccount

Specifica l'account utente che verrà utilizzato per l'esecuzione del pool di applicazioni. Usare il Get-SPIisWebServicApplicationPool cmdlet per usare un account di sistema.

Type:	SPProcessAccountPipeBind
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

-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

-AuthenticationMethod

Utilizza Kerberos o NTLM per specificare il metodo di autenticazione. Se non si specifica alcun valore, verrà applicato il metodo NTLM predefinito.

Type:	String
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

-AuthenticationProvider

Specifica uno o più provider di autenticazione applicabili a un'applicazione Web.

Type:	SPAuthenticationProviderPipeBind[]
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

-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

-DatabaseCredentials

Specifica l'oggetto Credential di Windows PowerShell per l'account utente di database.

Type:	PSCredential
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

-DatabaseName

Specifica il nome del database del contenuto iniziale per la nuova applicazione Web.

Il tipo deve essere un nome di database valido, ad esempio DBContenuto1. Se non viene specificato alcun valore, viene generato automaticamente un valore nel formato WSS_Content_<GUID> .

Type:	String
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

-DatabaseServer

Specifica il nome del server di database. Il tipo deve essere un nome del server di database valido, nel formato SQL1; dove vengono usate istanze denominate, il formato può essere visualizzato come server\server. Se non viene specificato un valore, viene usata l'istanza predefinita di SQL Server.

Type:	String
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

-HostHeader

Specifica un URL valido assegnato all'applicazione Web che deve essere correlato alla configurazione del mapping di accesso alternativo, nel formato nome_server.

Quando il parametro HostHeader è presente, il valore di questo campo corrisponde all'URL interno dell'applicazione Web. Il parametro Url viene usato per specificare l'URL pubblico. Se non viene specificato alcun valore, il valore viene lasciato vuoto.

Type:	String
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

-Name

Specifica il nome della nuova applicazione Web.

Type:	String
Position:	Named
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

-Path

Specifica la directory fisica per la nuova applicazione Web nella cartella delle directory virtuali. Il tipo è un percorso valido nel formato C:\Inetpub\wwwroot\ApplicazioneWeb. Se non viene specificato alcun valore, viene applicato il valore %wwwroot%\wss\VirtualDirectories\<portnumber> .

Type:	String
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

-Port

Specifica la porta su cui è possibile accedere all'applicazione Web. Può essere qualsiasi numero di porta valido. Se non si specifica alcuna porta, verrà generato automaticamente un numero di porta non in conflitto.

Se si specifica un numero di porta già assegnato, IIS non avvierà il nuovo sito fino a quando non si cambia il numero di porta del nuovo sito o quello del sito precedente.

Type:	UInt32
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

-SecureSocketsLayer

Abilita la crittografia SSL (Secure Sockets Layer) per l'applicazione Web. Se si sceglie SSL, sarà necessario aggiungere il certificato in ogni server tramite gli strumenti di amministrazione di IIS. L'applicazione Web non sarà accessibile dal sito Web IIS fino a quando non viene completata questa operazione.

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

-ServiceApplicationProxyGroup

Specifica il gruppo di proxy personalizzato per le applicazioni di servizio che l'applicazione Web dovrà utilizzare. L'applicazione Web utilizzerà i proxy di tale gruppo per connettersi alle applicazioni di servizio. Se non si specifica questo parametro, verrà utilizzato il gruppo di proxy predefinito per la farm.

Type:	SPServiceApplicationProxyGroupPipeBind
Aliases:	ProxyGroup
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

-SignInRedirectProvider

Imposta l'URL di reindirizzamento pagina di accesso in modo che punti all'URL definito nel provider di autenticazione specificato.

Type:	SPTrustedIdentityTokenIssuerPipeBind
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

-SignInRedirectURL

Specifica l'URL di reindirizzamento pagina di accesso per l'applicazione Web.

Type:	String
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

-Url

Specifica l'URL con bilanciamento del carico per l'applicazione Web.

Type:	String
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

-UserSettingsProvider

Fornisce l'accesso al provider di impostazioni utente esterno.

Type:	SPUserSettingsProviderPipeBind
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

-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