New-SPWebApplication
Crée une application web au sein de la batterie locale.
Syntax
New-SPWebApplication
-ApplicationPool <String>
-Name <String>
[-AdditionalClaimProvider <SPClaimProviderPipeBind[]>]
[-AllowAnonymousAccess]
[-ApplicationPoolAccount <SPProcessAccountPipeBind>]
[-AssignmentCollection <SPAssignmentCollection>]
[-AuthenticationMethod <String>]
[-AuthenticationProvider <SPAuthenticationProviderPipeBind[]>]
[-Confirm]
[-DatabaseCredentials <PSCredential>]
[-DatabaseName <String>]
[-DatabaseServer <String>]
[-HostHeader <String>]
[-Path <String>]
[-Port <UInt32>]
[-SecureSocketsLayer]
[-ServiceApplicationProxyGroup <SPServiceApplicationProxyGroupPipeBind>]
[-SignInRedirectProvider <SPTrustedIdentityTokenIssuerPipeBind>]
[-SignInRedirectURL <String>]
[-Url <String>]
[-UserSettingsProvider <SPUserSettingsProviderPipeBind>]
[-WhatIf]
[<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 -SecureSocketsLayerCré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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 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
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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 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 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-HostHeader
Spécifie une URL valide affectée à l'application web qui doit correspondre à la configuration de mappage des accès de substitution, au format serveur_nom.
Lorsque le paramètre HostHeader est spécifié, la valeur de ce champ correspond à l'URL interne de l'application web. Le paramètre Url est utilisé pour spécifier l’URL publique. Si aucune valeur n’est spécifiée, la valeur est laissée vide.
| 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 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Path
Spécifié le répertoire physique de la nouvelle application web dans le dossier des 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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-SecureSocketsLayer
Autorise le chiffrement SSL (Secure Sockets Layer) pour cette application web. Si vous choisissez d'utiliser le protocole SSL, vous devez doter chaque serveur du certificat approprié à l'aide des outils d'administration IIS. Tant que les certificats ne sont pas ajoutés, l'application web reste inaccessible depuis ce site web IIS.
| 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 |
-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 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 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, 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 |