• Articolo

Script di configurazione di PowerShell (PowerPivot per SharePoint)

Questo argomento è destinato agli amministratori di servizi o di farm di SharePoint che distribuiscono o gestiscono server tramite script di PowerShell. Per istruzioni sull'utilizzo di Amministrazione centrale SharePoint 2010 per eseguire queste attività, vedere Configurazione (PowerPivot per SharePoint).

Se SQL Server PowerPivot per SharePoint è stato installato in un server SharePoint esistente già configurato o già membro di una farm, il programma di installazione di SQL Server non creerà né modificherà servizi o applicazioni SharePoint da utilizzare con la distribuzione di PowerPivot per SharePoint. Per completare la distribuzione, è necessario eseguire le attività di configurazione. Tutte le attività post-installazione possono essere eseguite tramite script. In questo argomento vengono forniti un modello e istruzioni per l'utilizzo e l'esecuzione dello script.

In questo argomento sono contenute le sezioni seguenti:

Prerequisiti

Modalità di esecuzione dei comandi

Distribuire la soluzione PowerPivot

Attivare la caratteristica di PowerPivot

Creare un'applicazione del servizio PowerPivot

Avviare Claims nel Servizio token Windows

Abilitare e configurare Excel Services

Abilitare il servizio di archiviazione sicura e configurare l'aggiornamento dati

Aumentare le dimensioni massime di caricamento per un'applicazione Web

Prerequisiti

È necessario essere un amministratore locale e un amministratore di farm per eseguire i comandi inclusi in questo argomento.

Modalità di esecuzione dei comandi

In questo argomento i comandi di PowerShell sono suddivisi in sezioni per la configurazione di aspetti specifici di una distribuzione PowerPivot per SharePoint. È possibile eseguire ciascun blocco di comandi nella Shell di gestione SharePoint 2010 oppure posizionarli in file con estensione ps1.

Per eseguire ogni comando singolarmente

  1. Nel gruppo di programmi dei prodotti Microsoft SharePoint 2010 fare clic con il pulsante destro del mouse su Shell di gestione SharePoint 2010 e selezionare Esegui come amministratore.

  2. Verificare di disporre di autorizzazioni sufficienti immettendo il comando seguente nella shell. Il comando deve restituire un elenco di comandi PowerShell supportati da Excel Services:

    get-help *SPExcel*

Per eseguire un file con estensione ps1

In alternativa, è possibile combinare gli script in un singolo file ps1 e configurare tutte le impostazioni in una sola operazione. Se si procede in questo modo, è necessario modificare temporaneamente i criteri di esecuzione per eseguire script non firmati. Nei passaggi seguenti viene descritto come eseguire questa procedura.

  1. Aprire la console di gestione di SharePoint 2010 con le autorizzazioni di amministratore.

  2. Eseguire il comando seguente per determinare i criteri di esecuzione. Dopo aver completato la distribuzione di PowerPivot per SharePoint, sarà necessario reimpostare su questo valore i criteri di esecuzione.

    Get-ExecutionPolicy

  3. Eseguire il comando seguente per modificare temporaneamente i criteri di esecuzione per consentire script non firmati. Digitare S per confermare l'azione.

    Set-ExecutionPolicy Unrestricted

  4. Immettere il nome file completo per eseguire lo script. Ad esempio, se lo script è stato salvato in un file denominato PowerPivotConfig.ps1, immettere la riga seguente, quindi premere INVIO per eseguire lo script.

    C:\Scripts-ps1\PowerPivotConfig.ps1

  5. Reimpostare i criteri di esecuzione sul valore originale nel passaggio 2. Digitare S per confermare l'azione.

    Set-ExecutionPolicy restricted

Per copiare valori dalla finestra di PowerShell

Alcune delle procedure contenute in questo argomento richiedono la copia di ID dalla finestra di PowerShell. Se non si conosce già la modalità di esecuzione di tale operazione, utilizzare le istruzioni seguenti.

  1. Aprire la console di gestione di SharePoint 2010 con le autorizzazioni di amministratore.

  2. Immettere un comando che restituisca un GUID (ad esempio, Get-SPServiceInstance).

  3. Fare clic sull'icona di PowerShell nell'angolo superiore sinistro della finestra.

  4. Scegliere Modifica e fare clic su Contrassegno.

  5. Evidenziare un ID con il cursore.

  6. Fare clic nuovamente sull'icona di PowerShell, scegliere Modifica e fare clic su Copia. L'ID a questo punto viene archiviato negli Appunti. È possibile incollarlo in altre istruzioni del comando che utilizzano l'ID come valore di parametro.

Distribuire la soluzione PowerPivot

PowerPivot per SharePoint include una soluzione globale e una soluzione a livello di applicazione che devono essere distribuite prima di creare un'applicazione del servizio PowerPivot. La soluzione globale viene distribuita tramite il programma di installazione di SQL Server. La soluzione a livello di applicazione deve essere distribuita dopo l'installazione. È necessario eseguire questo script per ogni applicazione Web SharePoint che supporterà l'integrazione delle caratteristiche di PowerPivot.

Le istruzioni riportate nell'argomento seguente Distribuire soluzioni PowerPivot rappresentano un'alternativa a questo script.

Install-SPSolution -Identity PowerPivotWebApp.wsp -AllWebApplications -GACDeployment

Attivare la caratteristica

L'attivazione della caratteristica di PowerPivot è obbligatoria per ogni raccolta siti. Questo script specifica la raccolta siti radice di un'applicazione Web SharePoint denominata "somesite". Sostituire "somesite" con il nome effettivo dell'applicazione Web. Si noti che se sono state create raccolte siti aggiuntive (ad esempio, un sito denominato PowerPivot), l'URL sarebbe http://somesite/PowerPivot.

Le istruzioni riportate nell'argomento seguente Attivare l'integrazione delle caratteristiche di PowerPivot per le raccolte siti rappresentano un'alternativa a questo script.

Enable-SPFeature -Identity "PowerPivotSite" -URL http://somesite/

Nota

È possibile utilizzare il comando Get-SPFeature per visualizzare un elenco di tutte le caratteristiche della farm, del Web e con ambito sito. L'esecuzione di questo comando mostra il nome e l'ID sia della caratteristica della farm di PowerPivot sia della caratteristica della raccolta siti PowerPivot.

Creare un'applicazione del servizio PowerPivot

La creazione di un'applicazione del servizio PowerPivot fornisce un endpoint HTTP al servizio di sistema PowerPivot. Nella farm deve essere presente almeno un'applicazione del servizio PowerPivot che deve essere membro del gruppo di proxy predefinito

Si noti che questo script utilizza il pool di applicazioni del servizio predefinito come identità del servizio per l'applicazione del servizio PowerPivot. Si noti inoltre che questo script include un segnaposto per il server database della farm. Assicurarsi di sostituire la stringa 'nome del server database' con il nome dell'istanza del motore di database di SQL Server che ospita il database di configurazione per la farm.

Prima di eseguire lo script, verificare che il server database sia configurato per consentire connessioni TCP/IP remote. È possibile utilizzare lo strumento di configurazione di SQL Server per abilitare TCP/IP qualora non sia già stata eseguita tale operazione.

Le istruzioni riportate nell'argomento seguente Creare e configurare un'applicazione del servizio PowerPivot rappresentano un'alternativa a questo script.

New-PowerPivotServiceApplication -ServiceApplicationName "Default PowerPivot Service Application" -DatabaseServerName "your database server name goes here" -DatabaseName DefaultPowerPivotServiceApplicationDB -AddToDefaultProxyGroup

Avviare Claims nel Servizio token Windows

Claims nel Servizio token Windows deve essere in esecuzione su ogni server SharePoint con PowerPivot per SharePoint installato.

Le istruzioni riportate nell'argomento seguente Installare PowerPivot per SharePoint in un server SharePoint esistente rappresentano un'alternativa a questo script.

  1. Eseguire il comando seguente per ottenere l'ID di Claims nel Servizio token Windows:

    Get-SPServiceInstance

  2. Copiare l'ID restituito per il servizio.

  3. Immettere il comando seguente utilizzando l'ID per specificare il servizio.

    Start-SPServiceInstance <ID>

  4. Eseguire di nuovo Get-SPServiceInstance per verificare che Claims nel Servizio token Windows sia online.

  5. Ripetere su ogni server SharePoint con PowerPivot per SharePoint installato.

Abilitare e configurare Excel Services

Excel Services esegue il rendering lato server delle cartelle di lavoro di Excel pubblicate in SharePoint. PowerPivot per SharePoint dipende da Excel Services per attivare le richieste di dati PowerPivot e per eseguire il rendering di dati PowerPivot come tabelle pivot o altri oggetti dati in un foglio di lavoro.

Le istruzioni riportate nell'argomento seguente Installare PowerPivot per SharePoint in un server SharePoint esistente rappresentano un'alternativa a questo script.

Raggruppare le informazioni e verificare i prerequisiti

  1. Eseguire il comando seguente per verificare se Servizi di calcolo Excel sia online. In caso contrario, avviare il servizio utilizzando lo stesso approccio adottato per l'avvio di Claims nel Servizio token Windows.

    Get-SPServiceInstance

  2. Eseguire il comando seguente per verificare se un'applicazione del servizio Excel Services sia già abilitata. Se un'applicazione del servizio esiste già, ignorare i comandi per crearla; tuttavia, eseguire i comandi che abilitano l'accesso a dati esterni, aumentare le dimensioni massime delle cartelle di lavoro e disattivare gli avvisi di aggiornamento dati.

    Get-SPExcelServiceApplication

  3. Ottenere il nome del pool di applicazioni che verrà utilizzato per creare l'applicazione del servizio. Nello script che segue verrà utilizzato il pool di applicazioni predefinite dei servizi Web di SharePoint. Tuttavia, è possibile eseguire il comando seguente da determinare se gli altri pool di applicazioni sono più appropriati.

    Get-SPServiceApplicationPool

Creare l'applicazione del servizio e il proxy dell'applicazione del servizio.

New-SPExcelServiceApplication -name "Excel Services Application" –ApplicationPool "SharePoint Web Services Default"
New-SPExcelServiceApplicationProxy -name "Excel Services Application Proxy" –ServiceApplication "Excel Services Application" -DefaultProxyGroup

Configurare l'applicazione del servizio

Questo script aumenta le dimensioni massime della cartella di lavoro, abilita l'accesso a dati esterni e disattiva gli avvisi di aggiornamento dati.

Set-SPExcelFileLocation -Identity 'http://' -ExcelServiceApplication "Excel Services Application" -ExternalDataAllowed 2 -WorkbookSizeMax 2000 -WarnOnDataRefresh:$false

Aggiungere l'applicazione del servizio al gruppo di proxy dell'applicazione del servizio predefinito

  1. Ottenere l'ID del proxy dell'applicazione del servizio per l'applicazione Excel Services e copiare l'ID.

    Get-SPServiceApplicationProxy

  2. Aggiungere l'ID del proxy dell'applicazione del servizio al gruppo di proxy predefinito, sostituendo "serviceAppId" con l'ID effettivo copiato dalla finestra di PowerShell.

    $ProxyGroup = Get-SPServiceApplicationProxygroup -default
Add-SPServiceApplicationProxyGroupMember -Identity $ProxyGroup -Member "serviceAppId"

Abilitare il servizio di archiviazione sicura e configurare l'aggiornamento dati

Il servizio di archiviazione sicura è una risorsa SharePoint utilizzata per archiviare le credenziali. PowerPivot per SharePoint utilizza il servizio di archiviazione sicura per supportare le operazioni di aggiornamento dati basate sulle credenziali archiviate o a cui viene fatto riferimento.

Nota importanteImportante

L'esecuzione dei comandi contenuti in questa sezione è sufficiente per abilitare alcune opzioni di aggiornamento dati PowerPivot. In particolare, gli utenti possono immettere le proprie credenziali per eseguire il processo di aggiornamento dati o digitare l'ID del servizio di archiviazione sicura di un'applicazione di destinazione predefinita che fornisce le credenziali. Questo script non crea né imposta l'account di aggiornamento dati automatico di PowerPivot. L'utente corrente può sviluppare tale script o configurare l'account in Amministrazione centrale. Per ulteriori informazioni, vedere Configurare e utilizzare le credenziali archiviate per l'aggiornamento dati PowerPivot.

