Partager via

New-SPWebApplicationExtension

Module:
SharePointServer module

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

Syntaxe

Default (Par défaut) 

New-SPWebApplicationExtension
    [-Identity] <SPWebApplicationPipeBind>
    -Name <String>
    -Zone <SPUrlZone>
    [-AdditionalClaimProvider <SPClaimProviderPipeBind[]>]
    [-AllowAnonymousAccess]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-AuthenticationMethod <String>]
    [-AuthenticationProvider <SPAuthenticationProviderPipeBind[]>]
    [-Confirm]
    [-HostHeader <String>]
    [-Path <String>]
    [-Port <UInt32>]
    [-SecureSocketsLayer]
    [-SignInRedirectProvider <SPTrustedIdentityTokenIssuerPipeBind>]
    [-SignInRedirectURL <String>]
    [-Url <String>]
    [-WhatIf]
    [<CommonParameters>]

Description

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

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:

SPClaimProviderPipeBind[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-AllowAnonymousAccess

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-AssignmentCollection

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriétés du paramètre

Type:SPAssignmentCollection
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-AuthenticationMethod

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-AuthenticationProvider

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:

SPAuthenticationProviderPipeBind[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-HostHeader

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Spécifie une URL valide affectée à l’application web par qui doit être corrélée à la configuration de mappage d’accès alternatif, sous le formulaire 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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Identity

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Spécifie l'application web à étendre.

Propriétés du paramètre

Type:SPWebApplicationPipeBind
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:1
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Name

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Path

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Port

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriétés du paramètre

Type:UInt32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SecureSocketsLayer

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SignInRedirectProvider

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:SPTrustedIdentityTokenIssuerPipeBind
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SignInRedirectURL

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Spécifie l'URL de redirection d'ouverture de session pour l'application web.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Url

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Zone

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:SPUrlZone
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.