• Article

Administration des produits SharePoint 2010 à l’aide de Windows PowerShell

 

S’applique à : SharePoint Foundation 2010

Dernière rubrique modifiée : 2017-01-18

Cet article décrit comment utiliser Windows PowerShell avec Produits Microsoft SharePoint 2010 et fournit une vue d’ensemble des concepts et applets de commande Windows PowerShell de base nécessaires pour tirer le meilleur parti de cette puissante fonctionnalité.

Dans cet article :

  • Présentation

  • Accès à Windows PowerShell pour les produits SharePoint 2010 à l’aide de SharePoint 2010 Management Shell

  • Autorisations

  • Formation à Windows PowerShell

Présentation

Windows PowerShell est un outil d’écriture de scripts en ligne de commande qui offre aux administrateurs un accès complet aux interfaces de programmation d’applications (API) applicables, ainsi que la possibilité de déverrouiller la capacité à interagir directement avec les Produits SharePoint 2010 pour manipuler des applications Web, des collections de sites, des sites, des listes, et ainsi de suite. De plus, l’administrateur a la possibilité d’écrire des scripts d’applets de commande, ce qui améliore l’expérience par rapport aux versions précédentes du produit.

Windows PowerShell 2,0 est une condition préalable à l’installation des Produits SharePoint 2010. Il est installé si nécessaire lorsque vous exécutez l’Outil de préparation des produits Microsoft SharePoint. Par défaut, Windows PowerShell se trouve à l’emplacement suivant : <%SystemRoot%>\System32\WindowsPowerShell\v1.0\PowerShell.exe.

Notes

Windows PowerShell 2,0 offre une compatibilité descendante avec Windows PowerShell 1.0 et s’installe par conséquent dans le dossier v1.0.

Pour obtenir une liste des nouvelles fonctionnalités pour Windows PowerShell version 2.0, voir À propos de Windows PowerShell 2.0 (https://go.microsoft.com/fwlink/?linkid=113247&clcid=0x40C).

Nous vous recommandons d’utiliser Windows PowerShell pour les tâches d’administration en ligne de commande. L’outil en ligne de commande Stsadm a été abandonné, mais il est inclus pour assurer la compatibilité avec les versions précédentes.

Accès à Windows PowerShell pour les produits SharePoint 2010 à l’aide de SharePoint 2010 Management Shell

Une fois les produits SharePoint 2010 installés, les applets de commande Windows PowerShell applicables sont accessibles à l’aide de SharePoint 2010 Management Shell ou de la console Windows PowerShell. Avec Management Shell, il est possible de gérer tous les aspects des Produits SharePoint 2010. Vous pouvez créer des collections de sites, des applications Web, des comptes d’utilisateurs, des applications de service, des proxys, et bien d’autres choses encore. Les commandes de Management Shell génèrent des objets SharePoint basés sur la plateforme Microsoft .NET. Ces objets peuvent être appliqués comme entrées de commandes ultérieures ou stockés dans des variables locales pour une utilisation ultérieure.

Avec Management Shell, il n’est pas nécessaire d’enregistrer le composant logiciel enfichable qui contient les applets de commande. L’enregistrement du module Microsoft.SharePoint.PowerShell.dll pour les applets de commande SharePoint 2010 s’effectue automatiquement à cause de la ligne Add-PSSnapin Microsoft.SharePoint.PowerShell dans le fichier SharePoint.ps1 situé dans %CommonProgramFiles%\Microsoft Shared\Web Server Extensions\14\Config\PowerShell\Registration. Si vous choisissez d’utiliser la console Windows PowerShell, vous devez enregistrer ce composant logiciel enfichable manuellement.

Que vous ayez recours à Management Shell ou à la console Windows PowerShell, vous pouvez également charger des composants logiciels enfichables supplémentaires. Pour plus d’informations, voir La puissance des profils (https://go.microsoft.com/fwlink/?linkid=183166&clcid=0x40C).

Pour accéder à SharePoint 2010 Management Shell

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

  2. Cliquez sur Produits Microsoft SharePoint 2010.

  3. Cliquez sur SharePoint 2010 Management Shell.

Notes

SharePoint 2010 Management Shell et la console Windows PowerShell diffèrent également dans l’utilisation de l’option ReuseThread, qui définit le mode d’utilisation du modèle de threading. L’utilisation de Management Shell est définie par cette ligne, {Host.Runspace.ThreadOptions = "ReuseThread"}, qui figure dans le fichier SharePoint.ps1. Pour plus d’informations, voir Énumération PSThreadOptions (éventuellement en anglais) (https://go.microsoft.com/fwlink/?linkid=183145&clcid=0x40C).

Autorisations

Pour pouvoir utiliser Management Shell set les applets de commande Windows PowerShell, vérifiez que vous disposez de la configuration minimale requise suivante : Voir Add-SPShellAdmin.

Si vous n’êtes pas membre du rôle SharePoint_Shell_Access ou du groupe local WSS_Admin_WPG, utilisez l’applet de commande Add-SPShellAdmin. Lorsque l’applet de commande Add-SPShellAdmin est utilisée, l’utilisateur est ajouté au groupe WSS_Admin_WPG dans tous les serveurs Web frontaux et ajouté au rôle SharePoint_Shell_Access. Si la base de données cible ne dispose pas d’un rôle SharePoint_Shell_Access, le rôle est créé automatiquement. Après l’exécution de l’applet de commande Add-SPShellAdmin, l’utilisateur peut exécuter des applets de commande Windows PowerShell SharePoint 2010 dans un environnement de batterie à serveurs multiples.

Lorsque vous exécutez l’applet de commande Add-SPShellAdmin pour ajouter un utilisateur au rôle SharePoint_Shell_Access, vous devez disposer des autorisations de sécurité suivantes :

  • Accès au rôle de serveur Securityadmin sur l’instance SQL et rôle db_owner dans une base de données.

  • Autorisation administrative sur l’ordinateur local.

Notes

En général, la personne qui utilisera l’applet de commande Add-SPShellAdmin doit être associée au compte d’utilisateur qui a servi à exécuter le programme d’installation.

Vous devez exécuter l’applet de commande Add-SPShellAdmin pour toutes les bases de données auxquelles vous voulez accorder l’accès. Si aucune base de données n’est spécifiée, la base de données de configuration de la batterie de serveurs est utilisée. Si vous spécifiez une base de données, la base de données de contenu de la batterie sera incluse en plus de la base de données de configuration de la batterie que vous spécifiez.

Pour consulter la liste de toutes les applets de commande *SPShellAdmin, à partir d’une invite de commandes Windows PowerShell, tapez Get-Command -Noun SPShellAdmin.

Formation à Windows PowerShell.

Il existe plusieurs ressources de formation à Windows PowerShell destinées aux professionnels de l’informatique SharePoint qui désirent se familiariser avec Windows PowerShell.

Centre de scripts TechNet

Le Centre de scripts TechNet contient de nombreuses ressources pour l’apprentissage des notions de base de Windows PowerShell. Il contient également des référentiels de scripts avec des exemples de scripts couramment utilisés avec différents produits Microsoft. Le tableau suivant indique les principales ressources de formation.

Page Description

Documentation Windows PowerShell sur TechNet (https://go.microsoft.com/fwlink/?linkid=187813&clcid=0x40C)

Cette section de la bibliothèque TechNet contient des copies Web des rubriques principales Get-Help de Windows PowerShell. Elle propose également des copies Web du document de Mise en route avec Windows PowerShell, de l’aide de PowerShell.exe, ainsi qu’un document de présentation de Windows PowerShell.

Génération de scripts avec Windows PowerShell (https://go.microsoft.com/fwlink/?linkid=187815&clcid=0x40C)

Page d’accueil des ressources de formation à l’écriture de scripts Windows PowerShell.

Manuel de l’utilisation de Windows PowerShell (éventuellement en anglais) (https://go.microsoft.com/fwlink/?linkid=187817&clcid=0x40C)

Guide de démarrage de Windows PowerShell basé sur le Web.

Référence rapide de Windows PowerShell (éventuellement en anglais) (https://go.microsoft.com/fwlink/?linkid=187819&clcid=0x40C)

Copie téléchargeable du document Référence rapide installé avec Windows PowerShell.

Documents Windows PowerShell

Windows PowerShell installe les documents suivants dans le groupe de programmes Windows PowerShell 1.0. Ils peuvent également être installés après le téléchargement du Pack de documentation de Windows PowerShell 1.0 (éventuellement en anglais) (https://go.microsoft.com/fwlink/?linkid=187822&clcid=0x40C).

Fichier Description

GettingStarted.rtf

Décrit comment commencer à utiliser Windows PowerShell.

UsersGuide.rtf

Introduction à l’environnement et au langage Windows PowerShell.

QuadFold.rtf

Document de référence rapide imprimable relatif à la syntaxe et aux commandes Windows PowerShell courantes. Également disponible en tant que téléchargement à partir du Centre de scripts TechNet.

Lors de la consultation de ces ressources, sachez qu’il est préférable de se familiariser avec les concepts et applets de commande suivants avant d’utiliser Windows PowerShell pour les produits SharePoint 2010 :