Set-SPWebApplication

Configure l'application Web spécifiée.

Syntax

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

Description

Cette cmdlet contient plus d’un jeu de paramètres. Vous ne pouvez utiliser les paramètres que d’un seul jeu et vous ne pouvez pas combiner les paramètres de différents jeux. Pour plus d’informations sur l’utilisation des jeux de paramètres, consultez les Jeux de paramètres des applets de commande.

L’applet Set-SPWebApplication de commande configure l’application web spécifiée par le paramètre Identity. Pour les paramètres spécifiques à la zone (pour le jeu de paramètres Zone), la zone à configurer doit être spécifiée. La zone spécifiée doit déjà exister.

Tous les paramètres de liaison IIS doivent être spécifiés lors de la mise à jour de la liaison d’un site web IIS via l’applet Set-SPWebApplication de commande. Cela inclut l’URL, le paramètre de couche de sockets sécurisés, le numéro de port, l’en-tête de l’hôte et le certificat. Si un paramètre de liaison n’est pas respécififié, il revient à sa valeur par défaut.

Pour les autorisations et les informations les plus récentes sur Windows PowerShell pour les produits SharePoint, consultez la documentation en ligne sur les applets de commande SharePoint Server.

Exemples

EXEMPLE 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

Cet exemple montre comment définir l’application http://servername web pour qu’elle utilise le mail.example.com du serveur SMTP, le port de serveur SMTP 587, le user@example.com d’adresse de départ, le replyto@example.com d’adresse de réponse et les informations d’identification stockées dans l’objet $credentials.

EXEMPLE 2

Set-SPWebApplication -Identity http://servername -SMTPServer mail.example.com -OutgoingEmailAddress user@example.com -ReplyToAddress replyto@example.com -SMTPCredentials $null

Cet exemple montre comment définir l’application http://servername web pour qu’elle utilise le mail.example.com du serveur SMTP, le port de serveur SMTP par défaut, le user@example.com d’adresse de départ, le replyto@example.com d’adresse de réponse et de se connecter au serveur SMTP de manière anonyme.

Paramètres

- Identité

Spécifie le nom ou l’URL de l’application web.

Le type doit correspondre à un nom valide au format WebApplication-1212, ou une URL au format 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

-AdditionalClaimProvider

Ajoute un fournisseur de revendications spécifique à l’application web définie.

