Stsadm, outil de ligne de commande (Windows SharePoint Services)

Mise à jour : 2009-10-22

Dans cet article :

  • Utilisation de Stsadm

  • Stsadm n’est pas interactif

  • Opérations et propriétés disponibles

Windows SharePoint Services 3.0 comporte l’outil Stsadm pour l’administration en ligne de commande des serveurs et des sites Windows SharePoint Services. Stsadm se trouve à l’emplacement suivant sur le lecteur où sont installés les produits et technologies SharePoint : %COMMONPROGRAMFILES%\microsoft shared\web server extensions\12\bin. Vous devez être administrateur sur l’ordinateur local pour utiliser Stsadm.

Stsadm procure une méthode pour effectuer les tâches administratives de Windows SharePoint Services 3.0 à la ligne de commande ou à l’aide de fichiers de commandes ou de scripts. Stsadm donne accès à des opérations qui ne sont pas disponibles avec le site Administration centrale, par exemple la modification du port d’administration. L’outil de ligne de commande possède une interface plus simplifiée que l’administration centrale et il permet d’effectuer les mêmes tâches. Certaines opérations et certains paramètres ne sont disponibles qu’avec l’outil de ligne de commande Stsadm.

Utilisation de Stsadm

L’outil de ligne de commande donne accès à l’ensemble complet des opérations de Windows SharePoint Services 3.0. Vous pouvez utiliser Stsadm à partir de la ligne de commande ou avec des fichiers de commandes ou des scripts. Stsadm doit être exécuté sur le serveur lui-même.

Pour utiliser Stsadm, vous devez appartenir au groupe Administrateurs locaux du serveur. Lorsque vous faites appel à Stsadm, vous fournissez une opération et un ensemble de paramètres de ligne de commande sous cette forme :

-operation OperationName -parameter value

NoteRemarque :

Si une valeur que vous devez utiliser avec l’outil de ligne de commande comporte un espace ou un caractère qui est traité comme étant spécial par l’interface de ligne de commande, par exemple le et commercial (&), vous pouvez placer la chaîne entre guillemets ("). Par exemple, si l’URL d’un site est http://mon site, vous pouvez entrer l’URL sous la forme "http://mon site".

La plupart des paramètres de la ligne de commande ont aussi une forme abrégée que vous pouvez utiliser à la place de leur nom complet. Par exemple, la commande suivante définit la base de données de configuration pour qu’elle utilise Serveur1_collab sur Serveur1 et elle spécifie le nom d’utilisateur et le mot de passe de la base de données à laquelle se connecter :

stsadm -o setconfigdb -connect -ds Serveur1 -dn Serveur1_collab -du Utilisateur1 -dp mot de passe

Le tableau suivant décrit les commandes et les paramètres de cet exemple.

Commande ou paramètre Définition

-o setconfigdb

Crée une connexion entre Windows SharePoint Services 3.0 et une base de données de configuration.

-connect

Spécifie qu’il y a une base de données de configuration existante à utiliser.

-ds Serveur1

Spécifie le nom du serveur qui contient la base de données à utiliser.

-dn Serveur1_collab

Spécifie le nom de la base de données à utiliser sur ce serveur.

-du Utilisateur1

Spécifie un nom d’utilisateur d’administrateur pour la base de données.

-dp mot de passe

Spécifie le mot de passe de l’utilisateur.

Stsadm n’est pas interactif

Stsadm n’est pas un outil interactif. Avec Stsadm, vous tapez l’opération et les paramètres en même temps. Aucun message ne vous invite à fournir des paramètres manquants pendant l’exécution de l’opération. S’il manque un paramètre obligatoire, l’opération échoue et vous devez retaper l’opération et les paramètres.

Cela apporte davantage de souplesse pour le traitement par lots des commandes, parce que les outils ne vous demandent pas d’informations une fois que vous avez fourni une commande. Si vous préférez un outil plus interactif, essayez d’utiliser le modèle objet d’administration ou les pages Administration centrale.

Opérations et propriétés disponibles

Pour avoir une liste complète des opérations et propriétés de Stsadm, voir Index des opérations et des propriétés Stsadm (Windows SharePoint Services).

Les opérations suivantes ne sont disponibles qu’à partir de la ligne de commande :

addcontentdb (la ligne de commande est obligatoire pour ajouter les bases de données nécessitant une mise à niveau)

enumsolutions

renameserver

addsolution

enumtemplates

restore (niveau de la collection de sites)

addwppack

enumwppacks

retractsolution

backup (niveau de la collection de sites)

execadmsvcjobs

retractwppack

binddrservice

export

scanforfeatures

canceldeployment

forcedeletelist

setadminport

copyappbincontent

getadminport

setconfigdb

createadminvs

getproperty

setproperty

createsiteinnewdb

getsitelock

setworkflowconfig

databaserepair

import

spsearchdiacriticsensitive

deleteadminvs

installfeature

syncsolution

deleteconfigdb

migrateuser

uninstallfeature

deletesolution

provisionservice

unregisterwsswriter

deletewppack

refreshdms

updateaccountpassword

deploysolution

refreshsitedms

updatealerttemplates

deploywppack

registerwsswriter

updatefarmcredentials

displaysolution

removedrservice

upgradesolution

enumdeployments

removesolutiondeploymentlock

Paramètres disponibles uniquement à partir de la ligne de commande :

-force

-propertyname

-globalinstall

-propertyvalue

-newname

-servicename

-overwrite

-ssl

Voir aussi

Concepts

Index des opérations et des propriétés Stsadm (Windows SharePoint Services)