Set-SPCustomLayoutsPage

カスタム レイアウト ページの新しいパスをマップします。

構文

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

説明

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.

このコマンドレットは Set-SPCustomLayoutsPage 、Web アプリケーションのカスタム レイアウト ページの新しいパスをマップします。 カスタム レイアウト ページのマッピングを削除するには、RelativePath パラメーターの代わりに Reset パラメーターを使用します。

Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンライン ドキュメントをご覧ください。

------------------ 例 -----------------------

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

この例では、Web アプリケーション "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 Web アプリケーションを指定します。

この型は、有効な URL (形式 https://server_name12345678-90ab-cdef-1234-567890bcdefgh)、SharePoint Web アプリケーションの有効な名前 (MyOfficeApp1 など)、または有効な SPWebApplication オブジェクトのインスタンスである有効な GUID である必要があります。

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