Set-SPCustomLayoutsPage

SharePoint 2013
 

Sapplique à :SharePoint Foundation 2013, SharePoint Server 2013 Enterprise

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

Mappe un nouveau chemin d’accès pour une page de disposition personnalisée.

Set-SPCustomLayoutsPage -Identity <None | AccessDenied | Confirmation | Error | Login | RequestAccess | Signout | WebDeleted> -RelativePath <String> -WebApplication <SPWebApplicationPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Set-SPCustomLayoutsPage -Identity <None | AccessDenied | Confirmation | Error | Login | RequestAccess | Signout | WebDeleted> -Reset <SwitchParameter> -WebApplication <SPWebApplicationPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Cette cmdlet contient plus d’un jeu de paramètres. Vous ne pouvez utiliser les paramètres que d’un seul jeu et vous ne pouvez pas combiner les paramètres de différents jeux. Pour plus d’informations sur l’utilisation des jeux de paramètres, voir la rubrique relative aux jeux de paramètres de cmdlet.

L’applet de commande Set-SPCustomLayoutsPage mappe un nouveau chemin d’accès pour une page de dispositions personnalisées dans une application web. Pour supprimer le mappage d’une page de dispositions personnalisées, utilisez le paramètre Reset au lieu du paramètre RelativePath.

SharePoint Management Shell

 

Paramètre Obligatoire Type Description

Identité

Requis

Microsoft.SharePoint.Administration.SPWebApplication.SPCustomPage

Spécifie la page de disposition personnalisée à définir.

Le type doit être l’un des suivants : None, AccessDenied, Confirmation, Error, Login, RequestAccess, Signout ou WebDeleted.

RelativePath

Requis

System.String

Spécifie le chemin d’accès de la page de disposition personnalisée.

Le type doit être un chemin d’accès de page de disposition valide au format _layouts/custompages/myaccessdenied.aspx.

Reset

Obligatoire

System.Management.Automation.SwitchParameter

Définit le mappage d’une page de dispositions personnalisées sur NULL.

WebApplication

Requis

Microsoft.SharePoint.PowerShell.SPWebApplicationPipeBind

Spécifie l’application web SharePoint contenant la mise en page personnalisée.

Le type doit être une URL valide au format http://server_name, un GUID valide au format 12345678-90ab-cdef-1234-567890bcdefgh, un nom d’application web SharePoint valide (par exemple, MyOfficeApp1) ou une instance d’un objet SPWebApplication valide.

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.

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

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

Set-SPCustomLayoutsPage -Identity AccessDenied -RelativePath "/_layouts/custompages/myaccessdenied.aspx" -WebApplication "http://server_name/mywebapp"

Cet exemple mappe le chemin d’accès spécifié pour la page de disposition AccessDenied dans l’application web"http://server_name/mywebapp".

Afficher: