Set-SPCustomLayoutsPage

사용자 지정 레이아웃 페이지에 대해 새 경로를 매핑합니다.

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.

이 cmdlet은 Set-SPCustomLayoutsPage 웹 애플리케이션의 사용자 지정 레이아웃 페이지에 대한 새 경로를 매핑합니다. 사용자 지정 레이아웃 페이지의 매핑을 제거하려면 RelativePath 매개 변수 대신 Reset 매개 변수를 사용합니다.

SharePoint 제품용 Windows PowerShell에 대한 사용 권한 및 최신 정보는 SharePoint Server Cmdlets를 참조하세요.

예제

---------------예제---------------

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

다음은 웹 애플리케이션 "https://server_name/mywebapp"에서 AccessDenied 레이아웃 페이지의 지정된 경로를 매핑하는 예제입니다.

매개 변수

-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

-Identity

설정할 사용자 지정 레이아웃 페이지를 지정합니다.

형식은 None, AccessDenied, Confirmation, Error, Login, RequestAccess, Signout 또는 WebDeleted 중 하나여야 합니다.

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

-RelativePath

사용자 지정 레이아웃 페이지의 경로를 지정합니다.

형식은 _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

-Reset

사용자 지정 레이아웃 페이지의 매핑을 다시 설정합니다.

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

-WebApplication

사용자 지정 레이아웃 페이지가 포함된 SharePoint 웹 응용 프로그램을 지정합니다.

형식은 유효한 URL이어야 합니다. 형식 https://server_name은 12345678-90ab-cdef-1234-567890bcdefgh 형식의 유효한 GUID, SharePoint 웹 애플리케이션의 유효한 이름(예: MyOfficeApp1) 또는 유효한 SPWebApplication 개체의 인스턴스여야 합니다.

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

-WhatIf

명령을 실행하는 대신에 명령의 효과를 설명하는 메시지를 표시합니다. 자세한 내용을 확인하려면 다음 명령을 입력하세요. 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