New-SPWebApplicationExtension

 

Sapplique à :SharePoint Foundation 2013, SharePoint Server 2013 Enterprise

Dernière rubrique modifiée :2015-03-09

Crée une instance de zone pour l’application web.

New-SPWebApplicationExtension [-Identity] <SPWebApplicationPipeBind> -Name <String> -Zone <Default | Intranet | Internet | Custom | Extranet> [-AdditionalClaimProvider <SPClaimProviderPipeBind[]>] [-AllowAnonymousAccess <SwitchParameter>] [-AssignmentCollection <SPAssignmentCollection>] [-AuthenticationMethod <String>] [-AuthenticationProvider <SPAuthenticationProviderPipeBind[]>] [-Confirm [<SwitchParameter>]] [-HostHeader <String>] [-Path <String>] [-Port <UInt32>] [-SecureSocketsLayer <SwitchParameter>] [-SignInRedirectProvider <SPTrustedIdentityTokenIssuerPipeBind>] [-SignInRedirectURL <String>] [-Url <String>] [-WhatIf [<SwitchParameter>]]

L’applet de commande New-SPWebApplicationExtension crée une nouvelle 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.

SharePoint Management Shell

 

Paramètre Requis Type Description

Identity

Requis

Microsoft.SharePoint.PowerShell.SPWebApplicationPipeBind

Spécifie l’application web à étendre.

Name

Requis

System.String

Spécifie le nom du nouveau site web IIS dans l’application web.

Zone

Requis

System.String

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.

AdditionalClaimProvider

Facultatif

Microsoft.SharePoint.PowerShell.SPClaimProviderPipeBind[]

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

AllowAnonymousAccess

Facultatif

System.Management.Automation.SwitchParameter

Autorise l’accès anonyme à la zone d’application web.

AssignmentCollection

Facultatif

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

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.

RemarqueRemarque :
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.

AuthenticationMethod

Facultatif

String

Utilise Kerberos ou NTLM pour spécifier la méthode d’authentification.

AuthenticationProvider

Facultatif

Microsoft.SharePoint.PowerShell.SPAuthenticationProviderPipeBind[]

Spécifie le(s) fournisseur(s) d’authentification correspondant à une application web.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Vous demande confirmation avant d’exécuter la commande. Pour plus d’informations, tapez la commande suivante : get-help about_commonparameters

HostHeader

Facultatif

System.String

Spécifie une URL valide affectée à l’application web correspondant à la configuration alternative du mappage d’accès, au format http://server_name.

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 sert à spécifier l’URL publique.

Path

Facultatif

System.String

Spécifie le répertoire physique du nouveau site web (dans le dossier des répertoires virtuels). Le type est un chemin d’accès valide au format C:\Inutepub\wwwroot\MyWebApplication.

Port

Facultatif

System.UInt32

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

ImportantImportant :
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.

SecureSocketsLayer

Facultatif

System.Management.Automation.SwitchParameter

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.

SignInRedirectProvider

Facultatif

Microsoft.SharePoint.PowerShell.SPTrustedIdentityTokenIssuerPipeBind

Définit l’URL de redirection de connexion de sorte qu’elle pointe vers l’URL définie dans le fournisseur d’authentification spécifié.

SignInRedirectURL

Facultatif

System.String

Spécifie l’URL de redirection de connexion pour l’application web.

Url

Facultatif

System.String

Spécifie l’URL à charge équilibrée pour la zone d’application web.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Affiche un message qui explique l’effet de la commande au lieu de l’exécuter. Pour plus d’informations, tapez la commande suivante : get-help about_commonparameters

------------------EXEMPLE-----------------------

Get-SPWebApplication http://sitename | New-SPWebApplicationExtension -Name "ExtranetSite" -SecureSocketsLayer -Zone "Extranet" -URL "https://extranet.sitename.com"

Cet exemple étend à la zone Extranet l’application web donnée située à l’adresse http://sitename lors de l’utilisation du protocole SSL.

Afficher: