Guide de référence de la ligne de commande de l’Assistant Configuration des produits et technologies SharePoint (Windows SharePoint Services)

Mise à jour : 2008-09-18

Dans les produits et technologies SharePoint, vous pouvez utiliser l’outil de ligne de commande psconfig.exe comme interface de substitution pour réaliser un certain nombre d’opérations de configuration des produits et technologies SharePoint. Vous devez être membre du groupe Administrateurs sur l’ordinateur local pour réaliser ces opérations.

Dans cet article

  • Comment utiliser les commandes de l’outil psconfig.exe

  • Commandes et paramètres disponibles

Comment utiliser les commandes de l’outil psconfig.exe

Lorsque vous exécutez l’outil psconfig.exe à partir de la ligne de commande, vous pouvez spécifier des commandes pour contrôler l’exécution de l’outil. Pour exécuter psconfig.exe à partir de la ligne de commande, accédez au dossier %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\bin et tapez les commandes suivantes en utilisant la syntaxe suivante :

Psconfig.exe -cmd <command> [optional parameters]

Le tableau de référence de la section suivante offre plusieurs exemples. Une documentation d’aide est également disponible à partir de l’interface de ligne de commande. Pour afficher l’Aide, tapez la commande suivante dans la ligne de commande :

psconfig.exe -?

Pour obtenir de l’aide sur une commande particulière, tapez la commande suivante :

psconfig.exe -help <command name>

Les commandes de psconfig.exe doivent être exécutées dans un ordre spécifique pour pouvoir fonctionner correctement. Si vous utilisez l’Assistant Configuration des produits et technologies SharePoint pour configurer votre installation, celui-ci appelle les commandes (également appelées « tâches de configuration ») dans l’ordre correct. En revanche, si vous utilisez la ligne de commande pour exécuter psconfig.exe, il vous appartient de vérifier l’ordre d’exécution des tâches. Les commandes de l’outil psconfig.exe doivent être exécutées dans l’ordre suivant :

  1. configdb

  2. helpcollections

  3. secureresources

  4. services

  5. installfeatures

  6. adminvs

  7. evalprovision (installations autonomes uniquement)

  8. applicationcontent

  9. upgrade

ImportantImportant :

Si l’outil psconfig.exe détecte que la batterie de serveurs doit faire l’objet d’une mise à niveau, il lance automatiquement une mise à niveau lorsqu’il est exécuté, et ce, même si vous n’avez pas spécifié la commande upgrade.

Vous pouvez placer toutes les commandes dans une même chaîne de ligne de commande de manière à les exécuter en une seule opération. Dans cette situation, psconfig.exe exécute l’ensemble des commandes dans l’ordre correct. Par exemple, vous pouvez exécuter une commande semblable à la commande suivante dans la ligne de commande :

psconfig.exe –cmd configdb <parameters>
–cmd helpcollections <parameters>
–cmd secureresources <parameters>
–cmd services <parameters>
–cmd installfeatures <parameters>
–cmd adminvs <parameters>
–cmd evalprovision <parameters>
–cmd applicationcontent <parameters>

Pour plus d’informations sur la configuration du serveur ou de la batterie de serveurs à partir de la ligne de commande, consultez le site TechCenter de Windows SharePoint Services.

Commandes et paramètres disponibles

Les options de ligne de commande suivantes sont reconnues dans l’Assistant Configuration des produits et technologies SharePoint.

Commande Description, paramètres et exemples

?

Affiche les commandes utilisables avec l’outil psconfig.exe.

Exemple

psconfig.exe -?

help <command name>

Affiche les commandes utilisables avec l’outil psconfig.exe. Si un nom de commande est spécifié, l’aide de cette commande est affichée.

Exemple

psconfig.exe -help adminvs

adminvs

Gère l’application Web Administration centrale de SharePoint sur l’ordinateur local. Les paramètres suivants sont facultatifs :

[-provision]

Met en service l’application Web Administration centrale de SharePoint sur ce serveur. La mise en service crée une application Web Administration centrale de SharePoint et un pool d’applications utilisant le compte de l’administrateur de la batterie de serveurs.

[-unprovision]

Annule la mise en service de l’application Web Administration centrale de SharePoint sur ce serveur. L’annulation de la mise en service supprime le serveur virtuel de l’application Web Administration centrale de SharePoint et le pool d’applications associé.

[-port <port number>]

Le port de l’application Web Administration centrale de SharePoint est un paramètre global qui s’applique à la batterie de serveurs. Lorsque le port est modifié, un travail du service du minuteur SharePoint est distribué de manière à synchroniser le port pour toutes les applications Web Administration centrale de SharePoint de la batterie de serveurs. Si le port n’est pas spécifié, le port utilisé pour les applications Web Administration centrale de SharePoint existantes de la batterie de serveurs est utilisé. Si une application Web Administration centrale de SharePoint n’a pas été mise en service dans la batterie de serveurs et qu’aucun port n’est spécifié, le port par défaut est choisi de façon aléatoire.

[-windowsauthprovider <enablekerberos | onlyusentlm>]

Le fournisseur d’authentification de l’application Web Administration centrale de SharePoint est un paramètre global qui s’applique à la batterie de serveurs. Lorsque le fournisseur d’authentification est modifié, un travail du service du minuteur SharePoint est distribué de manière à synchroniser le fournisseur d’authentification pour toutes les applications Web Administration centrale de SharePoint de la batterie de serveurs. Si le paramètre onlyusentlm est spécifié, l’authentification NTLM sera le seul et unique fournisseur d’authentification utilisé par les applications Web Administration centrale de SharePoint. Les autres fournisseurs d’authentification sont alors désactivés et le fournisseur d’authentification NTLM devient le seul fournisseur autorisé. Si le paramètre enablekerberos est spécifié, l’authentification Kerberos est activée pour toutes les applications Web Administration centrale de SharePoint. Si aucun fournisseur d’authentification n’est spécifié, le fournisseur utilisé pour les applications Web Administration centrale de SharePoint existantes de la batterie de serveurs est utilisé. Si une application Web Administration centrale de SharePoint n’a pas été mise en service dans la batterie de serveurs et qu’aucun fournisseur d’authentification n’est spécifié, le fournisseur d’authentification Kerberos est activé.

Exemples

psconfig.exe -cmd adminvs -provision -port 8080 -windowsauthprovider onlyusentlm

psconfig.exe -cmd adminvs -unprovision

applicationcontent

Gère le contenu partagé de l’application. Les paramètres suivants sont obligatoires :

-install

Copie les données partagées de l’application (fichiers de ressources, binaires d’application Web) dans les répertoires virtuels existants de l’application Web.

Exemple

psconfig.exe -cmd applicationcontent -install

configdb

Crée, connecte ou déconnecte ce serveur de la batterie de serveurs. Les paramètres suivants facultatifs :

[-create]

Crée une base de données de configuration et une batterie de serveurs. Si ce serveur est déjà connecté à une base de données de configuration, il est tout d’abord déconnecté, puis la nouvelle base de données de configuration est créée.

[-disconnect]

Déconnecte ce serveur de la base de données de configuration et de la batterie de serveurs.

[-connect]

Établit une connexion à une base de données de configuration existante et associe ce serveur à une batterie de serveurs existante. Si ce serveur est déjà connecté à une base de données de configuration, il est tout d’abord déconnecté, puis connecté à la base de données de configuration existante.

[-server <SQLServerName>]

Ordinateur exécutant SQL Server, où se trouve la base de données de configuration.

[-database <SQLDatabaseName>]

Nom de la base de données de configuration.

[-dbuser <value>]

Nom d’utilisateur utilisé pour l’authentification SQL.

[-dbpassword <value>]

Mot de passe utilisé pour l’authentification SQL.

[-user <Domain\User>]

Compte d’utilisateur de l’administrateur de la batterie de serveurs.

[-password <Password>]

Mot de passe du compte d’utilisateur de l’administrateur de la batterie de serveurs.

[-addomain <value>]

Nom de domaine Active Directory utilisé pour la batterie de serveurs.

[-adorgunit <value>]

Nom de l’unité d’organisation Active Directory utilisé pour la batterie de serveurs.

[-admincontentdatabase <SQLAdminContentDatabaseName>]

Nom de la base de données de contenu de l’application Web Administration centrale.

Exemples

psconfig.exe -cmd configdb -create -server <Server_name> -database <Database_name>

-dbuser <DOMAIN\username> -dbpassword <password>

-user <DOMAIN\username> -password <password>

-addomain <domain_name> -adorgunit <org_unit>

-admincontentdatabase <Database_name>

psconfig.exe -cmd configdb -disconnect

psconfig.exe -cmd configdb -connect -server <Server_name> -database <Database_name>

-dbuser <DOMAIN\username> -dbpassword <password>

evalprovision

Met en service ce serveur comme serveur autonome (mode d’évaluation). Prend en compte les paramètres obligatoires et facultatifs suivants :

-provision

Effectue une mise en service en mode autonome sur ce serveur.

[-port <port number>]

Numéro de port affecté à l’application Web SharePoint par défaut. Si ce numéro n’est pas spécifié, le port 80 est utilisé. Si une application Web SharePoint existante utilise ce port, le site existant est remplacé. Si un site existant utilise le port et qu’il ne s’agit pas d’une application Web SharePoint, le site sera désactivé et une nouvelle application Web SharePoint sera créée en utilisant ce port.

[-overwrite]

Spécifie si un éventuel site Web Microsoft Windows SharePoint Services 3.0 existant doit être remplacé lors de l’installation. Si ce paramètre n’est pas spécifié, le site n’est pas supprimé.

Exemple

psconfig.exe -cmd evalprovision -provision -port 1100

helpcollections

Gère les collections d’aide. Les paramètres suivants sont obligatoires :

-installall

Installe toutes les collections d’aide disponibles.

Exemple

psconfig.exe -cmd helpcollections -installall

installfeatures

Inscrit auprès de la batterie de serveurs les fonctions des produits et technologies SharePoint qui se trouvent dans le système de fichiers de ce serveur.

Exemple

psconfig.exe -cmd installfeatures

quiet

Exécute l’Assistant Configuration des produits et technologies SharePoint en mode silencieux. La sortie est écrite dans le fichier journal PSCONFIG.EXE_MM_JJ_AA_HH_MM_SS_MS.log, où « _MM_JJ_AA_HH_MM_SS_MS » correspond à la date et à l’heure complètes d’exécution de l’utilitaire. Le fichier journal est stocké dans le répertoire %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\LOGS.

Exemple

psconfig.exe -cmd quiet

secureresources

Met en application la stratégie de sécurité des ressources des produits et technologies SharePoint sur ce serveur. La stratégie de sécurité peut par exemple être mise en application sur les fichiers, les dossiers et les clés de Registre.

Exemple

psconfig.exe -cmd secureresources

services

Gère les services des produits et technologies SharePoint. Les paramètres suivants sont facultatifs :

[-install]

Enregistre les services de la batterie de serveurs qui se trouvent sur ce serveur.

[-provision]

Met en service les services qui se trouvent sur ce serveur et met ces services en ligne si les produits et technologies SharePoint sont installés en mode autonome. La mise en service permet également de garantir l’enregistrement des services.

Exemple

psconfig.exe -cmd services -install

psconfig.exe -cmd services -provision

setup

