Installare gli aggiornamenti cumulativi di SharePoint in una farm di SharePoint passo dopo passo utilizzando la PowerShell

Questo post spiegherà come velocizzare l’installazione degli aggiornamenti cumulativi in una farm SharePoint passo dopo passo utilizzando la PowerShell. Utilizzando la PowerShell, è possibile ridurre notevolmente il tempo necessario per aggiornare la farm SharePoint, il cui completamento può richiedere diverse ore se si utilizza il metodo tradizionale di installazione degli aggiornamenti cumulativi. I passaggi descritti in questo post sono validi per SharePoint 2013, SharePoint 2016 e SharePoint 2019.

Questo post presuppone un singolo server SharePoint, ma se si dispone di più server SharePoint, è necessario seguire questi passaggi su tutti i server SharePoint nella farm.

introduzione

Il mondo SharePoint si sta rapidamente spostando nel cloud con SharePoint Online e Office 365, ma alcune organizzazioni non sono ancora pronte per passare completamente a Office 365 e SharePoint Online.

L’aggiornamento a SharePoint 2019 che supporta uno scenario ibrido può essere una valida soluzione per consentire un passaggio graduale al cloud.

L’installazione di una farm di SharePoint 2019 può essere eseguita in modo automatizzato utilizzando PowerShell e AutoSPInstaller. Un ulteriore vantaggio di questo processo di installazione garantisce che la farm di SharePoint sia installata con gli ultimi aggiornamenti, lasciando la farm di SharePoint aggiornata e funzionante correttamente (se vuoi imparare come installare una farm di SharePoint 2019 in modo automatico, clicca qui e qui ) .

Per garantire che dopo l’installazione, il server SharePoint sia sempre aggiornato, dobbiamo assicurarci che sia gli aggiornamenti di Windows che in particolare gli aggiornamenti cumulativi di SharePoint siano installati correttamente.

Installazione degli aggiornamenti di SharePoint

Per installare gli ultimi aggiornamenti cumulativi di SharePoint nella farm, attenersi alla seguente procedura:

Scarica gli aggiornamenti cumulativi di SharePoint
Backup della farm e delle configurazioni di SharePoint
Installare gli aggiornamenti cumulativi nella farm di SharePoint (utilizzando PowerShell)
Eseguire prodotti SharePoint e configurazione guidata
Passaggi successivi all’installazione

Scarica gli aggiornamenti cumulativi di SharePoint

Tutto inizia scaricando gli ultimi aggiornamenti cumulativi di SharePoint. Per farlo, devi scaricare:

SharePoint 2016 e SharePoint 2019:
- Gli ultimi aggiornamenti di SharePoint indipendenti dalla lingua
- Gli ultimi aggiornamenti di SharePoint dipendenti dalla lingua (anche se nella farm è installato solo il language pack inglese)
SharePoint 2013:
- Gli ultimi aggiornamenti di SharePoint 2013 Server (se è installato SharePoint 2013 Server)
- Gli ultimi aggiornamenti di SharePoint Foundation 2013 (se è installato solo SharePoint Foundation 2013). Questo aggiornamento non è necessario se si dispone di SharePoint 2013 Server poiché SharePoint Foundation 2013 è incluso in SharePoint 2013 Server

Per rimanere sempre aggiornato e scaricare gli ultimi aggiornamenti, clicca qui .

Backup della farm e delle configurazioni di SharePoint

Prima di applicare gli aggiornamenti, è necessario eseguire i seguenti backup:

Eseguire il backup della farm di SharePoint eseguendo il comando seguente:
Backup-SPFarm -Directory <BackupFolder> -BackupMethod Full -Verbose

La cartella di backup dovrebbe essere una cartella condivisa sulla rete, accessibile sia da SharePoint che dai server di database.

Verificare che il servizio SharePoint Server VSS Writer sia avviato nel server SharePoint (non avviato automaticamente).

Verificare che il servizio SQL Server VSS Writer sia avviato sul server di database.

Per ulteriori dettagli sul backup della farm di SharePoint, fare clic qui , qui e qui

Eseguire il backup di tutti i database di SharePoint nel server di database che supporta la farm di SharePoint utilizzando gli strumenti di SQL Server Enterprise
Eseguire il backup dei file web.config per tutte le applicazioni web
Se disponi di soluzioni sviluppate su misura utilizzando il codice lato server, esegui il backup delle soluzioni. Per semplificare l’operazione, puoi scaricare uno script PowerShell dal questo repository GitHub

Installare gli aggiornamenti cumulativi nella farm di SharePoint (utilizzando PowerShell)

Dopo aver scaricato gli ultimi aggiornamenti e preso le necessarie precauzioni, sei pronto per installarli nella tua farm di SharePoint.

Se vuoi utilizzare il metodo tradizionale per aggiornare la tua fattoria, clicca qui . Se vuoi imparare il modo di PowerShell e velocizzare l’installazione degli aggiornamenti cumulativi nella tua farm di SharePoint, continua a leggere!

Per scaricare lo script di SharePoint Patch PowerShell, fare clic qui . Questo script, scritto da Trevor Seward, è una versione migliorata di uno script di PowerShell originariamente creato da Russ Maxwell per SharePoint 2013.

Il modo in cui questo script di PowerShell garantisce che il tempo di elaborazione della patch di SharePoint sia ridotto da 4 a 5 ore a meno di un’ora è eseguendo le seguenti operazioni:

Se si sceglie di (utilizzare il parametro dell’opzione -Pause), sospende l’applicazione del servizio di ricerca. Questo è molto importante poiché se durante l’installazione dell’aggiornamento cumulativo è stata attivata una ricerca per indicizzazione, l’applicazione di ricerca potrebbe essere danneggiata e l’utente potrebbe essere costretto a ricreare l’intera applicazione del servizio di ricerca, ricreare eventuali proprietà gestite personalizzate ed eseguire nuovamente una ricerca per indicizzazione completa per assicurati di avere risultati di ricerca e che tutte le soluzioni basate sulla ricerca funzionino correttamente
Per SharePoint 2013 (non necessario per SharePoint 2016 e SharePoint 2019), i seguenti servizi verranno disabilitati e quindi arrestati:
- I servizi di ricerca sono disabilitati
- I servizi di ricerca vengono interrotti
- I servizi IISAdmin e SPTimerV4 sono disabilitati
- I servizi IISAdmin e SPTimerV4 vengono arrestati
Se scegli di farlo, gli aggiornamenti cumulativi vengono installati in modalità passiva (senza alcuna interazione da parte dell’utente necessaria) ma puoi comunque vedere il processo di installazione nell’interfaccia utente
Al termine dell’installazione degli aggiornamenti cumulativi:
- Per SharePoint 2013 (non necessario per SharePoint 2016 e SharePoint 2019), i seguenti servizi saranno impostati su automatico:
  - Servizi di ricerca
  - Servizi IISAdmin e SPTimerV4
- Se si sceglie di utilizzare il parametro dell’opzione -Pause, l’applicazione del servizio di ricerca verrà ripristinata

Per avviare il processo di installazione, apri la finestra di SharePoint PowerShell (esegui come amministratore) ed esegui i seguenti comandi:

Import-Module .\SharePointPatchScript.psm1
Install-SPPatch -Path -Pause
- Esempio: Install-SPPatch -Path D:\SharePoint\Updates -Pause

Per SharePoint 2016 e 2019, un aggiornamento cumulativo mensile contiene in genere sia i pacchetti indipendenti dalla lingua (“file sts”) che dipendenti dalla lingua (“file wssloc”). A volte, un aggiornamento cumulativo include solo il pacchetto indipendente dalla lingua. In tal caso e hai già installato l’ultimo pacchetto dipendente dalla lingua, puoi eseguire il comando PowerShell con il parametro switch -OnlySTS:

Import-Module .\SharePointPatchScript.psm1
Install-SPPatch -OnlySTS -Path -Pause
- Esempio: Install-SPPatch -OnlySTS -Path D:\SharePoint\Updates -Pause

