Amministrazione di prodotti SharePoint 2010 tramite Windows PowerShell

 

Si applica a: SharePoint Foundation 2010

Ultima modifica dell'argomento: 2017-01-18

In questo articolo viene illustrato come utilizzare Windows PowerShell con i Prodotti Microsoft SharePoint 2013 e viene presentata una panoramica dei concetti e dei cmdlet di base di Windows PowerShell che è necessario conoscere per sfruttare al meglio questa potente funzionalità.

Contenuto dell'articolo:

  • Panoramica

  • Accesso a Windows PowerShell per i prodotti SharePoint 2010.

  • Autorizzazioni

  • Apprendimento dell'utilizzo di Windows PowerShell

Panoramica

Windows PowerShell è uno strumento di scripting da riga di comando che offre a un amministratore l'accesso completo alle API (Application Programming Interface), oltre alla possibilità di sbloccare la funzionalità per interagire direttamente con i Prodotti SharePoint 2010 e modificare applicazioni Web, raccolte siti, elenchi e altro ancora. L'amministratore può inoltre creare cmdlet (pronunciato "command-let") per ottimizzare l'amministrazione rispetto alle versioni precedenti del prodotto.

Windows PowerShell 2,0 è un componente prerequisito per l'installazione di Prodotti SharePoint 2010. Se necessario, verrà installato al momento dell'esecuzione dell'Utilità preparazione prodotti Microsoft SharePoint. Per impostazione predefinita, Windows PowerShell è disponibile nel percorso seguente: <%SystemRoot%>\System32\WindowsPowerShell\v1.0\PowerShell.exe.

Nota

Windows PowerShell 2,0 è compatibile con Windows PowerShell 1.0 e di conseguenza viene installato nella cartella v1.0.

