Script de configuration PowerShell (PowerPivot pour SharePoint)
Cette rubrique est destinée aux administrateurs de batteries de serveurs ou de services SharePoint qui déploient ou maintiennent des serveurs par le biais d'un script PowerShell. Pour obtenir des instructions sur l'utilisation de l'Administration centrale de SharePoint 2010 pour effectuer ces mêmes tâches, consultez Configuration (PowerPivot pour SharePoint).
Si vous avez installé SQL Server PowerPivot pour SharePoint sur un serveur SharePoint existant, déjà configuré ou membre d'une batterie de serveurs, le programme d'installation de SQL Server ne créera ou ne modifiera pas de services ou d'applications SharePoint pour fonctionner avec votre déploiement de PowerPivot pour SharePoint. Pour terminer le déploiement, vous devez effectuer les tâches de configuration vous-même. Toutes les tâches consécutives à l'installation peuvent être effectuées via un script. Cette rubrique fournit un modèle et des instructions pour l'utilisation et l'exécution du script.
Cette rubrique contient les sections suivantes :
Configuration requise
Comment exécuter les commandes
Déployer la solution PowerPivot
Activer les fonctionnalités PowerPivot
Créer une application de service PowerPivot
Activer le service d'émission de jetons Revendications vers Windows
Activer et configurer Excel Services
Activer le service Banque d'informations sécurisé et configurer l'actualisation des données
Augmenter la taille maximale du téléchargement pour une application Web
Configuration requise
Vous devez être administrateur local et administrateur de batterie de serveurs pour exécuter les commandes dans cette rubrique.
Comment exécuter les commandes
Les commandes PowerShell dans cette rubrique sont organisées en sections sur la configuration d'aspects spécifiques d'un déploiement PowerPivot pour SharePoint. Vous pouvez exécuter chaque bloc de commande individuellement dans SharePoint 2010 Management Shell, ou les placer dans des fichiers .ps1.
Pour exécuter chaque commande individuellement
Dans le groupe de programmes Produits Microsoft SharePoint 2010, cliquez avec le bouton droit sur SharePoint 2010 Management Shell et sélectionnez Exécuter en tant qu'administrateur.
Recherchez des autorisations suffisantes en entrant la commande suivante dans le shell. La commande doit retourner une liste de commandes PowerShell prises en charge par Excel Services :
get-help *SPExcel*
Pour exécuter un fichier .ps1
Vous pouvez aussi combiner les scripts dans un fichier .ps1 unique et configurer tous les paramètres en une seule opération. Si vous procédez ainsi, vous devez modifier temporairement la stratégie d'exécution pour exécuter des scripts non signés. Les étapes suivantes expliquent comment procéder.
Ouvrez la console de gestion SharePoint 2010 avec des autorisations d'administrateur.
Exécutez la commande suivante pour déterminer la stratégie d'exécution. Ultérieurement, lorsque vous aurez terminé le déploiement PowerPivot pour SharePoint, vous réinitialiserez la stratégie d'exécution pour revenir à cette valeur.
Get-ExecutionPolicyExécutez la commande suivante pour modifier temporairement la stratégie d'exécution afin d'autoriser les scripts non signés. Tapez Y pour confirmer l'action.
Set-ExecutionPolicy UnrestrictedEntrez le nom de fichier qualifié complet pour exécuter le script. Par exemple, si vous avez enregistré votre script dans un fichier nommé PowerPivotConfig.ps1, vous devez entrer la ligne suivante puis appuyer sur ENTRÉE pour exécuter le script.
C:\Scripts-ps1\PowerPivotConfig.ps1Réinitialisez la stratégie d'exécution à la valeur d'origine de l'étape 2. Tapez Y pour confirmer l'action.
Set-ExecutionPolicy restricted
Pour copier des valeurs à partir de la fenêtre PowerShell
Quelques procédures de cette rubrique vous demandent de copier des ID à partir de la fenêtre PowerShell. Si vous ne savez pas comment procéder, suivez les instructions suivantes.
Ouvrez la console de gestion SharePoint 2010 avec des autorisations d'administrateur.
Entrez une commande qui retourne un GUID (par exemple, Get-SPServiceInstance)
Cliquez sur l'icône PowerShell dans l'angle supérieur gauche de la fenêtre.
Pointez sur Modifier et cliquez sur Marque.
À l'aide du curseur, mettez en surbrillance un ID.
Recliquez sur l'icône PowerShell, pointez sur Modifier et cliquez sur Copie. L'ID est maintenant stocké dans le presse-papiers. Vous pouvez le coller dans d'autres instructions de commande qui utilisent l'ID comme une valeur de paramètre.
Déployer une solution PowerPivot
PowerPivot pour SharePoint inclut une solution globale et une solution au niveau de l'application qui doivent être déployées avant de créer une application de service PowerPivot. La solution globale est déployée par le programme d'installation de SQL Server. La solution au niveau de l'application doit être déployée après l'installation. Vous devez exécuter ce script pour chaque application Web SharePoint qui prendra en charge la fonctionnalité d'intégration PowerPivot.
Une alternative à ce script est d'utiliser les instructions dans la rubrique suivante : Déployer des solutions PowerPivot.
Install-SPSolution -Identity PowerPivotWebApp.wsp -AllWebApplications -GACDeployment
Activer la fonctionnalité
L'activation de la fonctionnalité PowerPivot est requise pour chaque collection de site. Ce script spécifie la collection de sites racine d'une application Web SharePoint nommée « somesite ». Remplacez « somesite » par le nom réel de votre application Web. Notez que si vous avez créé des collections de sites supplémentaires (par exemple, un site nommé PowerPivot), l'URL doit être http://somesite/PowerPivot.
Une alternative à ce script est d'utiliser les instructions dans la rubrique suivante : Activer la fonctionnalité d'intégration PowerPivot pour des collections de sites.
Enable-SPFeature -Identity "PowerPivotSite" -URL http://somesite/
Notes
Vous pouvez utiliser la commande Get-SPFeature pour consulter une liste de toutes les fonctionnalités étendues à la batterie de serveur, au Web et au site. L'exécution de cette commande vous indique le nom et l'ID de la fonctionnalité de batterie de serveurs PowerPivot et la fonctionnalité de collection de sites PowerPivot.
Créer une application de service PowerPivot
La création d'une application de service PowerPivot fournit un point de terminaison HTTP au service système PowerPivot. Vous devez disposer dans la batterie de serveurs d'au moins une application de service PowerPivot, qui doit être membre du groupe de proxy par défaut.
Notez que ce script utilise le pool d'applications de service par défaut comme identité de service pour l'application de service PowerPivot. Remarquez également que ce script inclut un espace réservé pour le serveur de base de données de la batterie de serveurs. Veillez à remplacez la chaîne 'Emplacement du nom du serveur de base de données' par le nom de l'instance du moteur de la base de données SQL Server qui héberge la base de données de configuration de la batterie.
Avant d'exécuter le script, vérifiez que le serveur de base de données est configuré pour autoriser des connexions TCP/IP distantes. Vous pouvez utiliser l'outil de configuration SQL Server pour activer TCP/IP, si vous ne l'avez pas déjà fait.
Une alternative à ce script est d'utiliser les instructions dans la rubrique suivante : Créer et configurer une application de service PowerPivot.
New-PowerPivotServiceApplication -ServiceApplicationName "Default PowerPivot Service Application" -DatabaseServerName "your database server name goes here" -DatabaseName DefaultPowerPivotServiceApplicationDB -AddToDefaultProxyGroup
Activez le service d'émission de jetons Revendications vers Windows.
Le service d'émission de jetons Revendications vers Windows doit s'exécuter sur chaque serveur SharePoint sur lequel PowerPivot pour SharePoint est installé.
Une alternative à ce script est d'utiliser les instructions dans la rubrique suivante : Installer PowerPivot pour SharePoint sur un serveur SharePoint existant.
Exécutez la commande suivante pour obtenir l'ID du service d'émission de jetons Revendications vers Windows :
Get-SPServiceInstanceCopiez l'ID retourné pour le service.
Entrez la commande suivante, à l'aide de l'ID pour spécifier le service.
Start-SPServiceInstance <ID>Exécutez encore Get-SPServiceInstance pour vérifier que le service d'émission de jetons Revendications vers Windows est en ligne.
Répétez l'opération sur chaque serveur SharePoint sur lequel PowerPivot pour SharePoint est installé.
Activer et configurer Excel Services
Excel Services effectue le rendu côté serveur des classeurs Excel que vous publiez sur SharePoint. PowerPivot pour SharePoint dépend d'Excel Services pour déclencher des demandes de données PowerPivot et restituer les données PowerPivot sous forme de tableaux croisés dynamiques ou d'autres objets de données dans une feuille de travail.
Une alternative à ce script est d'utiliser les instructions dans la rubrique suivante : Installer PowerPivot pour SharePoint sur un serveur SharePoint existant.
Rassembler les informations et vérifier les conditions préalables
Exécutez la commande suivante pour vérifier si les services de calcul Excel sont en ligne. S'ils ne le sont pas, démarrez le service selon la même méthode que celle utilisée pour le démarrage du service d'émission de jetons Revendications vers Windows.
Get-SPServiceInstanceExécutez la commande suivante pour vérifier si une application de service Excel Services est déjà activée. Si une application de service existe déjà, ignorez les commandes pour la créer, mais exécutez les commandes qui activent l'accès aux données externes, augmentez la taille de classeurs maximale et désactivez les avertissements d'actualisation des données.
Get-SPExcelServiceApplicationObtenez le nom du pool d'applications que vous utiliserez pour créer l'application de service. Dans le script suivant, vous utiliserez le pool d'applications par défaut des services Web SharePoint. Toutefois, vous pouvez exécuter la commande suivante pour déterminer si d'autres pools d'applications sont plus appropriés.
Get-SPServiceApplicationPool
Créer l'application de service et le proxy d'application de service
New-SPExcelServiceApplication -name "Excel Services Application" –ApplicationPool "SharePoint Web Services Default"
New-SPExcelServiceApplicationProxy -name "Excel Services Application Proxy" –ServiceApplication "Excel Services Application" -DefaultProxyGroup
Configurer l'application de service
Ce script augmente la taille maximale du classeur, permet l'accès à des données externes et désactive les avertissements d'actualisation des données.
Set-SPExcelFileLocation -Identity 'http://' -ExcelServiceApplication "Excel Services Application" -ExternalDataAllowed 2 -WorkbookSizeMax 2000 -WarnOnDataRefresh:$false
Ajoutez l'application de service au groupe de proxy de l'application de service par défaut
Obtenez l'ID du proxy de l'application de service pour l'application Excel Services et copiez l'ID.
Get-SPServiceApplicationProxyAjoutez l'ID du proxy de l'application de service au groupe de proxy par défaut, en remplaçant « serviceAppId » par l'ID réel que vous avez copié depuis la fenêtre PowerShell.
$ProxyGroup = Get-SPServiceApplicationProxygroup -default Add-SPServiceApplicationProxyGroupMember -Identity $ProxyGroup -Member "serviceAppId"
Activer le service Banque d'informations sécurisé et configurer l'actualisation des données
Le service Banque d'informations sécurisé est une ressource SharePoint utilisée pour stocker des informations d'identification. PowerPivot pour SharePoint utilise le service Banque d'informations sécurisé pour prendre en charge des opérations d'actualisation des données basées sur des informations d'identification stockées ou référencées.
Important
L'exécution des commandes de cette section suffit à activer certaines options d'actualisation des données PowerPivot. En particulier, les utilisateurs peuvent entrer leurs propres informations d'identification pour exécuter le travail d'actualisation des données ou taper l'ID SSS d'une application cible prédéfinie qui fournit les informations d'identification. Ce script ne crée ou ne définit pas le compte d'actualisation des données PowerPivot sans assistance. Vous pouvez développer ce script vous-même ou configurer le compte dans l'Administration centrale. Pour plus d'informations, consultez Configurer et utiliser les informations d'identification stockées pour l'actualisation des données PowerPivot.
Rassembler les informations et vérifier les conditions préalables
Exécutez la commande suivante pour vérifier si le Service Banque d'informations sécurisé est en ligne. S'il n'est pas en ligne, démarrez le service selon la même méthode que celle utilisée pour le démarrage du service d'émission de jetons Revendications vers Windows.
Get-SPServiceInstance
Créer l'application de service
Veillez à remplacer la valeur d'espace réservé pour le serveur de base de données.
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
Créez le proxy d'application de service et ajoutez-le au groupe de proxy par défaut
Obtenez l'ID de l'application de service pour les services Banque d'informations sécurisés et copiez l'ID.
Get-SPServiceApplicationExécutez la commande suivante, en remplaçant l' <ID> par l'ID d'application de service que vous avez copié dans l'étape précédente :
New-SPSecureStoreServiceApplicationProxy -name "Secure Store Service Proxy" -ServiceApplication <ID> -defaultproxygroup
Générer la clé principale
Définissez une variable pour la clé principale.
$newPassPhrase='type a strong password here'Copiez l'ID du proxy d'application des services Banque d'informations sécurisés. Vous l'utiliserez à l'étape suivante.
Get-SPServiceApplicationProxyDéfinissez une variable pour le proxy d'application de service.
$proxy='paste the ID for the secure store service application proxy here'Exécutez les commandes suivantes dans l'ordre séquentiel :
Update-SpSecureStoreMasterKey -ServiceApplicationProxy $proxy -PassPhrase $newPassPhrase Update-SpSecureStoreApplicationServerKey -ServiceApplicationProxy $proxy -PassPhrase $newPassPhrase
Configurer la collecte des données d'utilisation et d'intégrité
Ce script active la collecte des données d'utilisation et d'intégrité du serveur qui rassemble des informations sur la manière dont le système est utilisé. Il spécifie un intervalle de collecte de données de 5 minutes, une fréquence supérieure à celle de la valeur par défaut de 30 minutes. L'activation de la collecte des données d'utilisation fournit des informations utilisées dans les rapports intégrés, notamment ceux du tableau de bord de gestion PowerPivot.
Une alternative à ce script est d'utiliser les instructions dans la rubrique suivante : Configurer la collecte des données d'utilisation (PowerPivot pour SharePoint).
Set-SPUsageService -UsageLogCutTime 5
Reconfigurer la taille maximale du téléchargement pour l'application Web par défaut
Par défaut, SharePoint vous permet de télécharger des fichiers d'une taille maximale de 50 mégaoctets. Ce script augmente la taille maximale du téléchargement de fichiers pour l'application Web SharePoint à 2047 mégaoctets. 2047 est la valeur maximale prise en charge par SharePoint.
Entrez chacune des lignes suivantes dans l'ordre séquentiel. La première ligne obtient l'application Web, la deuxième ligne définit la propriété, et la troisième ligne met à jour la propriété sur le serveur. Veillez à remplacer la valeur d'espace réservé « somesite » par le nom réel de votre application. Vous pouvez utiliser Get-SPWebApplication pour retourner une liste des applications définies dans votre batterie de serveurs.
Une alternative à ce script est d'utiliser les instructions dans la rubrique suivante : Configurer la taille maximale de téléchargement de fichiers (PowerPivot pour SharePoint).
$webapplication=Get-SPWebApplication http://somesite/
$webapplication.MaximumFileSize=2047
$webapplication.Update()