Verrà avviato il processo di aggiornamento della farm di SharePoint (esempi per SharePoint 2013 e SharePoint 2019).

Per SharePoint 2013, i pacchetti SharePoint Server o SharePoint Foundation verranno rilevati automaticamente e installati. L’esempio seguente è per SharePoint 2013 Server.

Per SharePoint 2016 e SharePoint 2019, i pacchetti indipendenti dalla lingua e dipendenti dalla lingua verranno rilevati automaticamente e installati.

*Aggiornamento della farm di SharePoint 2019 tramite PowerShell*

Invece di impiegare ore per l’esecuzione, gli aggiornamenti dovrebbero essere installati in meno di un’ora.

*Aggiornamento della farm di SharePoint 2019 tramite PowerShell* (installazione completata)

Potrebbe essere necessario riavviare il server.

Riavvia il server dopo l’installazione degli aggiornamenti cumulativi

Eseguire prodotti SharePoint e configurazione guidata

Per completare il processo di aggiornamento della farm, è necessario assicurarsi che, dopo aver installato correttamente gli aggiornamenti, si esegua la procedura guidata di configurazione e prodotti SharePoint che assicurerà quanto segue:

Lo schema del database per tutti i database di SharePoint viene aggiornato alla versione più recente
Copia i file binari richiesti dal percorso di installazione nelle directory _app_bin di tutte le applicazioni web
Corregge le impostazioni di sicurezza sul file system per soddisfare le esigenze di SharePoint
Aggiorna le registrazioni delle funzionalità con SharePoint

Per iniziare, eseguire Prodotti SharePoint e Configurazione guidata e selezionare Sì quando viene richiesto di reimpostare i servizi IIS, Amministrazione SharePoint e Timer SharePoint.

A seconda dell’ambiente, il processo impiegherà alcuni minuti per eseguire i 10 passaggi del processo.

*Prodotti SharePoint e configurazione guidata* (in esecuzione)

Dopo alcuni minuti, la configurazione guidata di Prodotti SharePoint terminerà l’esecuzione, si spera con successo.

*Prodotti SharePoint e configurazione guidata (completata correttamente)*

Dopo aver fatto clic su Fine, verrà avviata automaticamente l’Amministrazione centrale.

*Amministrazione centrale di SharePoint 2019*

Passaggi successivi all’installazione

Per assicurarsi che la farm sia stata aggiornata correttamente, è importante verificare che la pagina Stato aggiornamento database.

*Amministrazione centrale di SharePoint 2019* (stato di aggiornamento dei database: database da aggiornare)d

Se la pagina mostra un database che necessita ancora di aggiornamento (che mostra lo stato “Il database è nell’intervallo di compatibilità ed è consigliato l’aggiornamento”), è necessario seguire alcuni passaggi aggiuntivi.

Questi passaggi devono essere seguiti anche se si verifica l’errore seguente durante l’esecuzione di Prodotti SharePoint e Configurazione guidata, che indica che esiste una mancata corrispondenza tra la versione installata di SharePoint (dopo l’aggiornamento della farm) e la versione dello schema del database.

Per garantire che tutti i database vengano aggiornati correttamente, attenersi alla seguente procedura:

Aggiorna i database del contenuto eseguendo il seguente comando di PowerShell (eseguito con “esegui come amministratore”):

Get-SPContentDatabase | Aggiornamento-SPContentDatabase

Aggiorna i restanti database dei contenuti, eseguendo il seguente comando (nel prompt dei comandi con “esegui come amministratore”):

Psconfig.exe -cmd upgrade -inplace b2b -wait -force

Eseguire di nuovo Prodotti SharePoint e Configurazione guidata (PSCONFIGUI.EXE). Dopo aver eseguito di nuovo Prodotti SharePoint e Configurazione guidata, dovrebbe essere eseguito senza errori.

