Installer SharePoint Server 2010 à l’aide de Windows PowerShell

 

S’applique à : SharePoint Foundation 2010, SharePoint Server 2010

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

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

Vue d’ensemble du processus d’installation

  • Préparer SPModule

  • Préparer SPModule

  • Installer Microsoft SharePoint Server 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 la 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 rationaliser le déploiement en utilisant Windows PowerShell pour installer Microsoft SharePoint Server 2010 conjointement avec d’autres outils d’administrateur pour automatiser les installations sans assistance et configurer la batterie.

Exigences relatives aux serveurs de la batterie

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

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, effectuez les étapes ci-dessous :

  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, de façon qu’aucun script ne puisse ê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 Server 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.

Important

Les commandes suivantes doivent être utilisées uniquement dans le contexte de SPModule et de la procédure de cet article.

  1. Install-SharePoint : installe tous les fichiers binaires pour SharePoint Server 2010. Pour plus d’informations, voir Référence de déploiement par script (SharePoint Server 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.

    Pour plus d’informations, voir Référence de déploiement par script (SharePoint Server 2010).

  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 Server 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 Microsoft SharePoint Server 2010 en exécutant Install-SharePoint

Une fois que vous avez déterminé les comptes requis pour l’installation, vous pouvez installer SharePoint Server 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.

Fichier de configuration

Description

Setup\Config.xml

Installation d'un serveur autonome à l'aide de Microsoft SQL Server 2005 Express Edition

SetupFarm\Config.xml

Installation de batterie de serveurs

SetupFarmSilent\Config.xml

Installation d'une batterie de serveurs en mode silencieux

SetupFarmUpgrade\Config.xml

Mise à niveau sur place d'une batterie existante

SetupSilent\Config.xml

Installation d’un serveur autonome à l’aide de SQL Server 2005 Express Edition en mode silencieux

SetupSingleUpgrade\Config.xml

Mise à niveau sur place d'une installation mono-serveur existante

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 Server 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 <nom et chemin d’accès au fichier> -ConfigXml <nom et chemin d’accès au 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.

Important

Utilisez un éditeur de texte, tel que le Bloc-notes, pour modifier le fichier Config.xml. N’utilisez pas un éditeur XML à usage général tel que Microsoft Office Word 2007. Pour vérifier que votre fichier XML est bien formé, utilisez un navigateur pris en charge quelconque.

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" -PIDKey "PVRYW-RRP8H-FG6G2-YGMQW-3V9VX" -ServerRole "SINGLESERVER"

  • Pour un déploiement de batterie :Install-SharePoint -SetupExePath "<drive letter>:\SharePoint 2010\Setup\setup.exe" -PIDKey "PVRYW-RRP8H-FG6G2-YGMQW-3V9VX"

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"-PIDKey "PVRYW-RRP8H-FG6G2-YGMQW-3V9VX" -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"-PIDKey "PVRYW-RRP8H-FG6G2-YGMQW-3V9VX"

Configurer la batterie à l’aide de New-SharePointFarm

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

Configurer SharePoint Server 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 Server 2010.

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

  • À l’invite de commandes Windows PowerShell, tapez la commande suivante :

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

    Où :

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

    • <PSCredential> est le DOMAINE\mot_de_passe 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 Server 2010 sur tous les serveurs de la batterie avant de créer des sites.

Avertissement

N’exécutez pas les commandes New-SharePointFarm et Join-SharePointFarm simultanément sur plusieurs ordinateurs, car des conflits et des comportements imprévisibles peuvent se produire.

Notes

Si l’une des ces commandes échoue, consultez les fichiers journaux de configuration après l’installation. Ces fichiers se trouvent dans %COMMONPROGRAMFILES%\Microsoft shared\Web server extensions\14\Logs et peuvent être identifiés grâce à leur nom qui commence par PowerShell_ConfigurationDiagnostics et par l’extension du nom de fichier .log.

Notes

Les applets de commande Windows PowerShell mentionnées dans cette section doivent être exécutées depuis SharePoint 2010 Management Shell.

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 commande Windows 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. Utilisez l’exemple suivant comme guide.

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, tapez la commande suivante :

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

    Où :

    • <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.

Notes

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.

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 des applications de service et des services (SharePoint Server 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, tapez la commande suivante :

    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.

Notes

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.

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 une liste complète de modèles courants dans SharePoint Server 2010, voir la Référence de déploiement par script (SharePoint Server).

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.

Notes

Si vous souhaitez créer une base de données de contenu avec le nouveau site, utilisez l’applet de commande New-SPContentDatabase ou l’applet de commande New-SPSite avec le paramètre ContentDatabase.

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 Server 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 Server 2010 de mapper les requêtes Web aux applications et sites Web corrects et permettent à SharePoint Server 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 Server 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 Server 2010) :

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

Où :

  • <String> est le nom du serveur de base 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 Server 2010 avant que le problème ne se produise.

Par défaut, SharePoint Server 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 Server 2010).