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.com, l'indirizzo di risposta replyto@example.com 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 impostato l'applicazione http://servername Web in modo che usi il server SMTP mail.example.com, la porta del server SMTP predefinita, l'indirizzo di origine user@example.com, l'indirizzo di risposta replyto@example.com e la connessione 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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
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
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
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
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Confirm

Prompts you for confirmation before executing the command. For more information, type the following command: get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
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
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
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
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
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
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
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
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 prova@example.com.

Type:String
Position:Named
Default value:None
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
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 prova@example.com.

Type:String
Position:Named
Default value:None
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
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
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
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
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
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
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
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

Displays a message that describes the effect of the command instead of executing the command. For more information, type the following command: get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition