Set-SPCustomLayoutsPage

Mapeia um novo caminho para uma nova página de layout personalizada.

Syntax

Set-SPCustomLayoutsPage
   -Identity <SPCustomPage>
   -RelativePath <String>
   -WebApplication <SPWebApplicationPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-WhatIf]
   [-CompatibilityLevel <Int32>]
   [<CommonParameters>]
Set-SPCustomLayoutsPage
   -Identity <SPCustomPage>
   [-Reset]
   -WebApplication <SPWebApplicationPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-WhatIf]
   [-CompatibilityLevel <Int32>]
   [<CommonParameters>]

Description

This cmdlet contains more than one parameter set. You may only use parameters from one parameter set and you may not combine parameters from different parameter sets. For more information about how to use parameter sets, see Cmdlet parameter sets.

O Set-SPCustomLayoutsPage cmdlet mapeia um novo caminho para uma página de layouts personalizados em um aplicativo Web. Para remover o mapeamento para uma página de layout personalizada, use o parâmetro Reset, em vez do parâmetro RelativePath.

Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.

Exemplos

------------------EXEMPLO-----------------------

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

Este exemplo mapeia o caminho especificado para a página de layout Acesso Negado no aplicativo Web "https://server_name/mywebapp".

Parâmetros

-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

-CompatibilityLevel

Specifies the version of templates to use when creating a new SPSite object. This value sets the initial CompatibilityLevel value for the site collection. When this parameter is not specified, the CompatibilityLevel will default to the highest possible version for the web application depending on the CompatibilityRange setting.

Type:Int32
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

-Identidade

Especifica a página de layout personalizada a ser definida.

O tipo deve ser um dos seguintes: None, AccessDenied, Confirmation, Error, Login, RequestAccess, Signout ou WebDeleted.

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

-Redefinir

Redefine o mapeamento de uma página de layouts personalizados.

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

-RelativePath

Especifica o caminho da página de layout personalizada.

O tipo deve ser um caminho válido de uma página de layout, no formato _layouts/custompages/myaccessdenied.aspx.

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

-WebApplication

Especifica o aplicativo Web do SharePoint que contém a página de layout personalizada.

O tipo deve ser uma URL válida, no formato https://server_name; um GUID válido, no formato 12345678-90ab-cdef-1234-567890bcdefgh; um nome válido de aplicativo Web do SharePoint (por exemplo, MyOfficeApp1); ou uma instância de um objeto SPWebApplication válido.

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

-WhatIf

Exibe uma mensagem que descreve o efeito do comando em vez de executar o comando. Para saber mais, digite o seguinte comando: 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