Gérer Excel Services à l’aide de Windows PowerShell

 

S’applique à : Excel Services (SharePoint 2010), SharePoint Server 2010

Dernière rubrique modifiée : 2010-07-26

Cette rubrique offre une vue d’ensemble du comportement de Windows PowerShell pour Excel Services dans Microsoft SharePoint Server 2010. Les administrateurs d’Excel Services peuvent utiliser Windows PowerShell pour créer des scripts qui assurent la totalité de l’installation, du déploiement et de la définition des options de configuration d’Excel Services, ainsi que de la configuration de tous les paramètres pendant l’exécution dans le cadre de déploiements de Microsoft SharePoint Server 2010. Windows PowerShell dans Excel Services suit les mêmes conventions d’affectation de noms, style et directives de comportement que ceux utilisés avec les autres applications de service. SharePoint Server fournit la ligne de commande Windows PowerShell pour la réalisation des actions d’administration pour Excel Services.

Windows PowerShell pour Excel Services

Un utilisateur doit être membre du rôle d’administrateur global et également administrateur local pour exécuter des commandes Windows PowerShell (applets de commande) sur un ordinateur. En règle générale, toutes les applets de commande Windows PowerShell contrôlent des objets en mémoire et les applets de commande Set écrivent des valeurs de propriété dans le magasin de données configdb lié au service.

Avertissement

La commande stsadm n’est pas prise en charge dans Excel Services. Si une commande stsadm est utilisée, elle échoue et un message d’erreur est retourné à l’invite de commandes.

Toutes les applets de commande Windows PowerShellExcel Services prennent en charge les commandes Windows PowerShell générales. Les administrateurs peuvent enchaîner les commandes à l’aide de la barre verticale (|), obtenir de l’aide sur chaque commande, utiliser des alias pour les commandes, filtrer les résultats, autoriser l’utilisation du paramètre whatif et recourir à des procédures de vérification, ainsi qu’utiliser des variables et des paramètres avec les commandes. Pour plus d’informations sur les commandes Windows PowerShell, voir applets de commande pour Excel Services (SharePoint Server 2010).

Exemples d’applets de commande pour Excel Services

Cette section montre comment ouvrir SharePoint 2010 Management Shell pour exécuter les exemples d’applets de commande Excel Services pour Excel Services.

Pour ouvrir SharePoint 2010 Management Shell

  1. Vérifiez que vous disposez de la configuration minimale requise suivante : Voir Add-SPShellAdmin.

  2. Dans le menu Démarrer, cliquez sur Tous les programmes.

  3. Cliquez sur Produits Microsoft SharePoint 2010.

  4. Cliquez sur SharePoint 2010 Management Shell.

  5. Depuis l’invite de commandes Windows PowerShell (PS C:\>), tapez les exemples de commandes suivants, puis appuyez sur Entrée :

  • Mise en service d’une nouvelle application Excel Services portant le nom « MyExcelServer »
    New-SPExcelServiceApplication -Name "MyExcelServer"

  • Attribution de la valeur 100 au nombre maximal de sessions par utilisateur pour tous les ordinateurs distants qui, dans cette batterie de serveurs, exécutent une instance d’Excel Services :
    Get-SPExcelServiceApplication | Set-SPExcelServiceApplication -SessionsPerUserMax 100

  • Pour MyExcelServer, obtenir tous les emplacements approuvés et, pour ceux qui autorisent le chargement des données à partir de classeurs, les obliger à utiliser la bibliothèque de connexions de documents (DCL) uniquement
    Get-SPExcelServiceApplication -Identity "MyExcelServer" | Get-SPExcelFileLocation | where {$_.ExternalDataAllowed -eq "DclAndEmbedded" } | Set-SPExcelFileLocation -ExternalDataAllowed Dcl

  • Rendre accessibles les classeurs dans les emplacements de fichiers approuvés (et les connexions de données dans les bibliothèques de connexions de données approuvées) dans les domaines par les composants WebPart, les pages Web ou les services Web. Exécutez l’applet de commande Windows PowerShell. Les exemples de commandes suivants fonctionnent pour toutes les applications Excel Services dans votre batterie de serveurs SharePoint Server:
    Pour définir sur true :
    Get-SPExcelServiceApplication | Set-SPExcelServiceApplication -CrossDomainAccessAllowed
    Pour définir sur false :
    Get-SPExcelServiceApplication | Set-SPExcelServiceApplication -CrossDomainAccessAllowed:$false
    Pour vérifier :
    (Get-SPExcelServiceApplication).CrossDomainAccessAllowed