Upgrade-SPSite

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

Avvia il processo di aggiornamento in una raccolta siti.

Sintassi

Upgrade-SPSite
       [-Identity] <SPSitePipeBind>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-Email]
       [-QueueOnly]
       [-Unthrottled]
       [-VersionUpgrade]
       [-WhatIf]
       [-Priority <Byte>]
       [<CommonParameters>]

Descrizione

Il Upgrade-SPSite cmdlet avvia il processo di aggiornamento in una raccolta siti.

Il Upgrade-SPSite cmdlet attiva il processo di aggiornamento per l'oggetto SPSite specificato. È inoltre possibile utilizzare questo cmdlet per riprendere aggiornamenti non riusciti. Quando si utilizza questo cmdlet per avviare l'aggiornamento in un oggetto SPSite, l'oggetto può essere un aggiornamento da build a build o da versione a versione.

Per impostazione predefinita, il Upgrade-SPSite cmdlet funziona come aggiornamento da build a build. In questo modo si evita che vengano eseguiti aggiornamenti di versione imprevisti nelle raccolte siti se si utilizza questo cmdlet dopo un'operazione di patch. Quando è attiva la modalità di aggiornamento da versione a versione, le verifiche di integrità delle raccolte siti vengono eseguite in modalità di ripristino per garantire che la raccolta siti sia integra e consenta di eseguire correttamente l'aggiornamento. Se l'operazione ha esito positivo, verrà eseguito il resto dell'aggiornamento.

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

Upgrade-SPSite https://<site name>/sites/testsite

In questo esempio viene aggiornata la raccolta siti sito https:// siti/siti di test esistente<> usando solo le azioni di aggiornamento da compilazione a compilazione disponibili associate alla modalità operativa corrente della raccolta siti. SPSite.CompatibilityLevel non verrà modificato con questa operazione.

-------------ESEMPIO 2----------

Upgrade-SPSite https://<site name>/sites/testsite -VersionUpgrade

In questo esempio viene aggiornata la raccolta siti siti/siti/siti di test https:// esistenti<> usando tutte le azioni di aggiornamento da build a build disponibili associate alla modalità operativa corrente della raccolta siti ed esegue un aggiornamento da versione a versione.

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 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 2013, SharePoint Server 2016, SharePoint Server 2019

-Email

Specifica se inviare messaggi al completamento dell'aggiornamento della raccolta siti.

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

-Identity

Specifica l'oggetto SPSite in cui eseguire operazioni di aggiornamento.

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

-Priority

Specifica la priorità per l'aggiornamento del sito.

I valori validi sono:

  • 128 - 255 (priorità bassa)

  • 11 - 127 (priorità normale)

  • 0 - 10 (priorità alta)

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

-QueueOnly

Specifica di inserire il sito nella coda per un aggiornamento ritardato gestito da un processo timer.

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

-Unthrottled

Specifica a un amministratore di farm di ignorare la limitazione, in modo da consentire l'aggiornamento di una raccolta siti anche se nella limitazione sono presenti "troppe" raccolte siti da aggiornare.

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

-VersionUpgrade

Specifica di eseguire un aggiornamento da versione a versione nell'oggetto SPSite. Quando questo parametro è impostato, attiva internamente tutte le azioni da build a build disponibili associate alla modalità operativa della raccolta siti corrente. Seguono le azioni da versione a versione per portare le raccolte siti alla modalità operativa della raccolta siti successiva, incluse tutte le nuove azioni da build a build associate alla nuova modalità operativa della raccolta siti. Se questo parametro non è impostato, attiva solo le azioni di aggiornamento da build a build disponibili associate alla modalità operativa della raccolta siti corrente.

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

-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 2013, SharePoint Server 2016, SharePoint Server 2019