New-SPWebApplication
Crea una nuova applicazione Web all'interno della farm locale.
Sintassi
New-SPWebApplication
-Name <String>
-ApplicationPool <String>
[-ApplicationPoolAccount <SPProcessAccountPipeBind>]
[-ServiceApplicationProxyGroup <SPServiceApplicationProxyGroupPipeBind>]
[-SecureSocketsLayer]
[-HostHeader <String>]
[-Certificate <SPServerCertificatePipeBind>]
[-UseServerNameIndication]
[-AllowLegacyEncryption]
[-Port <UInt32>]
[-AllowAnonymousAccess]
[-Path <String>]
[-Url <String>]
[-AuthenticationMethod <String>]
[-AuthenticationProvider <SPAuthenticationProviderPipeBind[]>]
[-AdditionalClaimProvider <SPClaimProviderPipeBind[]>]
[-SignInRedirectURL <String>]
[-SignInRedirectProvider <SPTrustedIdentityTokenIssuerPipeBind>]
[-UserSettingsProvider <SPUserSettingsProviderPipeBind>]
[-DatabaseCredentials <PSCredential>]
[-DatabaseServer <String>]
[-DatabaseName <String>]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<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 -SecureSocketsLayerCrea 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 Subscription Edition |
-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 Subscription Edition |
-AllowLegacyEncryption
Specifica che le versioni precedenti del protocollo SSL e TLS e i pacchetti di crittografia possono essere usati con questo sito Web IIS. La crittografia legacy è più debole della crittografia moderna e non è consigliata.
Questa funzionalità richiede Windows Server 2022 o versione successiva. Questa funzionalità non è disponibile quando SharePoint viene distribuito con versioni precedenti di Windows Server.
Questo parametro è valido solo se usato con il parametro SecureSocketsLayer.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 |
-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 Subscription Edition |
-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 Subscription Edition |
-Certificate
Specifica il certificato che verrà usato per l'associazione SSL (Secure Sockets Layer) di questo sito Web IIS. Questo parametro è valido solo se usato con il parametro SecureSocketsLayer.
| Type: | SPServerCertificatePipeBind |
| 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 |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-HostHeader
Specifica l'associazione dell'intestazione host per questo sito Web IIS. Un'associazione di intestazione host consente a più siti Web IIS di condividere lo stesso numero di porta. Le richieste Web inviate a un numero di porta condivisa vengono indirizzate al sito Web IIS corretto in base al valore dell'intestazione host HTTP inviata dal client.
Se non viene specificata alcuna associazione di intestazione host, tutte le richieste Web inviate a questo numero di porta verranno instradate al sito Web IIS, a meno che un altro sito Web IIS non disponga di un'associazione di intestazione host corrispondente all'intestazione host HTTP inviata dal client.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-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 Subscription Edition |
-Path
Specifica la directory fisica per la nuova applicazione Web nella cartella 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 Subscription Edition |
-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 Subscription Edition |
-SecureSocketsLayer
Abilita la crittografia SSL (Secure Sockets Layer) per l'applicazione Web. Se si sceglie di usare SSL, è necessario importare un certificato server in SharePoint e assegnarlo al sito Web IIS per questa applicazione Web. Fino a quando non viene eseguita, l'applicazione Web non sarà accessibile da questo sito Web IIS.
Il valore predefinito è False.
Se questo parametro viene omesso o impostato su False, questa applicazione Web userà HTTP per la porta specificata.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-UseServerNameIndication
Specifica che l'associazione SSL (Secure Sockets Layer) di questo sito Web IIS deve usare l'indicazione del nome del server (SNI). Indicazione nome server consente a più siti Web IIS con intestazioni host univoche e certificati server univoci di condividere la stessa porta SSL. Se l'indicazione del nome del server non viene usata, tutti i siti Web IIS che condividono la stessa porta SSL devono condividere lo stesso certificato server.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |