Arrête un ou plusieurs services en cours d’exécution.
Syntaxe
Stop-Service <ServiceController> >] >] Stop-Service <String> >] >] Stop-Service -DisplayName <String> >] >] Description
L’applet de commande Stop-Service envoie un message d’arrêt au contrôleur de service Windows pour chacun des services spécifiés. Vous pouvez spécifier les services par leurs noms de service ou leurs noms d’affichage, ou vous pouvez utiliser le paramètre InputObject pour transmettre un objet de service qui représente le service que vous souhaitez arrêter.
Exemples
Exemple 1 : Arrêter un service sur l’ordinateur local
PS C:\> Stop-Service -Name "sysmonlog"Cette commande arrête le service de journaux de performances et d’alertes (SysmonLog) sur l’ordinateur local.
Exemple 2 : Arrêtez un service en utilisant le nom d’affichage
PS C:\> Get-Service -DisplayName "telnet" | Stop-Service Cette commande arrête le service Telnet sur l’ordinateur local. La commande utilise Get-Service pour obtenirun objet qui représente le service Telnet. L’opérateur de pipeline (|) achemine l’objet vers Stop-Service, ce qui arrête le service.
Exemple 3: Arrêtez un service qui a des services dépendants
PS C:\> Get-Service -Name "iisadmin" | Format-List -Property Name, DependentServicesPS C:\> Stop-Service -Name "iisadmin" -Force -Confirm Cet exemple arrête le service IISAdmin sur l’ordinateur local. Parce que l’arrêt de ce service arrête également les services qui dépendent du service IISAdmin, il est préférable de précéder Stop-Service avec une commande qui répertorie les services qui dépendent du service IISAdmin.
La première commande répertorie les services qui dépendent d’IISAdmin. Il utilise Get-Service pour obtenir un object qui représente le service IISAdmin. L’opérateur de pipeline (|) transmet le résultat à l’applet de commande Format-List. La commande utilise le paramètre de propriété Format-List pour répertorier uniquement les propriétés Nom et DependentServices du service.
La deuxième commande arrête le service IISAdmin. Le paramètre Force est requis pour arrêter un servicequi a des services dépendants. La commande utilise le paramètre Confirm pour demander une confirmation à l’utilisateur avant d’arrêter chaque service.
Paramètres
Vous invite à confirmer avant d’exécuter l’applet de commande.
| Type: | Paramètre de commutation |
| Alias: | cf |
| Position: | Nommé |
| Valeur par défaut : | False |
| Accepter l’entrée du pipeline: | False |
| Accepter les caractères génériques : | False |
Spécifie les noms d’affichage des services à arrêter.Les caractères génériques sont autorisés.
| Type: | Chaîne |
| Position: | Nommé |
| Valeur par défaut : | Aucun |
| Accepter l’entrée du pipeline: | Faux |
| Accepter les caractères génériques : | True |
Spécifie les services que cette applet de commande omet. La valeur de ce paramètre qualifie le paramètre Nameparameter. Entrez un élément de nom ou un motif, tel que s*. Les caractères génériques sont autorisés.
| Type: | Chaîne |
| Position: | Nommé |
| Valeur par défaut : | Aucun |
| Accepter l’entrée du pipeline: | False |
| Accepter les caractères génériques: | Vrai |
Force l’applet de commande à arrêter un service même si ce service a des services dépendants.
| Type: | Paramètre de commutation |
| Position: | Nommé |
| Valeur par défaut : | Aucun |
| Accepter l’entrée du pipeline: | False |
| Accepter les caractères génériques : | False |
Spécifie les services que cette applet de commande arrête. La valeur de ce paramètre qualifie le paramètre Nameparameter. Entrez un élément de nom ou un motif, tel que s*. Les caractères génériques sont autorisés.
| Type: | Chaîne |
| Position: | Nommé |
| Valeur par défaut : | Aucun |
| Accepter l’entrée du pipeline: | False |
| Accepter les caractères génériques : | True |
Spécifie les objets ServiceController qui représentent les services à arrêter. Entrez une variable quicontient les objets, ou tapez une commande ou une expression qui obtient les objets.
| Type: | ServiceController |
| Poste: | 0 |
| Valeur par défaut : | Aucun |
| Accepter l’entrée du pipeline: | True |
| Accepter les caractères génériques : | False |
Spécifie les noms de service des services à arrêter. Les caractères génériques sont autorisés.
| Type: | Chaîne |
| Alias : | Nom de service |
| Poste: | 0 |
| Valeur par défaut : | Aucun |
| Accepter l’entrée du pipeline: | True |
| Accepter les caractères génériques : | True |
Indique que cette applet de commande utilise l’option sans attente.
| Type: | Paramètre de commutation |
| Position: | Nommé |
| Valeur par défaut: | Aucun |
| Accepter l’entrée du pipeline: | False |
| Accepter les caractères génériques : | False |
Renvoie un objet qui représente le service. Par défaut, cette applet de commande ne génère aucune sortie.
| Type: | Paramètre de commutation |
| Position: | Nommé |
| Valeur par défaut : | Aucun |
| Accepter l’entrée du pipeline: | False |
| Accepter les caractères génériques: | Faux |
Montre ce qui se passerait si l’applet de commande s’exécutait. L’applet de commande n’est pas exécutée.
| Type: | Paramètre de commutation |
| Alias : | wi |
| Position: | Nommé |
| Valeur par défaut : | False |
| Accepter l’entrée du pipeline: | False |
| Accepter les caractères génériques : | False |
Entrées
Système.Processus de service.ServiceController, Système.String
Vous pouvez diriger un objet de service ou une chaîne contenant le nom d’un service vers cette applet de commande.
Sorties
Aucun, Système.Processus de service.ServiceController
Cette applet de commande génère un système.Processus de service.Objet ServiceController qui représente le service, si vous utilisez le paramètre PassThru. Sinon, cette applet de commande ne génère aucune sortie.
Notes
Cette applet de commande est uniquement disponible sur les plates-formes Windows.
Vous pouvez également vous référer à Stop-Service par son alias intégré, spsv. Pour plus d’informations, voir About_aliases.
Stop-Service ne peut contrôler les services que lorsque l’utilisateur actuel est autorisé à le faire. Si acommand ne fonctionne pas correctement, vous ne disposez peut-être pas des autorisations requises.
Pour trouver les noms de service et les noms d’affichage des services sur votre système, tapez Get-Service. Les noms de service apparaissent dans la colonne Nom et les noms d’affichage apparaissent dans la colonne DisplayNamecolumn.
- Obtenir-Service
- Nouveau-Service
- Redémarrer-Service
- Reprendre-Service
- Set-Service
- Démarrer-Service
- Suspendre-Service
- Supprimer-Service