Partager via

Set-SPWebApplication

  • Référence
Module:
SharePointServer
S’applique à:
SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Configure l'application web spécifiée.

Syntax

Set-SPWebApplication
   [-Identity] <SPWebApplicationPipeBind>
   [-OutgoingEmailAddress <String>]
   [-ReplyToEmailAddress <String>]
   -SMTPServer <String>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Force]
   [-WhatIf]
   [-DisableSMTPEncryption]
   [-NotProvisionGlobally]
   [-SMTPServerPort <Int32>]
   [<CommonParameters>]
Set-SPWebApplication
   [-Identity] <SPWebApplicationPipeBind>
   -Zone <SPUrlZone>
   [-AdditionalClaimProvider <SPClaimProviderPipeBind[]>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-AuthenticationMethod <String>]
   [-AuthenticationProvider <SPAuthenticationProviderPipeBind[]>]
   [-Confirm]
   [-Force]
   [-SignInRedirectProvider <SPTrustedIdentityTokenIssuerPipeBind>]
   [-SignInRedirectURL <String>]
   [-WhatIf]
   [-NotProvisionGlobally]
   [<CommonParameters>]
Set-SPWebApplication
   [-Identity] <SPWebApplicationPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-DefaultQuotaTemplate <String>]
   [-DefaultTimeZone <Int32>]
   [-Force]
   [-ServiceApplicationProxyGroup <SPServiceApplicationProxyGroupPipeBind>]
   [-WhatIf]
   [-NotProvisionGlobally]
   [<CommonParameters>]

Description

Cette applet de commande 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.

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

$ap = New-SPAuthenticationProvider -AllowAnonymous
Set-SPWebApplication http://somesite -Zone "Extranet" -HostHeader "http://www.contoso.com" -AuthenticationProvider $ap

Cet exemple définit l’URL HostHeader pour la zone Extranet de l’application web donnée comme http://www.contoso.com et active l’accès anonyme.

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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-AuthenticationMethod

Permet de définir une application web sur l'authentification classique de Windows. 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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-AuthenticationProvider

Définit le(s) fournisseur(s) d'authentification correspondant à l'application web.

Type:SPAuthenticationProviderPipeBind[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DefaultTimeZone

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DisableSMTPEncryption

{{Fill DisableSMTPEncryption Description}}

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

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

Le type doit être un nom valide, au format WebApplication-1212, ou URL, au format http://server_name/WebApplicaiton-1212.

Type:SPWebApplicationPipeBind
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-NotProvisionGlobally

{{Fill NotProvisionGlobally Description}}

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-OutgoingEmailAddress

Spécifie la nouvelle adresse de messagerie sortante pour les messages électroniques envoyés depuis 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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ServiceApplicationProxyGroup

Spécifie un groupe de proxys personnalisé d'application de service pour l'application web à utiliser. L'application web utilisera les proxys de ce groupe de proxys pour se connecter à des 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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SignInRedirectURL

Spécifie l'URL de redirection d'ouverture de session 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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SMTPServer

Spécifie le nouveau serveur SMTP sortant qu'utilisera cette application web.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SMTPServerPort

{{Fill SMTPServerPort Description}}

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019