Syntaxe

sp [ LIST | CONFIG | START | RESTART | STOP | PAUSE | CONTINUE | CONTROL | QUERY | CREATE | REMOVE | MODIFY | KILL | PARAMCHANGE | INTEROGATE | DEBUG | REGISTER | HELP ]

Pour plus d'informations sur une commande :

sp (Command) /help

Paramètres optionnels valables pour la plupart des commandes

/DOMAIN=

/Q Quiet mode - Répond oui à tous les messages de confirmation

Nb : Le serveur et le service peuvent contenir des jokers (* et?).

Commande LIST

Liste l'état d'un ou des service(s)

sp LIST [[\\serveur\]service] [/Domain=]

Exemple :

sp list \\*\spooler

Le statut de spooler sera affiché sur toutes vos machines NT

Commande CONFIG

Affiche la configuration d'un ou des service(s)

sp CONFIG [[\\serveur\]service] [/Domain=]

Exemple :

sp config \\*\spooler

Cette commande affichera le statut de spooler sur toutes vos machines NT

Commande START

Démarre un ou des service(s)

sp start[=Startup Paramètres] [\\serveur\]service

Exemple :

sp start \\serveur\spooler

Commande RESTART

Redémarre un ou des service(s)

sp restart [=Startup Paramètres] [\\serveur\]service

Exemple :

sp restart \\serveur\spooler

Commande STOP

Arrête un ou des service(s)

sp stop [\\serveur\]service

Exemple :

sp stop \\serveur\spooler

Commande PAUSE

Met en pause un ou des service(s)

Exemple :

sp pause \\serveur\spooler

Commande CONTINUE

Continue le service

sp continue [\\serveur\]service

Exemple :

sp continue \\serveur\spooler

Commande CONTROL

Envoie une valeur à votre service

sp control=code service

La valeur doit être comprise entre 128 et 255

Exemple :

sp control=128 monservice

Commande QUERY

Interroge l'état d'un service

sp query [\\serveur\]service [/Domain=]

Le commande renvoie un ErrorLevel qui détermine l'état d'un service

ErrorLevel:

  • 0 Le service n'est pas installé
  • 1 Le service est arrêté
  • 2 Le démarrage du service est en cours
  • 3 L'arrêt du service est en cours
  • 4 Le service est démarré
  • 5 Le redémarrage du service après pause est en cours
  • 6 La mise en pause du service est en cours
  • 7 Le service est en pause

Dans l'exemple suivant le spooler d'imprimante démarre si le service est arrêté :

sp list \\myserver\spooler
If ErrorLevel 1 sp \\myserver\spooler start

Commande PARAMCHANGE

Envoie une commande PARAMCHANGE pour indiquer que les paramètres du service doivent être rechargés

sp PARAMCHANGE [\\serveur\]service

Nb : Le serveur et le service peuvent contenir des jokers (* et ?).

Exemple :

sp paramchange MonService

Commande INTEROGATE

Envoie une commande INTEROGATE pour recuperer l'état du service - La commande retourne dans ErrorLevel le code d'erreur, s'il y a lieu

sp interogate [\\serveur\]service

Exemple :

sp interogate MonService

Commande CREATE

Crée un service

sp create [\\serveur\]service /PATH=Chemin de l'executable du service [/DISPLAYNAME=Nom du Service] [/ACCOUNT=Domain\User /PASSWORD=xyz] [/DEPEND=service1,service2,etc.] [/INTERACT=1,0] [/STARTUP=MANUAL,AUTO,DISABLED] [/TYPE=OwnProcess,ShareProcess] [/ERRORCONTROL=Ignore,Normal,Severe,Critical]

Exemple :

sp create \\serveur\MonService /path=c:\svcitocx\sample\service.exe

Commande REMOVE

Supprime le service

sp remove [\\serveur\]service

Exemple :

sp remove \\serveur\MonService

Commande MODIFY

sp modify [[\\serveur\]service] [/ACCOUNT=Domain\User /PASSWORD=xyz] [/STARTUP=MANUAL,AUTO,DISABLED] [/DISPLAYNAME="Nom du Service"] [/PATH=Chemin de l'executable du service] [/DEPEND=service1,service2,etc.] [/INTERACT=1,0] [/WHEREACCOUNT=Domain\User]

Exemples :

sp modify MonService /interact=1

sp modify * /password=NouveauMotDePasse /whereaccount=Domaine\CompteService

Commande KILL

Tue le processus du service

sp kill service

Exemple :

sp kill spooler

La commande Kill ne peut être utilisée à distance

Commande DEBUG

Démarre le service et attache votre debugger (comme Microsoft Visual C++)

sp DEBUG service

Exemple :

sp debug MonService

La command Debug ne peut être utilisée à distance

Commande REGISTER

Installe la clé utilisateur

sp REGISTER /ID=votreID /Key=votreclé

Exemple :

sp register /ID="Active+ Software" /Key=12345