Set-SPWebApplication
Configura l'applicazione Web specificata.
Sintassi
Set-SPWebApplication
[-Identity] <SPWebApplicationPipeBind>
[-DefaultTimeZone <Int32>]
[-DefaultQuotaTemplate <String>]
[-ServiceApplicationProxyGroup <SPServiceApplicationProxyGroupPipeBind>]
[-NotProvisionGlobally]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-SPWebApplication
[-Identity] <SPWebApplicationPipeBind>
-Zone <SPUrlZone>
[-AuthenticationProvider <SPAuthenticationProviderPipeBind[]>]
[-AdditionalClaimProvider <SPClaimProviderPipeBind[]>]
[-SignInRedirectURL <String>]
[-SignInRedirectProvider <SPTrustedIdentityTokenIssuerPipeBind>]
[-AuthenticationMethod <String>]
[-Force]
[-NotProvisionGlobally]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-SPWebApplication
[-Identity] <SPWebApplicationPipeBind>
-Zone <SPUrlZone>
[-SecureSocketsLayer]
[-HostHeader <String>]
[-Certificate <SPServerCertificatePipeBind>]
[-UseServerNameIndication]
[-AllowLegacyEncryption]
-Port <Int32>
[-Url <String>]
[-NotProvisionGlobally]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-SPWebApplication
[-Identity] <SPWebApplicationPipeBind>
-SMTPServer <String>
[-SMTPServerPort <Int32>]
[-OutgoingEmailAddress <String>]
[-ReplyToEmailAddress <String>]
[-SMTPCredentials <PSCredential>]
[-DisableSMTPEncryption]
[-Certificate <SPServerCertificatePipeBind>]
[-NotProvisionGlobally]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<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 Set-SPWebApplication cmdlet configura l'applicazione Web specificata dal parametro Identity.
Per qualsiasi impostazione specifica dell'area (per il parametro Zone impostato), è necessario specificare la zona da configurare.
La zona specificata deve essere già esistente.
Tutte le impostazioni di associazione IIS devono essere specificate di nuovo durante l'aggiornamento dell'associazione di un sito Web IIS tramite il Set-SPWebApplication cmdlet . Sono inclusi l'URL, l'impostazione del livello secure sockets, il numero di porta, l'intestazione host e il certificato. Se un'impostazione di associazione non viene specificata di nuovo, verrà ripristinato il valore predefinito.
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
$credentials = Get-Credential
Set-SPWebApplication -Identity http://servername -SMTPServer mail.example.com -SMTPServerPort 587 -OutgoingEmailAddress user@example.com -ReplyToAddress replyto@example.com -SMTPCredentials $credentialsIn questo esempio l'applicazione http://servername Web viene impostata in modo da utilizzare il server SMTP mail.example.com, la porta del server SMTP 587, l'indirizzo user@example.comdi origine , l'indirizzo replyto@example.comdi risposta e le credenziali archiviate nell'oggetto $credentials.
ESEMPIO 2
Set-SPWebApplication -Identity http://servername -SMTPServer mail.example.com -OutgoingEmailAddress user@example.com -ReplyToAddress replyto@example.com -SMTPCredentials $nullIn questo esempio viene impostata l'applicazione http://servername Web in modo che usi il server SMTP mail.example.com, la porta del server SMTP predefinita, l'indirizzo user@example.comda , l'indirizzo replyto@example.comdi risposta e per connettersi al server SMTP in modo anonimo.
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 |
-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 |
-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
Usare per impostare un'applicazione Web su autenticazione di Windows classica. I valori validi sono NTLM o Kerberos.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-AuthenticationProvider
Definisce i provider di autenticazione che si applicano all'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 o per l'autenticazione a un server SMTP per inviare messaggi di posta elettronica.
Quando si configura l'associazione SSL (Secure Sockets Layer) di questo sito Web IIS, questo parametro è valido solo se usato con il parametro SecureSocketsLayer. Quando si configura l'autenticazione SMTP, questo parametro è valido solo quando il parametro DisableSMTPEncryption non è specificato.
| 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 |
-DefaultQuotaTemplate
Specifica il nuovo modello di quota del sito predefinito per questa 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 |
-DefaultTimeZone
Specifica il fuso orario predefinito per le nuove raccolte siti in questa applicazione Web.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-DisableSMTPEncryption
Specifica se attivare o disattivare la crittografia SMTP.
Il valore predefinito è False.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Force
Elimina i messaggi di conferma coinvolti nelle impostazioni per un'applicazione Web.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| 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 |
-Identity
Specifica il nome o l'URL dell'applicazione Web.
Il tipo deve essere un nome valido nel formato ApplicazioneWeb-1212 oppure un URL nel formato https://example.contoso.com.
| Type: | SPWebApplicationPipeBind |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-NotProvisionGlobally
Esegue il provisioning dell'applicazione Web nel server locale solo con le modifiche specificate da questo cmdlet. Il provisioning delle applicazioni Web in altri server della farm non verrà eseguito con queste modifiche.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-OutgoingEmailAddress
Specifica il nuovo indirizzo di posta elettronica in uscita per i messaggi di posta elettronica inviati da questa applicazione Web. Il tipo deve essere un indirizzo valido; Ad esempio, someone@example.com.
| 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 a questa applicazione Web. Può essere qualsiasi numero di porta valido.
Se si specifica un numero di porta già assegnato, IIS non avvierà il nuovo sito fino a quando non verrà modificato il numero di porta del nuovo sito o quello del sito precedente.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ReplyToEmailAddress
Configura l'indirizzo di posta elettronica per le risposte.
Il tipo deve essere un indirizzo valido; Ad esempio, someone@example.com.
| Type: | String |
| 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 questa 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 questo punto, 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 un gruppo proxy dell'applicazione di servizio personalizzato da usare per l'applicazione Web. L'applicazione Web userà i proxy in questo gruppo proxy per connettersi alle applicazioni di servizio. Se questo parametro non è specificato, viene usato il gruppo proxy predefinito della 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 dell'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 |
-SMTPCredentials
Specifica le credenziali da autenticare nel server SMTP. Impostare il valore su $null per connettersi al server SMTP in modo anonimo. Se questo parametro non viene specificato, le impostazioni di autenticazione esistenti verranno mantenute.
È necessario usare il Set-SPApplicationCredentialKey cmdlet di PowerShell per impostare una chiave di credenziali dell'applicazione identica in ogni server della farm prima di specificare le credenziali.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SMTPServer
Specifica il nuovo server SMTP in uscita che verrà usato dall'applicazione Web. Impostare su $null per cancellare l'impostazione del server.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SMTPServerPort
Specifica un valore di porta SMTP.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Url
Specifica l'URL con carico bilanciato per l'area dell'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 |
-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 SSL.
| 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 |
-Zone
Quando si configurano impostazioni specifiche per un'area, è necessario specificare l'area da configurare. Tale area deve essere già esistente.
Il tipo deve essere uno dei valori seguenti: Default, Intranet, Internet, Extranet o Custom.
| Type: | SPUrlZone |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |