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
Remarque : |
---|
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)