Type:SPClaimProviderPipeBind[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-AllowLegacyEncryption

Spécifie que les versions antérieures du protocole SSL et TLS et les suites de chiffrement sont autorisées à être utilisées avec ce site web IIS. Le chiffrement hérité est plus faible que le chiffrement moderne et n’est pas recommandé.

Cette fonctionnalité nécessite Windows Server 2022 ou une version ultérieure. Cette fonctionnalité n’est pas disponible lorsque SharePoint est déployé avec des versions antérieures de Windows Server.

Ce paramètre est valide uniquement lorsqu’il est utilisé avec le paramètre 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

Permet de définir une application web sur des Authentification Windows classiques. Les valeurs valides sont NTLM ou Kerberos.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-AuthenticationProvider

Définit le ou les fournisseurs d’authentification qui s’appliquent à l’application web.

Type:SPAuthenticationProviderPipeBind[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Certificate

Spécifie le certificat qui sera utilisé pour la liaison SSL (Secure Sockets Layer) de ce site web IIS, ou pour l’authentification auprès d’un serveur SMTP pour envoyer des e-mails.

Lors de la configuration de la liaison SSL (Secure Sockets Layer) de ce site web IIS, ce paramètre n’est valide que s’il est utilisé avec le paramètre SecureSocketsLayer. Lors de la configuration de l’authentification SMTP, ce paramètre n’est valide que lorsque le paramètre DisableSMTPEncryption n’est pas spécifié.

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

Spécifie le nouveau modèle de quota de site par défaut pour cette application web.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-DefaultTimeZone

Spécifie le fuseau horaire par défaut pour les nouvelles collections de sites dans cette application web.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-DisableSMTPEncryption

Spécifie si le chiffrement SMTP doit être activé ou désactivé.

La valeur par défaut est false.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Force

Supprime les messages de confirmation impliqués dans les paramètres d’une application web.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-HostHeader

Spécifie la liaison d’en-tête de l’hôte pour ce site web IIS. Une liaison d’en-tête d’hôte permet à plusieurs sites web IIS de partager le même numéro de port. Les requêtes web envoyées à un numéro de port partagé sont routées vers le site web IIS approprié en fonction de la valeur de l’en-tête d’hôte HTTP envoyé par le client.

Si aucune liaison d’en-tête d’hôte n’est spécifiée, toutes les demandes web envoyées à ce numéro de port seront routées vers ce site web IIS, sauf si un autre site web IIS possède une liaison d’en-tête d’hôte qui correspond à l’en-tête d’hôte HTTP envoyé par le client.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-NotProvisionGlobally

Provisionne uniquement l’application web sur le serveur local avec les modifications spécifiées par cette applet de commande. Les applications web sur d’autres serveurs de la batterie de serveurs ne seront pas provisionnées avec ces modifications.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-OutgoingEmailAddress

Spécifie la nouvelle adresse de messagerie sortante pour les messages électroniques envoyés à partir de cette application web. Le type doit être une adresse valide, par exemple xyz@example.com.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Port

Spécifie le port sur lequel cette application web est accessible. Il peut s'agir d'un numéro de port valide.

Si vous spécifiez un numéro de port qui a déjà été attribué, IIS ne démarre pas le nouveau site tant que vous n'avez pas changé le numéro de port du nouveau site ou celui de l'ancien site.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-ReplyToEmailAddress

Configure l'adresse de messagerie de réponse.

Le type doit être une adresse valide, par exemple xyz@example.com.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SecureSocketsLayer

Active le chiffrement SSL (Secure Sockets Layer) pour cette application web. Si vous choisissez d’utiliser SSL, vous devez importer un certificat de serveur dans SharePoint et l’affecter au site web IIS pour cette application web. Jusqu’à ce que cela soit fait, l’application web sera inaccessible à partir de ce site web IIS.

La valeur par défaut est False.

Si ce paramètre est omis ou défini sur False, cette application web utilise HTTP pour le port spécifié.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-ServiceApplicationProxyGroup

Spécifie un groupe proxy d’application de service personnalisé pour l’application web à utiliser. L’application web utilise les proxys de ce groupe proxy pour se connecter aux applications de service. Si ce paramètre n’est pas spécifié, le groupe proxy par défaut de la batterie de serveurs est utilisé.

Type:SPServiceApplicationProxyGroupPipeBind
Aliases:ProxyGroup
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SignInRedirectProvider

Définit l'URL de redirection d'ouverture de session afin de pointer vers l'URL définie dans le fournisseur d'authentification spécifié.

Type:SPTrustedIdentityTokenIssuerPipeBind
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SignInRedirectURL

Spécifie l’URL de redirection de connexion pour l’application web.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SMTPCredentials

Spécifie les informations d’identification à authentifier auprès du serveur SMTP. Définissez la valeur sur $null pour vous connecter au serveur SMTP de manière anonyme. Si ce paramètre n’est pas spécifié, les paramètres d’authentification existants sont conservés.

Vous devez utiliser l’applet Set-SPApplicationCredentialKey de commande PowerShell pour définir une clé d’informations d’identification d’application identique sur chaque serveur de la batterie de serveurs avant de spécifier les informations d’identification.

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SMTPServer

Spécifie le nouveau serveur SMTP sortant que cette application web utilisera. Définissez la valeur $null pour effacer le paramètre serveur.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SMTPServerPort

Spécifie une valeur de port SMTP.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Url

Spécifie l’URL d’équilibrage de charge pour la zone d’application web.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-UseServerNameIndication

Spécifie que la liaison SSL (Secure Sockets Layer) de ce site web IIS doit utiliser l’indication de nom de serveur (SNI). L’indication du nom du serveur permet à plusieurs sites web IIS avec des en-têtes d’hôte uniques et des certificats de serveur uniques de partager le même port SSL. Si l’indication de nom de serveur n’est pas utilisée, tous les sites web IIS partageant le même port SSL doivent partager le même certificat 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

Lors de la configuration des paramètres spécifiques à la zone, la zone à configurer doit être spécifiée. Cette zone doit déjà exister.

Le type doit être l'une des valeurs suivantes : Default, Intranet, Internet, Extranet ou Custom.

Type:SPUrlZone
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition