Stop-Service
Arrête un ou plusieurs services en cours d’exécution.
Syntaxe
InputObject (Par défaut)
Stop-Service
[-InputObject] <ServiceController[]>
[-Force]
[-NoWait]
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Stop-Service
[-Name] <String[]>
[-Force]
[-NoWait]
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DisplayName
Stop-Service
-DisplayName <String[]>
[-Force]
[-NoWait]
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Cette applet de commande est disponible uniquement sur la plateforme Windows.
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 noms d’affichage, ou vous pouvez utiliser le paramètre InputObject pour passer 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 Journaux et alertes de performances (SysmonLog) sur l’ordinateur local.
Exemple 2 : Arrêter un service à l’aide du 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 obtenir un objet qui représente le service Telnet. L’opérateur de pipeline (|) dirige l’objet vers Stop-Service, ce qui arrête le service.
Exemple 3 : Arrêter un service qui a des services dépendants
PS C:\> Get-Service -Name "iisadmin" | Format-List -Property Name, DependentServices
PS C:\> Stop-Service -Name "iisadmin" -Force -Confirm
Cet exemple montre comment arrêter le service IISAdmin sur l’ordinateur local. Étant donné 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 objet 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 Property de Format-List pour répertorier uniquement les propriétés Name et DependentServices du service.
La deuxième commande arrête le service IISAdmin. Le paramètre Force est requis pour arrêter un service qui a des services dépendants. La commande utilise le paramètre Confirmer pour demander la confirmation de l’utilisateur avant d’arrêter chaque service.
Paramètres
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DisplayName
Spécifie les noms d’affichage des services à arrêter. Les caractères génériques sont autorisés.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
DisplayName
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Exclude
Spécifie les services omis par cette applet de commande. La valeur de ce paramètre qualifie le paramètre Name. Entrez un élément de nom ou un modèle, tel que s*. Les caractères génériques sont autorisés.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Force
Force l’applet de commande à arrêter un service même si ce service a des services dépendants.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Include
Spécifie les services que cette applet de commande arrête. La valeur de ce paramètre qualifie le paramètre Name. Entrez un élément de nom ou un modèle, tel que s*. Les caractères génériques sont autorisés.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-InputObject
Spécifie les objets ServiceController qui représentent les services à arrêter. Entrez une variable qui contient les objets, ou tapez une commande ou une expression qui obtient les objets.
Propriétés du paramètre
| Type: | |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
InputObject
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Spécifie les noms de service des services à arrêter. Les caractères génériques sont autorisés.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
| Alias: | Nom du Service |
Jeux de paramètres
Default
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-NoWait
Indique que cette applet de commande utilise l’option d’absence d’attente.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-PassThru
Retourne un objet qui représente le nouveau service. Par défaut, cette applet de commande ne génère aucune sortie.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Entrées
ServiceController
Vous pouvez diriger un objet de service vers cette applet de commande.
String
Vous pouvez diriger une chaîne qui contient le nom d’un service vers cette applet de commande.
Sorties
None
Par défaut, cette applet de commande ne retourne aucune sortie.
ServiceController
Lorsque vous utilisez le paramètre PassThru
Notes
PowerShell inclut les alias suivants pour Stop-Service:
- Windows :
spsv
Cette applet de commande est disponible uniquement sur les plateformes Windows.
Stop-Service ne peut contrôler les services que lorsque l’utilisateur actuel est autorisé à le faire. Si une commande ne fonctionne pas correctement, vous n’avez peut-être pas les autorisations requises.
Pour rechercher 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 Nom d'Affichage.