Per un elenco delle nuove funzionalità di Windows PowerShell versione 2.0, vedere about_Windows_PowerShell_2.0 (https://go.microsoft.com/fwlink/?linkid=113247&clcid=0x410).

Per l'esecuzione di attività amministrative dalla riga di comando è consigliabile utilizzare Windows PowerShell. Lo strumento da riga di comando Stsadm è deprecato, ma è stato incluso per garantire la compatibilità con le versioni precedenti del prodotto.

Accesso a Windows PowerShell per i prodotti SharePoint 2010.

Dopo aver installato i prodotti SharePoint 2010, i cmdlet di Windows PowerShell applicabili saranno disponibili tramite Shell di gestione SharePoint 2010 o la console Windows PowerShell. Con Shell di gestione è possibile gestire tutti gli aspetti dei Prodotti SharePoint 2010. È possibile creare nuove raccolte siti, applicazioni Web, account utente, applicazioni di servizio, proxy e quant'altro. I comandi di Shell di gestione generano come output oggetti di SharePoint basati sulla piattaforma Microsoft .NET. Tali oggetti possono essere applicati come input per i comandi successivi o archiviati in variabili locali per essere utilizzati in un secondo momento.

Con Shell di gestione non è necessario registrare lo snap-in contenente i cmdlet. La registrazione del modulo Microsoft.SharePoint.PowerShell.dll per i cmdlet di SharePoint 2010 è automatica e deriva dalla riga Add-PSSnapin Microsoft.SharePoint.PowerShell nel file SharePoint.ps1 disponibile in %CommonProgramFiles%\Microsoft Shared\Web Server Extensions\14\Config\PowerShell\Registration. Se si sceglie di utilizzare la console Windows PowerShell, sarà necessario registrare manualmente tale snap-in.

Sia che si utilizzi Shell di gestione sia la console Windows PowerShell, è inoltre possibile caricare snap-in aggiuntivi. Per ulteriori informazioni, vedere Personalizzazione dei profili (https://go.microsoft.com/fwlink/?linkid=183166&clcid=0x410).

Per accedere a Shell di gestione SharePoint 2010

  1. Fare clic sul pulsante Start e scegliere Tutti i programmi.

  2. Fare clic su Prodotti Microsoft SharePoint 2010.

  3. Fare clic su Shell di gestione SharePoint 2010.

Nota

Shell di gestione SharePoint 2010 e la console Windows PowerShell inoltre si differenziano per l'utilizzo dell'opzione ReuseThread, che definisce la modalità di utilizzo del modello di threading. L'utilizzo da parte di Shell di gestione è definito dalla riga {Host.Runspace.ThreadOptions = "ReuseThread"}, inclusa nel file SharePoint.ps1. Per ulteriori informazioni, vedere PSThreadOptions (le informazioni potrebbero essere in lingua inglese) (https://go.microsoft.com/fwlink/?linkid=183145&clcid=0x410).

Autorizzazioni

Prima di poter utilizzare Shell di gestione e i cmdlet di Windows PowerShell, verificare che siano soddisfatti i requisiti minimi seguenti: vedere Add-SPShellAdmin.

Se non si appartiene al ruolo SharePoint_Shell_Access o al gruppo locale WSS_Admin_WPG, utilizzare il cmdlet Add-SPShellAdmin. Quando viene utilizzato il cmdlet Add-SPShellAdmin, l'utente viene aggiunto al gruppo WSS_Admin_WPG in tutti i server Web front-end e al ruolo SharePoint_Shell_Access. Se il database di destinazione non dispone di un ruolo SharePoint_Shell_Access, questo verrà creato automaticamente. Dopo l'esecuzione del cmdlet Add-SPShellAdmin, l'utente può eseguire i cmdlet di Windows PowerShell per SharePoint 2010 in un ambiente farm multiserver.

Quando si esegue il cmdlet Add-SPShellAdmin per aggiungere un utente al ruolo SharePoint_Shell_Access, è necessario disporre delle autorizzazioni di sicurezza seguenti:

  • Accesso al ruolo del server Securityadmin per l'istanza SQL e ruolo db_owner in un database.

  • Autorizzazione amministrativa per il computer locale.

Nota

La persona che eseguirà il cmdlet Add-SPShellAdmin in genere deve essere associata all'account utente utilizzato per l'installazione.

È necessario eseguire il cmdlet Add-SPShellAdmin per tutti i database a cui si desidera concedere l'accesso. Se non si specifica alcun database, verrà utilizzato il database di configurazione della farm. Se invece si specifica un database, oltre al database di configurazione della farm specificato, verrà incluso anche il database del contenuto della farm.

Per visualizzare un elenco di tutti i cmdlet *SPShellAdmin, al prompt dei comandi di Windows PowerShell digitare Get-Command -Noun SPShellAdmin.

Apprendimento dell'utilizzo di Windows PowerShell

Per i professionisti IT SharePoint non esperti nell'utilizzo di Windows PowerShell sono disponibili numerose risorse didattiche a esso relative.

Centro di scripting TechNet

Nel Centro di scripting TechNet sono disponibili diverse risorse per apprendere le nozioni fondamentali per l'utilizzo di Windows PowerShell. Sono inoltre presenti archivi con esempi di script di utilizzo comune con diversi prodotti Microsoft. Nella tabella seguente sono riportate le risorse didattiche principali.

Pagina Descrizione

Documentazione relativa a Windows PowerShell su TechNet (https://go.microsoft.com/fwlink/?linkid=187813&clcid=0x410)

In questa sezione della Libreria TechNet sono disponibili copie Web degli argomenti Get-Help di base di Windows PowerShell. Vengono inoltre fornite copie Web della Guida introduttiva a Windows PowerShell, della Guida di PowerShell.exe e di un documento con le nozioni fondamentali su Windows PowerShell.

Creazione di script con Windows PowerShell (https://go.microsoft.com/fwlink/?linkid=187815&clcid=0x410)

Home page delle risorse didattiche sulla creazione e l'utilizzo di script con Windows PowerShell.

Manuale del proprietario di Windows PowerShell (le informazioni potrebbero essere in lingua inglese) (https://go.microsoft.com/fwlink/?linkid=187817&clcid=0x410)

Guida basata sul Web per iniziare a utilizzare Windows PowerShell.

Guida di riferimento rapido su Windows PowerShell (le informazioni potrebbero essere in lingua inglese) (https://go.microsoft.com/fwlink/?linkid=187819&clcid=0x410)

Copia scaricabile del documento di riferimento rapido installato con Windows PowerShell.

Documenti relativi a Windows PowerShell

Con Windows PowerShell vengono installati i documenti seguenti nel gruppo di programmi Windows PowerShell 1.0. Tali documenti possono inoltre essere installati dopo il download di Windows PowerShell 1.0 Documentation Pack (le informazioni potrebbero essere in lingua inglese) (https://go.microsoft.com/fwlink/?linkid=187822&clcid=0x410).

File Descrizione

GettingStarted.rtf

Documento in cui viene illustrato come iniziare a utilizzare Windows PowerShell.

UsersGuide.rtf

Documento con le nozioni fondamentali sull'ambiente e sul linguaggio Windows PowerShell.

QuadFold.rtf

Documento di riferimento rapido stampabile per la sintassi e i comandi di Windows PowerShell di utilizzo comune. Anche scaricabile dal Centro di scripting TechNet.

Man mano che si consultano tali risorse, tenere presente che è utile acquisire familiarità con i concetti e i cmdlet seguenti prima di utilizzare Windows PowerShell per i prodotti SharePoint 2010: