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 $credentials

In 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 $null

In 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