New-SPWebApplication

Crée une application web au sein de la batterie locale.

Syntax

New-SPWebApplication
   -Name <String>
   -ApplicationPool <String>
   [-ApplicationPoolAccount <SPProcessAccountPipeBind>]
   [-ServiceApplicationProxyGroup <SPServiceApplicationProxyGroupPipeBind>]
   [-SecureSocketsLayer]
   [-HostHeader <String>]
   [-Certificate <SPServerCertificatePipeBind>]
   [-UseServerNameIndication]
   [-AllowLegacyEncryption]
   [-Port <UInt32>]
   [-AllowAnonymousAccess]
   [-Path <String>]
   [-Url <String>]
   [-AuthenticationMethod <String>]
   [-AuthenticationProvider <SPAuthenticationProviderPipeBind[]>]
   [-AdditionalClaimProvider <SPClaimProviderPipeBind[]>]
   [-SignInRedirectURL <String>]
   [-SignInRedirectProvider <SPTrustedIdentityTokenIssuerPipeBind>]
   [-UserSettingsProvider <SPUserSettingsProviderPipeBind>]
   [-DatabaseCredentials <PSCredential>]
   [-DatabaseServer <String>]
   [-DatabaseName <String>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Crée une application web spécifiée par le paramètre Name. L'utilisateur spécifié par le paramètre DatabaseCredentials doit être membre du rôle de serveur fixe dbcreator sur le serveur de base de données.

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

New-SPWebApplication -Name "Contoso Internet Site" -Port 80 -HostHeader sharepoint.contoso.com -URL "http://www.contoso.com" -ApplicationPool "ContosoAppPool" -ApplicationPoolAccount (Get-SPManagedAccount "DOMAIN\wa")

Cet exemple crée une application web à l’aide d’un en-tête d’hôte interne de sharepoint.contoso.com et d’une URL publique de http://www.contoso.com.

------------------EXEMPLE 2-----------------------

New-SPWebApplication -Name "Contoso Internet Site" -Port 443 -SecureSocketsLayer -HostHeader sharepoint.contoso.com -URL "https://www.contoso.com:443" -ApplicationPool "ContosoAppPool" -ApplicationPoolAccount (Get-SPManagedAccount "DOMAIN\wa")

Cet exemple crée une application web compatible SSL à l’aide d’un en-tête d’hôte interne de sharepoint.contoso.com et d’une URL publique de https://www.contoso.com.

------------------EXEMPLE 3-----------------------

$ap = New-SPAuthenticationProvider
New-SPWebApplication -Name "Contoso Internet Site" -URL "https://www.contoso.com"  -Port 443 
-ApplicationPool "ContosoAppPool" 
-ApplicationPoolAccount (Get-SPManagedAccount "DOMAIN\wa") 
-AuthenticationProvider $ap -SecureSocketsLayer

Crée une application web Revendications Windows à l’URL https://www.contoso.com à l’aide du domaine de compte de domaine\wa.

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

-AllowAnonymousAccess

Autorise l’accès anonyme à l’application web.

Type:SwitchParameter
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

-ApplicationPool

Spécifie le nom d’un pool d’applications à utiliser ; par exemple, SharePoint - 1213. Si aucun pool d'applications au nom fourni n'existe, le paramètre ApplicationPoolAccount doit être fourni et un nouveau pool d'applications est créé. Si aucune valeur n'est spécifiée, le pool d'applications par défaut est utilisé.

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

-ApplicationPoolAccount

Spécifie le compte d'utilisateur que ce pool d'applications utilise pour son exécution. Utilisez l’applet de Get-SPIisWebServicApplicationPool commande pour utiliser un compte système.

Type:SPProcessAccountPipeBind
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

Utilise Kerberos ou NTLM pour spécifier la méthode d'authentification. Si aucune valeur n'est spécifiée, la méthode NTLM par défaut est appliquée.

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

-AuthenticationProvider

Spécifie le ou les fournisseurs d'authentification qui s'appliquent à une 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. Ce paramètre est valide uniquement lorsqu’il est utilisé avec le paramètre SecureSocketsLayer.

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

-DatabaseCredentials

Spécifie l'objet Credential Windows PowerShell du compte d'utilisateur de base de données.

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

-DatabaseName

Spécifie le nom de la base de données de contenu d'origine de la nouvelle application web.

Le type doit correspondre à un nom de base de données valide, par exemple, ContentDB1. Si aucune valeur n’est spécifiée, une valeur au format WSS_Content_<GUID> est générée automatiquement.

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

-DatabaseServer

Spécifie le nom du serveur de base de données. Le type doit correspondre à un nom de serveur de base de données valide au format SQL1 ; lorsque des instances nommées sont utilisées, le format peut être serveur\serveur. L'instance de serveur SQL par défaut est utilisée si aucune valeur n'est fournie.

Type:String
Position:Named
Default value:None
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

-Name

Spécifie le nom de la nouvelle application web.

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

-Path

Spécifie le répertoire physique de la nouvelle application web dans le dossier répertoires virtuels. Le type est un chemin d'accès valide au format C:\Inutepub\wwwroot\MyWebApplication. Si aucune valeur n’est spécifiée, la valeur %wwwroot%\wss\VirtualDirectories\<portnumber> est appliquée.

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 aucun port n'est spécifié, un numéro de port non conflictuel est automatiquement généré.

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

-SecureSocketsLayer

Autorise 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 de proxys personnalisé d'application de service pour l'application web à utiliser. L'application web utilise les proxys de ce groupe pour se connecter aux applications de service. Si ce paramètre n'est pas spécifié, le groupe de proxys par défaut pour 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 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 Subscription Edition

-Url

Spécifie l'URL à charge équilibrée 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

-UserSettingsProvider

Donne accès au fournisseur de paramètres utilisateur externe.

Type:SPUserSettingsProviderPipeBind
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 de serveur n’est pas utilisée, tous les sites web IIS partageant le même port SSL doivent partager le même certificat de serveur.

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