Per confermare che l’aggiornamento dei database è andato a buon fine, tornare alla pagina Stato aggiornamento database. Dopo i passaggi precedenti, tutti i database di SharePoint sono stati aggiornati correttamente.

*Amministrazione centrale di SharePoint 2019 (stato di aggiornamento dei database: database aggiornati)*

Per assicurarti che il processo di aggiornamento sia stato completato correttamente, vai alla pagina Stato patch e alla pagina Stato aggiornamento.

*Amministrazione centrale di SharePoint 2019 (stato patch)*

*Amministrazione centrale di SharePoint 2019 (stato di aggiornamento)*

Note importanti

Alcune note importanti sull’utilizzo di Prodotti SharePoint e Configurazione guidata (PSCONFIGUI.EXE) e PSCONFIG.EXE (versione a riga di comando):

Non eseguire PSCONFIG.EXE in sostituzione di Prodotti SharePoint e Configurazione guidata (PSCONFIGUI.EXE)
- PSCONFIGUI.EXE è la procedura guidata di configurazione basata sull’interfaccia utente che esegue diverse attività una dopo l’altra dopo l’installazione delle correzioni. È l’opzione preferita per garantire che l’aggiornamento della farm di SharePoint sia completato dopo l’installazione degli aggiornamenti nella farm di SharePoint
- PSCONFIG.EXE è lo strumento da riga di comando che offre agli utenti un controllo granulare su tutte le attività che vengono eseguite e che quindi è spesso più veloce di PSCONFIGUI.EXE ma se utilizzato in modo improprio non renderà necessarie tutte le attività necessarie dopo l’installazione degli aggiornamenti nella farm di SharePoint
- Se vuoi eseguire PSCONFIG.EXE, assicurati di eseguirlo con i parametri corretti: “PSConfig.exe -cmd upgrade -inplace b2b -wait -cmd applicationcontent -install -cmd installfeatures -cmd secureresources -cmd services -install”
  - Sopra, ho utilizzato “Psconfig.exe -cmd upgrade -inplace b2b -wait -force” poiché avevo già utilizzato
    Prodotti SharePoint e Configurazione guidata (PSCONFIGUI.EXE) e l’unica cosa che volevo garantire era che lo schema dei database di SharePoint fosse aggiornato
PSCONFIGUI.EXE deve essere sempre eseguito anche durante l’installazione degli aggiornamenti di sicurezza di SharePoint

Per maggiori dettagli, controlla gli articoli di Stefan Goßner qui e qui .

Risoluzione dei problemi

Durante un aggiornamento possono verificarsi alcuni errori mentre la patch viene convalidata rispetto all’ambiente SharePoint prima che venga avviata l’installazione. Gli errori più comuni sono i seguenti:

“La versione prevista del prodotto non è stata trovata sul sistema” – questo articolo di Stefan Goßner spiega l’errore in dettaglio e cosa può causarlo. Fondamentalmente, SharePoint è in genere composto dai seguenti componenti:
- SharePoint Server o SharePoint Foundation*
- Pacchetto lingua inglese per SharePoint Server o SharePoint Foundation*
- Eventuali pacchetti lingua aggiuntivi per SharePoint Server o SharePoint Foundation*
  
  * – SharePoint Foundation esisteva da SharePoint 2007 a SharePoint 2013 e in SharePoint 2016 e 2019 è disponibile solo SharePoint Server
  
  Per risolvere questo errore, è necessario assicurarsi che tutti i componenti dispongano dello stesso livello di patch. Se uno dei componenti installati ha un livello di patch inferiore o non soddisfa i prerequisiti dell’aggiornamento cumulativo, verrà visualizzato l’errore precedente e non sarà possibile installare l’aggiornamento cumulativo nella farm di SharePoint.
  
  Esempio: installare l’aggiornamento cumulativo di maggio 2019 in una farm di SharePoint 2013 con Service Pack 1 (livello di patch 15.0.4571.1502). I componenti installati hanno i seguenti livelli di patch:
  - SharePoint Server 2013 – 15.0.4571.1502 (Service Pack 1)
  - Pacchetto lingua inglese di SharePoint Server 2013 – 15.0.4571.1502 (Service Pack 1)
  - SharePoint Server 2013 Language Pack portoghese – 15.0.4420.1017 (RTM)
    
    Verrà visualizzato l’errore “La versione prevista del prodotto non è stata trovata nel sistema” poiché uno dei componenti (il Language Pack portoghese) ha un livello di patch inferiore. Per risolvere questo problema, è necessario installare SharePoint Server 2013 Portoghese Language Pack Service Pack 1 (puoi ottenere il link per il download qui )
    
    Per aiutarti a identificare il problema, puoi utilizzare Roiscan che genera un rapporto dettagliato di tutti i componenti di Office installati, inclusi SharePoint e verifica il livello di patch di ciascun componente.
    
    Puoi anche dare un’occhiata a questo articoloche possono aiutarti a garantire che le informazioni su tutte le patch installate siano aggiornate correttamente nel database di configurazione di SharePoint.
