Installer SharePoint Foundation 2010 à l’aide de Windows PowerShell

S’applique à : SharePoint Foundation 2010

Dernière rubrique modifiée : 2016-11-30

Cet article explique comment effectuer une nouvelle installation de Microsoft SharePoint Foundation 2010 sur un serveur autonome ou sur une batterie de serveurs à l’aide de Windows PowerShell.

Dans cet article :

• Exigences relatives aux serveurs de la batterie

• Préparer SPModule

• Installer SharePoint Foundation 2010 en exécutant Install-SharePoint

• Configurer la batterie à l’aide de New-SharePointFarm

• Créer une application Web à l’aide de Windows PowerShell

• Déployer des services à l’aide de l’Assistant Configuration de batterie SharePoint 2010

• Créer une collection de sites à l’aide de Windows PowerShell

• Effectuer des tâches de configuration supplémentaires

• Ajouter des serveurs à la batterie à l’aide de Join-SharePointFarm

• Configurer le journal de suivi

Vous pouvez simplifier le déploiement en faisant appel à Windows PowerShell pour installer Microsoft SharePoint Foundation 2010 et à d’autres outils administrateur pour automatiser des installations sans assistance et configurer la batterie.

Exigences relatives aux serveurs de la batterie

Avant d’installer SharePoint Foundation 2010, passez en revue les informations suivantes qui décrivent les autorisations, les configurations matérielle et logicielle requises et les étapes à effectuer avant de démarrer le processus.

1. Assurez-vous que toutes les conditions requises pour le matériel et les logiciels sont remplies. Vous devez avoir une version 64 bits de Windows Server 2008 ou de Windows Server 2008 R2. Pour les batteries de serveurs, vous devez aussi avoir une version 64 bits de SQL Server 2005 ou de SQL Server 2008. For more information about these requirements (such as specific updates that you must install), see Determine hardware and software requirements (SharePoint Foundation 2010).

2. Assurez-vous que vous êtes prêt à configurer les comptes nécessaires avec les autorisations appropriées. For detailed information, see Administrative and service accounts required for initial deployment (SharePoint Foundation 2010).

Préparer SPModule

Le fichier SPModule.zip est un module Windows PowerShell écrit par les membres du Groupe de produit SharePoint qui installe une batterie SharePoint.

Pour utiliser le fichier SPModule.zip, procédez comme suit :

1. Téléchargez le fichier SPModule.zip et le fichier texte depuis la page suivante du Centre de téléchargement (éventuellement en anglais) (https://go.microsoft.com/fwlink/?linkid=187924&clcid=0x40C).

2. Extrayez les fichiers dans un dossier nommé SPModule, puis ajoutez ce dossier à votre chemin d’accès d’environnement. La variable d’environnement PSModulePath sert à stocker les chemins d’accès aux emplacements des modules qui sont installés sur disque. Pour afficher les chemins d’accès spécifiés dans la variable PSModulePath, depuis une invite de commandes Windows PowerShell, tapez $env:PSModulePath. Pour plus d’informations, voir Variable d’environnement PSModule (éventuellement en anglais) (https://go.microsoft.com/fwlink/?linkid=187757&clcid=0x40C). Après l’extraction, le dossier SPModule doit contenir deux fichiers : SPModule.misc et SPModule.setup.

   Notes

   Si le dossier SPModule n’est pas ajouté à la variable PSModulePath, vous devez spécifier un chemin d’accès complet pour charger SPModule.

3. Déterminez le type de signature à fournir.

   Notes

   Les fichiers de téléchargement ne sont pas signés. Pour fournir des scripts auto-signés, voir AllSigned : signature de vos scripts PowerShell (éventuellement en anglais) (https://go.microsoft.com/fwlink/?linkid=187758&clcid=0x40C).

   Par défaut, la stratégie d’exécution Windows PowerShell a la valeur Restreinte, ce qui signifie qu’aucun script ne peut être exécuté. Pour modifier une stratégie d’exécution, exécutez l’applet de commande Set-ExecutionPolicy. Pour plus d’informations sur l’exécution de stratégies, voir About_Signing (https://go.microsoft.com/fwlink/?linkid=187759&clcid=0x40C).

4. Chargez les fichiers SPModule.misc et SPModule.setup dans Windows PowerShell.

   1. Cliquez sur Démarrer, pointez sur Tous les programmes, puis cliquez sur Windows PowerShell V2. Une fois la fenêtre d’invite de commandes Windows PowerShell ouverte, la première chose à faire est d’ajouter le chemin d’accès au module à votre chemin d’accès de module Windows PowerShell (en supposant que vous avez créé un dossier nommé « SPModule » sur votre serveur) :

   2. Cliquez avec le bouton droit sur Windows PowerShell V2, puis cliquez sur Exécuter en tant qu’administrateur.

      Notes

      Si Microsoft SharePoint Foundation 2010 est déjà installé, vous pouvez ouvrir SharePoint 2010 Management Shell à la place.

   3. Une fois la fenêtre Invite de commandes affichée, il faut importer le module dans la session Windows PowerShell actuelle et l’ajouter à un chemin d’accès en tapant la syntaxe suivante depuis une invite de commandes Windows PowerShell :

      Import-Module SPModule.misc
      
      Import-Module SPModule.setup
      

Lors de l’importation du module SPModule.misc, vous appellerez une vérification de mise à jour. Dans la version 1.0, cette vérification examine un fichier texte pour déterminer si une nouvelle version est disponible. Si c’est le cas, vous pouvez la télécharger. Une fois les commandes Import-Module exécutées avec succès, vous êtes prêt à utiliser SPModule.

1. Install-SharePoint : installe tous les fichiers binaires pour SharePoint Foundation 2010. Pour plus d’informations, voir Référence de déploiement par script (SharePoint Foundation 2010).

2. New-SharePointFarm : crée une batterie SharePoint et effectue les tâches associées suivantes :

   • configuration de la sécurité ;

   • création d’une application Web de services partagés que vous pouvez remplir avec des applications de service ;

   • création et configuration du site Web Administration centrale ;

   • installation de tous les fichiers d’aide du produit ;

   • installation de toutes les fonctionnalités de batterie.

3. Join-SharePointFarm : ajoute des serveurs à la batterie, puis les configure. Pour plus d’informations, voir Référence de déploiement par script (SharePoint Foundation 2010).

Une fois Windows PowerShell version 2.0 installé, vous pouvez utiliser une nouvelle fonctionnalité de Windows PowerShell appelée Communication à distance (Remoting). Grâce à cette fonctionnalité et à quelques lignes de code Windows PowerShell, un administrateur peut installer à distance plusieurs serveurs dans une batterie. Pour plus d’informations sur la Communication à distance et SPModule, voir Installation à distance avec SPModule (éventuellement en anglais) (https://go.microsoft.com/fwlink/?linkid=187923&clcid=0x40C).

Installer SharePoint Foundation 2010 en exécutant Install-SharePoint

Une fois que vous avez déterminé les comptes requis pour l’installation, vous pouvez installer SharePoint Foundation 2010. Le DVD du produit contient des exemples de fichiers de configuration (Config.xml). Ces exemples sont stockés dans le dossier \Files du répertoire racine du DVD, dans des dossiers qui correspondent aux différents scénarios. Ils sont décrits dans le tableau suivant.

Pour exécuter Install-SharePoint avec un fichier Config.xml à une invite de commandes Windows PowerShell

1. Sur le lecteur où se trouve le DVD du produit SharePoint Foundation 2010, accédez au répertoire racine pour rechercher le fichier Setup.exe.

2. Exécutez SPModule.Setup Install-SharePoint avec le fichier Config.xml sélectionné, comme suit :

   Install-SharePoint -SetupExePath <chemin d’accès et nom du fichier> -ConfigXml <chemin d’accès et nom du fichier>

   Notes

   Vous pouvez sélectionner un des fichiers d’exemples ou personnaliser votre propre fichier de configuration.

3. Appuyez sur Entrée.

L’installation est alors terminée.

L’exemple suivant illustre le fichier de configuration pour installer un seul serveur en mode silencieux (SetupSilent).

<Configuration><Package Id="sts">  <Setting Id="LAUNCHEDFROMSETUPSTS" Value="Yes" />  </Package><Package Id="spswfe">  <Setting Id="SETUPCALLED" Value="1" />  </Package>  <Logging Type="verbose" Path="%temp%" Template="SharePoint Server Setup(*).log" />- <!--<PIDKEY Value="Enter Product Key Here" />  -->  <Display Level="none" CompletionNotice="no" />  <Setting Id="SERVERROLE" Value="APPLICATION" />  <Setting Id="USINGUIINSTALLMODE" Value="0" />  <Setting Id="SETUP_REBOOT" Value="Never" />  <Setting Id="SETUPTYPE" Value="CLEAN_INSTALL" />  </Configuration>

Vous pouvez également personnaliser votre propre fichier de configuration. Pour contrôler les options d’installation, commencez par modifier le fichier Config.xml dans un éditeur de texte afin d’y inclure les éléments souhaités ainsi que leurs paramètres. Exécutez ensuite Install-SharePoint -SetupExePath -ConfigXML pour exécuter Setup.exe en utilisant les options définies dans Config.xml.

Options de configuration typiques :

• Ignorez l’invite qui demande la clé du produit en fournissant celle-ci comme une valeur, <PIDKEY Value="Enter PID Key Here" />, dans le fichier Config.xml.

• Ajoutez un emplacement pour un fichier journal, <Logging Type="off" | "standard"(default) | "verbose" Path="path" Template="file name.log"/>, que vous pouvez afficher en cas d’échec de l’installation depuis la ligne de commande.

Exécuter Install-SharePoint à l’aide d’une clé PID

Pour exécuter le programme d’installation en mode silencieux sans utiliser de fichier de configuration, tapez l’une des commandes suivantes à une invite de commandes Windows PowerShell :

• Pour un serveur autonome : Install-SharePoint -SetupExePath "<drive letter>:\SharePoint 2010\Setup\setup.exe" -ServerRole "SINGLESERVER"

• Pour un déploiement de batterie : Install-SharePoint -SetupExePath "<drive letter>:\SharePoint 2010\Setup\setup.exe"

Pour exécuter le programme d’installation en mode silencieux à l’aide d’un fichier de configuration, tapez l’une des commandes suivantes à une invite de commandes Windows PowerShell :

• Pour un serveur autonome : Install-SharePoint -SetupExePath "G:\SharePoint 2010\Setup\setup.exe" -ConfigXML "G:\SharePoint 2010\Setup\Config\singleserver_config.xml" -ServerRole "SINGLESERVER"

• Pour un déploiement de batterie : Install-SharePoint -SetupExePath "G:\SharePoint 2010\Setup\setup.exe" -ConfigXML "G:\SharePoint 2010\Setup\Config\appserver_config.xml"

Configurer la batterie à l’aide de New-SharePointFarm

Vous utilisez la commande New-SharePointFarm pour configurer SharePoint Foundation 2010 après l’exécution de la commande Install-SharePoint. Les options de configuration sont différentes selon que vous installez SharePoint Foundation 2010 sur un serveur autonome ou sur une batterie de serveurs.

Configurer SharePoint Foundation 2010 sur un serveur autonome

Dans les déploiements de serveur autonome, vous pouvez exécuter New-SharePointFarm. Après vous être connecté à l’aide du compte d’utilisateur du programme d’installation que vous avez créé et configuré auparavant, vous configurez SharePoint Foundation 2010.

Pour configurer SharePoint Foundation 2010 sur un serveur autonome à l’aide de New-SharePointFarm

• À l’invite de commandes Windows PowerShell (PS C:\>), tapez la commande suivante, puis appuyez sur Entrée :

  New-SharePointFarm -DatabaseServer <String> -DatabaseAccessAccount <(Get-Credential domain\account)> -FarmName <string>
  

  Où :

  • <String> est le nom du serveur de bases de données. Par exemple, « SQL01 ».

  • <PSCredential> est le DOMAIN\password du compte d’utilisateur qui effectue l’installation.

  • <String> est le nom de la batterie. Par exemple, « Batterie1 »

La commande New-SharePointFarm décrit les étapes de configuration au fur et à mesure de leur déroulement et signale si la configuration est réussie. Pour une installation de serveur autonome, il s’agit de l’étape finale de l’installation en ligne de commande.

Nous recommandons vivement d’installer et de configurer SharePoint Foundation 2010 sur tous les serveurs de la batterie avant de créer des sites.

Pour établir une connexion à une base de données de configuration existante et joindre le serveur à une batterie de serveurs existante, l’applet de commande Connect–SPConfigurationDatabase doit être exécutée avec les applets de commandeWindows PowerShell suivantes, dans cet ordre :

• Install-SPHelpCollection

• Initialize-SPResourceSecurity

• Install-SPService

• Install-SPFeature -AllExistingFeatures

• Install-SPApplicationContent

Créer une application Web à l’aide de Windows PowerShell

Utilisez l’applet de commande New-SPWebApplication pour créer l’application Web et une nouvelle base de données de contenu.

Pour créer une application Web

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. À l’invite de commandes Windows PowerShell (PS C:\>), tapez la commande suivante, puis appuyez sur Entrée :

   New-SPWebApplication -ApplicationPool <String> -Name 
   <InternetSite>
    -ApplicationPoolAccount (Get-SPManagedAccount 
   <DOMAIN\UserName>
   

   Où :

   • <String> est le nom du pool d’applications. Par exemple, « SharePoint -80 ».

   • <InternetSite> est le nom de l’application Web.

   • Domain\UserName est le nom du compte de pool d’applications.

Pour plus d’informations, voir New-SPWebApplication.

Déployer des services à l’aide de l’Assistant Configuration de batterie la SharePoint 2010

Utilisez l’Assistant Configuration des produits SharePoint pour déployer des services sur votre installation. Pour plus d’informations sur les services et les applications de service, voir Gérer les applications de service et les services (SharePoint Foundation 2010).

Créer une collection de sites à l’aide de Windows PowerShell

Vous pouvez créer une collection de sites de niveau supérieur à l’aide de l’applet de commande New-SPSite. L’applet de commande New-SPSite crée une collection de sites à une URL spécifique avec un utilisateur spécifié comme propriétaire de site.

Pour créer une collection de sites

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. À l’invite de commandes Windows PowerShell (PS C:\>), tapez la commande suivante, puis appuyez sur Entrée :

   New-SPSite 
   <SiteURL>
    -OwnerAlias 
   <DOMAIN\UserName>
   

   Où :

   • <SiteURL> est l’URL du nouveau site.

   • <DOMAIN\UserName> est le nom de connexion d’utilisateur du propriétaire de site.

Pour plus d’informations, voir New-SPSite.

Si vous ne spécifiez pas le modèle de site à utiliser, les propriétaires de sites peuvent choisir le modèle lors de leur première navigation vers le site. Vous pouvez utiliser l’applet de commande Get-SPWebTemplate pour afficher une liste de modèles.

Pour obtenir la liste complète des modèles courants dans SharePoint Foundation 2010, voir Référence de déploiement par script (SharePoint Foundation 2010)

Si vous souhaitez créer des collections de sites supplémentaires à l’aide de Windows PowerShell, vous pouvez utiliser l’applet de commande New-SPSite.

Après avoir créé des sites, vous pouvez configurer des mappages des accès de substitution. Ceux-ci dirigent les utilisateurs vers l’URL correcte lorsqu’ils interagissent avec SharePoint Foundation 2010 (lors de l’accès à la page d’accueil d’un site SharePoint, par exemple). Les mappages des accès de substitution permettent à SharePoint Foundation 2010 de mapper les requêtes Web aux applications et sites Web corrects et permettent à SharePoint Foundation 2010 de restituer le contenu approprié à l’utilisateur. Pour plus d’informations, voir Set-SPAlternateUrl.

Effectuer des tâches de configuration supplémentaires

Une fois que vous avez installé SharePoint Foundation 2010, nous vous recommandons d’effectuer les tâches administratives suivantes :

• configurer les paramètres de courrier électronique sortant ;

• configurer les paramètres de flux de travail ;

• configurer les paramètres de journalisation des diagnostics ;

• configurer les paramètres antivirus.

Ajouter des serveurs à la batterie à l’aide de Join-SharePointFarm

Vous devez exécuter la commande Join-SharePointFarm sur tous les serveurs que vous souhaitez ajouter à la batterie. Pour établir une connexion à une base de données de configuration existante et joindre le serveur à une batterie de serveur existante, tapez la commande suivante sur le serveur (après avoir installé SharePoint Foundation 2010) :

Join-SharePointFarm -DatabaseServer 
<String>
 -ConfigurationDatabaseName 
<String>
 -Passphrase 
<SecureString>

Où :

• <String> est le nom du serveur de bases de données, par exemple SQL01.

• <SecureString> est le mot de passe du compte d’utilisateur au format DOMAINE\mot_de_passe.

Configurer le journal de suivi

Le journal de suivi peut être utile pour l’analyse des problèmes susceptibles de se produire. Vous pouvez utiliser les événements qui sont écrits dans le journal de suivi pour déterminer quelles modifications de configuration ont été apportées dans SharePoint Foundation 2010 avant que le problème ne se produise.

Par défaut, SharePoint Foundation 2010 enregistre 14 jours d’événements dans les fichiers journaux de suivi. Cela signifie que les fichiers journaux de suivi qui contiennent des événements antérieurs à 14 jours sont supprimés. Vous pouvez utiliser l’applet de commande Set-SPLogLevel pour configurer toute la journalisation des diagnostics.

Vous pouvez utiliser la page Journalisation des diagnostics dans l’Administration centrale pour configurer le nombre maximal de fichiers journaux de suivi à gérer et la durée (en minutes) de capture des événements dans chaque fichier journal.

Vous pouvez également spécifier l’emplacement où les fichiers journaux sont enregistrés ou accepter le chemin d’accès par défaut à l’aide de l’applet de commande Set-SPLogLevel.

Les fichiers journaux de suivi peuvent vous aider à résoudre les problèmes liés aux modifications de la configuration du service Recherche de Microsoft SharePoint Foundation. Comme ce type de problème n’est pas toujours détecté immédiatement, il est recommandé d’enregistrer tous les fichiers journaux de suivi créés par le système le jour où vous apportez des modifications de configuration. Stockez ces fichiers journaux pendant un certain temps dans un emplacement sûr qui ne sera pas remplacé. Il est conseillé de stocker ces fichiers sur une partition de disque dur dédiée exclusivement au stockage des fichiers journaux.

Pour plus d’informations sur la journalisation des diagnostics, voir Configurer la journalisation des diagnostics (SharePoint Foundation 2010).