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 étend l’application web donnée à http://sitename la zone Extranet pour une utilisation SSL.

Paramètres

- Identité

Spécifie l'application web à étendre.

Type:SPWebApplicationPipeBind
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-AdditionalClaimProvider

Ajoute un fournisseur de revendications spécifique à l’application web définie.

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

-AllowLegacyEncryption

Spécifie que les versions antérieures du 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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
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
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
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
Accept pipeline input:True
Accept wildcard characters:False

-Chemin d’accès

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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Confirm

Prompts you for confirmation before executing the command. For more information, type the following command: get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-HostHeader

Spécifie la liaison d’en-tête de l’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 requêtes 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 demandes web envoyées à ce numéro de port seront routées vers ce site web IIS, sauf si un autre site web IIS possède 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
Accept pipeline input:False
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
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
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. Jusqu’à ce que cela soit fait, 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
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
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
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
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 du 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 de 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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

Displays a message that describes the effect of the command instead of executing the command. For more information, type the following command: get-help about_commonparameters

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