“Nessun prodotto installato per la patch contenuta”: può verificarsi se si installa un aggiornamento cumulativo per la versione errata di SharePoint. Il caso più comune è quando si tenta di installare l’aggiornamento cumulativo di SharePoint Foundation 2013 in una farm di SharePoint Server 2013. In questo caso, è sufficiente installare l’aggiornamento cumulativo di SharePoint 2013 Server

Altri errori possono verificarsi durante il tentativo di eseguire Prodotti SharePoint e Configurazione guidata dopo l’installazione della patch:

“La funzionalità è referenziata nel database ma non è installata nella farm corrente”: questo è più comune in uno scenario di aggiornamento della farm (ad esempio: aggiornamento da SharePoint 2013 a SharePoint 2019) ma può verificarsi anche durante l’installazione di un Service Pack di SharePoint o di un aggiornamento cumulativo . Per ulteriori dettagli su questo errore e su come risolverlo, fare clic qui .
“Si è verificato un conflitto di aggiornamento e devi riprovare questa azione.” quando si esegue il seguente comando “Psconfig.exe -cmd upgrade -inplace b2b -wait -force”. Se dai un’occhiata ai log ULS, potresti trovare messaggi come “PSCONFIG.EXE (0x1A8C) UpdatedConcurrencyException: l’oggetto SPUpgradeSession Name=Upgrade-20190531-122515-42 è stato aggiornato da un altro utente. Determina se queste modifiche saranno in conflitto, risolvi eventuali differenze e riapplica la seconda modifica. Questo errore può anche indicare un errore di programmazione causato dall’ottenimento di due copie dello stesso oggetto in un singolo thread.”. Per risolvere questo problema, eseguire il comando seguente:

PSConfig.exe -cmd upgrade -inplace b2b -wait -cmd applicationcontent -install -cmd installfeatures -cmd secureresources

NOTA:Dopo aver risolto questi problemi, per completare il processo, eseguire di nuovo Prodotti SharePoint e Configurazione guidata.

[Update Marzo 2024]
Problematica: Come risolvere ERR_SSL_KEY_USAGE_INCOMPATIBLE

Dopo l’aggiornamento a Edge 121.0.2277.83 la pagina di collegamento allo sharepoint 2019 ha iniziato a dare il seguente errore: ERR_SSL_KEY_USAGE_INCOMPATIBLE.

E’ stato risolto attraverso i seguenti passaggi:

Va creato un nuovo certificato SSL autofirmato tramite PowerShell, utilizzando il seguente comando: New-SelfSignedCertificate -FriendlyName ANY_CERT_NAME -DnsName YOUR_SERVER_PC_NAME -KeyUsage DigitalSignature (la modifica principale qui è il tipo KeyUsage: Gestione IIS non permette di creare self certificati firmati con questo tipo).
Accedere a Gestione IIS e modificare i collegamenti dei tuoi siti SP per utilizzare il certificato appena creato.
Questa guida mostra esattamente come fare: https://docs.tenable.com/identity-exposure/Installation/Content/06_Manage/view-IIS-certificate.htm