New-SPWebApplicationExtension
Crée une instance de zone pour l'application web.
Syntax
New-SPWebApplicationExtension
[-Identity] <SPWebApplicationPipeBind>
-Name <String>
-Zone <SPUrlZone>
[-Port <UInt32>]
[-HostHeader <String>]
[-Certificate <SPServerCertificatePipeBind>]
[-UseServerNameIndication]
[-AllowLegacyEncryption]
[-Path <String>]
[-Url <String>]
[-AuthenticationMethod <String>]
[-AllowAnonymousAccess]
[-SecureSocketsLayer]
[-AuthenticationProvider <SPAuthenticationProviderPipeBind[]>]
[-AdditionalClaimProvider <SPClaimProviderPipeBind[]>]
[-SignInRedirectURL <String>]
[-SignInRedirectProvider <SPTrustedIdentityTokenIssuerPipeBind>]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet New-SPWebApplicationExtension
de commande crée une instance de zone pour l’application web.
Également appelée extension d’une application web, cette opération permet de configurer différentes autorisations pour le même contenu disponible dans l’application web existante.
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-----------------------
Get-SPWebApplication http://sitename | New-SPWebApplicationExtension -Name "ExtranetSite" -SecureSocketsLayer -Zone "Extranet" -URL "https://extranet.sitename.com"
Cet exemple montre comment étendre l’application Web donnée à http://sitename la zone Extranet pour une utilisation SSL.
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 à la zone d’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 |
-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.
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(s) fournisseur(s) d'authentification correspondant à 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 |
-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 |
-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 l'application web à étendre.
Type: | SPWebApplicationPipeBind |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-Name
Spécifie le nom du nouveau site web IIS dans l’application web.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-Path
Spécifie le répertoire physique du nouveau site web (dans le dossier répertoires virtuels). Le type est un chemin d'accès valide au format C:\Inutepub\wwwroot\MyWebApplication.
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 de l'application. Il peut s'agir de tout 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 est déjà affecté, IIS ne démarre pas le nouveau site tant que vous n’avez pas modifié 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 |
-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 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 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 |
-Zone
Spécifie l'une des cinq zones à laquelle doit être associée l'URL interne de cette nouvelle extension. Cette zone ne peut pas déjà être utilisée.
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 |