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 respecifiés lors de la mise à jour de la liaison d’un site web IIS via l’applet de Set-SPWebApplication 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 spécifié de nouveau, 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 $credentialsCet exemple montre comment définir l’application http://servername web pour qu’elle utilise le serveur SMTP mail.example.com, le port du serveur SMTP 587, l’adresse user@example.comde départ, l’adresse replyto@example.comde 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 $nullCet exemple montre comment définir l’application http://servername web pour qu’elle utilise le serveur SMTP mail.example.com, le port du serveur SMTP par défaut, l’adresse user@example.comfrom , l’adresse replyto@example.comde réponse et pour se connecter anonymement au serveur SMTP.
Paramètres
-AdditionalClaimProvider
Ajoute un fournisseur de revendications spécifique à l’application web définie.
| Type: | SPClaimProviderPipeBind[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-AllowLegacyEncryption
Spécifie que les anciennes versions de 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-AssignmentCollection
Gère les objets de manière à optimiser leur libération. L'utilisation d'objets, tels que SPWeb ou SPSite, peut consommer des quantités de mémoire élevées et le recours à ces objets dans des scripts Windows PowerShell implique une gestion appropriée de la mémoire. À l'aide de l'objet SPAssignment, vous pouvez affecter des objets à une variable et les libérer dès qu'ils ne sont plus nécessaires afin de libérer de la mémoire. Lorsque les objets SPWeb, SPSite ou SPSiteAdministration sont utilisés, ils sont automatiquement libérés si une collection d’attributions ou le paramètre Global ne sont pas utilisés.
Lorsque le paramètre Global est utilisé, tous les objets sont contenus dans le magasin global.
Si des objets ne sont pas utilisés immédiatement ou libérés à l’aide de la commande Stop-SPAssignment, un scénario d’insuffisance de mémoire peut se produire.
| Type: | SPAssignmentCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-AuthenticationMethod
Utilisez pour définir une application web sur Authentification Windows classique. Les valeurs valides sont NTLM ou 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
Définit le ou les fournisseurs d’authentification qui s’appliquent à l’application 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
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 est valide uniquement lorsqu’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 |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Confirm
Vous demande une confirmation avant d’exécuter la commande.
Pour plus d’informations, entrez la commande suivante : 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
Spécifie le nouveau modèle de quota de site par défaut pour cette application 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
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 |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-HostHeader
Spécifie la liaison d’en-tête d’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 demandes 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 requêtes web envoyées à ce numéro de port sont routées vers ce site web IIS, sauf si un autre site web IIS a 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Identity
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 |
| Required: | True |
| Accept pipeline input: | True |
| 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 approvisionnées avec ces modifications.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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, 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
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 |
| Required: | True |
| 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, 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
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. Tant que cette opération n’est pas effectuée, 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 |
| Required: | False |
| 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é que l’application web doit 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 de proxys par défaut de la batterie est utilisé.
| 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
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 |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SMTPCredentials
Spécifie les informations d’identification pour l’authentification 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 avant de spécifier les informations d’identification.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 sur $null pour effacer le paramètre de serveur.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Url
Spécifie l’URL à charge équilibrée pour la zone d’application 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
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 de 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 du nom du 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-WhatIf
Affiche un message qui explique l’effet de la commande au lieu de l’exécuter.
Pour plus d’informations, entrez la commande suivante : 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
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 |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour