Set-SPCustomLayoutsPage

  • Riferimento
Modulo:
SharePointServer
Si applica a:
SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Aggiunge il mapping per un nuovo percorso per una pagina di layout personalizzata.

Sintassi

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

Descrizione

Questo cmdlet include più set di parametri. È possibile utilizzare solo i parametri di un set di parametri e non è possibile combinare parametri appartenenti a set di parametri diversi. Per altre informazioni su come usare i set di parametri, vedere Set di parametri del cmdlet.

Il cmdlet esegue il Set-SPCustomLayoutsPage mapping di un nuovo percorso per una pagina di layout personalizzati in un'applicazione Web. Per rimuovere il mapping per una pagina di layout personalizzati, utilizzare il parametro Reset anziché il parametro RelativePath.

Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.

Esempio

------------------ESEMPIO-----------------------

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

Questo esempio esegue il mapping del percorso specificato per la pagina di layout AccessDenied nell'applicazione Web "https://server_name/mywebapp".

Parametri

-AssignmentCollection

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-CompatibilityLevel

Specifica la versione dei modelli da utilizzare durante la creazione di un nuovo oggetto SPSite. Questo valore consente di impostare il valore CompatibilityLevel iniziale per la raccolta siti. Se questo parametro non viene specificato, come CompatibilityLevel verrà utilizzata per impostazione predefinita la versione più alta possibile per l'applicazione Web in base all'impostazione CompatibilityRange.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

Richiede la conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

Specifica la pagina di layout personalizzata da impostare.

Il tipo deve essere uno dei valori seguenti: None, AccessDenied, Confirmation, Error, Login, RequestAccess, Signout o WebDeleted.

Type:SPCustomPage
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-RelativePath

Specifica il percorso della pagina di layout personalizzata.

Il tipo deve essere un percorso valido di una pagina di layout nel formato _layouts/paginepersonalizzate/paginaaccessonegato.aspx.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Reset

Reimposta il mapping di una pagina di layout personalizzata.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WebApplication

Specifica l'applicazione Web di SharePoint che contiene la pagina di layout personalizzata.

Il tipo deve essere un URL valido nel formato https://server_name. un GUID valido nel formato 12345678-90ab-cdef-1234-567890bcdefgh, un nome valido di un'applicazione Web di SharePoint (ad esempio AppOffice1) oppure un'istanza di un oggetto SPWebApplication valido.

Type:SPWebApplicationPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WhatIf

Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019