Raggruppare le informazioni e verificare i prerequisiti

Eseguire il comando seguente per verificare se il servizio di archiviazione sicura sia online. In caso contrario, avviare il servizio utilizzando lo stesso approccio adottato per l'avvio di Claims nel Servizio token Windows.

Get-SPServiceInstance

Creare l'applicazione del servizio

Assicurarsi di sostituire il valore del segnaposto per il server database.

New-SPSecureStoreServiceapplication -Name "Secure Store Service" -partitionmode:$false -sharing:$false -databaseserver "Your database server" -databasename "SecureStoreServiceAppDB" -ApplicationPool "SharePoint Web Services Default" -auditingEnabled:$true -auditlogmaxsize 30

Creare il proxy dell'applicazione del servizio e aggiungerlo al gruppo di proxy predefinito

  1. Ottenere l'ID dell'applicazione del servizio per i servizi di archiviazione sicura e copiare l'ID.

    Get-SPServiceApplication

  2. Eseguire il comando seguente, sostituendo l'<ID> con l'ID dell'applicazione del servizio copiato nel passaggio precedente:

    New-SPSecureStoreServiceApplicationProxy -name "Secure Store Service Proxy" -ServiceApplication <ID> -defaultproxygroup

Generare la chiave master

  1. Impostare una variabile per la chiave master.

    $newPassPhrase='type a strong password here'

  2. Copiare l'ID del proxy dell'applicazione del servizio di archiviazione sicura che verrà utilizzato nel prossimo passaggio.

    Get-SPServiceApplicationProxy

  3. Impostare una variabile per il proxy dell'applicazione del servizio.

    $proxy='paste the ID for the secure store service application proxy here'

  4. Eseguire i comandi seguenti in ordine sequenziale:

    Update-SpSecureStoreMasterKey -ServiceApplicationProxy $proxy -PassPhrase $newPassPhrase
Update-SpSecureStoreApplicationServerKey -ServiceApplicationProxy $proxy -PassPhrase $newPassPhrase

Configurare la raccolta dati di utilizzo e integrità

Questo script abilita la raccolta dati di utilizzo e integrità del server nella quale sono raggruppate le informazioni sull'utilizzo del sistema. Lo script specifica un intervallo della raccolta dati di 5 minuti che risulta più frequente del valore predefinito di 30 minuti. L'abilitazione della raccolta dati di utilizzo fornisce informazioni utilizzate nei report predefiniti, incluse quelle nel dashboard di gestione PowerPivot.

Le istruzioni riportate nell'argomento seguente Configurare la raccolta dati di utilizzo (PowerPivot per SharePoint) rappresentano un'alternativa a questo script.

Set-SPUsageService -UsageLogCutTime 5

Riconfigurare le dimensioni massime di caricamento per l'applicazione Web predefinita

Per impostazione predefinita, SharePoint consente di caricare file con dimensioni massime di 50 megabyte. Questo script imposta le dimensioni di caricamento file massime per l'applicazione Web SharePoint su 2047 megabyte, ovvero il valore massimo supportato da SharePoint.

Immettere ognuna delle righe seguenti in ordine sequenziale. La prima riga ottiene l'applicazione Web, la seconda imposta la proprietà mentre la terza aggiorna la proprietà sul server. Assicurarsi di sostituire il valore del segnaposto "somesite" con il nome effettivo dell'applicazione. È possibile utilizzare Get-SPWebApplication per restituire un elenco di applicazioni definite nella farm.

Le istruzioni riportate nell'argomento seguente Configurare le dimensioni massime di caricamento dei file (PowerPivot per SharePoint) rappresentano un'alternativa a questo script.

$webapplication=Get-SPWebApplication http://somesite/
$webapplication.MaximumFileSize=2047
$webapplication.Update()