Configure les produits et technologies SharePoint en fonction du mode d’installation. Répare également la configuration. Si le produit ou la technologie est installé en mode autonome, une configuration autonome est réalisée. Si le produit ou la technologie n’est pas en mode autonome, vous devez terminer la configuration initiale à l’aide de l’Assistant Configuration des produits et technologies SharePoint et non à l’aide de l’utilitaire de ligne de commande psconfig.exe. Pour exécuter l’Assistant, dans le menu Démarrer, pointez sur Tous les programmes puis sur Outils d’administration et cliquez sur Assistant Configuration des produits et technologies SharePoint.

Si vous souhaitez réparer une installation autonome, commencez par exécuter la commande setup /repair (pour plus d’informations, consultez le système d’aide du programme d’installation), puis exécutez la commande psconfig.exe -setup. Pour les installations de batterie de serveurs, après avoir exécuté la commande setup /repair, utilisez l’Assistant Configuration des produits et technologies SharePoint plutôt que l’utilitaire de ligne de commande psconfig.exe.

Les paramètres suivants sont facultatifs :

[-lcid <1033>]

ID de paramètres régionaux (LCID) spécifiant la langue d’installation.

Exemple

psconfig.exe -cmd setup

standaloneconfig

Réalise une configuration autonome des produits et technologies SharePoint. Les paramètres suivants sont facultatifs :

[-lcid <1033>]

ID de paramètres régionaux (LCID) spécifiant la langue d’installation.

Exemple

psconfig.exe -cmd standaloneconfig

upgrade

Réalise une mise à niveau des produits et technologies SharePoint. Cette commande est exécutée automatiquement lors de l’exécution de l’Assistant Configuration des produits et technologies SharePoint si le produit ou la technologie en question doit être mis à niveau. Les paramètres suivants sont facultatifs :

[-wait]

Si ce paramètre est spécifié, l’Assistant Configuration des produits et technologies SharePoint ne réapparaît pas à l’écran une fois la mise à niveau terminée. S’il n’est pas spécifié, l’Assistant est réaffiché suite à la distribution d’un travail du service du minuteur SharePoint visant à réaliser la mise à niveau. Pour afficher l’état du travail de mise à niveau, accédez à l’application Web Administration centrale de SharePoint à l’aide de votre navigateur Web.

[-force]

Si ce paramètre est spécifié, l’Assistant Configuration des produits et technologies SharePoint arrête les actions de mise à niveau en cours d’exécution et relance la mise à niveau.

[-reghostonupgrade]

Si ce paramètre est spécifié, l’Assistant Configuration des produits et technologies SharePoint réinitialisera l’ensemble du contenu de la version de définition du site au cours de la mise à niveau.

[-finalize]

Si ce paramètre est spécifié, l’Assistant Configuration des produits et technologies SharePoint finalisera la mise à niveau en cours. Accomplissez cette action uniquement une fois que vous avez correctement mis à niveau tous les sites et que vous n’avez plus besoin de la connexion à la version précédente. Vous ne pouvez pas annuler cette action.

[-inplace <v2v|b2b>]

Si ce paramètre est spécifié, l’Assistant Configuration des produits et technologies SharePoint réalisera une mise à niveau sur place. Si la valeur v2v est spécifiée, une mise à niveau sur place de version à version est réalisée. Si la valeur b2b est spécifiée, une mise à niveau sur place de build à build est réalisée.

[-sidebyside]

Si ce paramètre est spécifié, l’Assistant Configuration des produits et technologies SharePoint réalisera une mise à niveau progressive.

Exemples

psconfig.exe -cmd upgrade -inplace v2v -wait
psconfig.exe -cmd upgrade -sidebyside -reghostonupgrade
psconfig.exe -cmd upgrade -finalize

Télécharger ce livre

Cette rubrique est incluse dans le livre téléchargeable suivant pour une lecture et une impression plus faciles :

Voir la liste complète des livres disponibles sur Livres à télécharger pour Windows SharePoint Services.