Stop-Service
Arrête un ou plusieurs services en cours d'exécution.
Syntax
Stop-Service
[-Force]
[-NoWait]
[-InputObject] <ServiceController[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Stop-Service
[-Force]
[-NoWait]
[-Name] <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Stop-Service
[-Force]
[-NoWait]
[-PassThru]
-DisplayName <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Cette applet de commande est disponible uniquement sur la plateforme Windows.
L’applet Stop-Service
de commande 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 leur nom de service ou leur nom 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 performance (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 (|
) redirige 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 arrête 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 faire précéder Stop-Service
par 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 Format-List
commande . 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 Confirm pour demander confirmation à l’utilisateur avant qu’elle arrête chaque service.
Paramètres
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Spécifie les noms complets des services à arrêter. Les caractères génériques sont autorisés.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Exclude
Spécifie les services que cette applet de commande omet. 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Force
Force l’applet de commande à arrêter un service même si ce service a des services dépendants.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-InputObject
Spécifie les objets ServiceController qui représentent les services à arrêter. Entrez une variable contenant les objets, ou tapez une commande ou une expression qui obtient ces objets.
Type: | ServiceController[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Spécifie les noms de service des services à arrêter. Les caractères génériques sont autorisés.
Type: | String[] |
Aliases: | ServiceName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-NoWait
Indique que cette applet de commande utilise l’option aucune attente.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Retourne un objet qui représente le nouveau service. Par défaut, cette applet de commande ne génère aucun résultat.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
System.ServiceProcess.ServiceController, System.String
Vous pouvez diriger un objet de service ou une chaîne qui contient le nom d’un service vers cette applet de commande.
Sorties
None, System.ServiceProcess.ServiceController
Cette applet de commande génère un objet System.ServiceProcess.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 disponible uniquement sur les plateformes Windows.
Vous pouvez également faire référence à par Stop-Service
son alias intégré, spsv. Pour plus d'informations, consultez about_Aliases.
Stop-Service
peut contrôler les services uniquement lorsque l’utilisateur actuel est autorisé à le faire. Si une commande ne fonctionne pas correctement, cela signifie peut-être que vous ne disposez pas des autorisations requises.
Pour rechercher les noms de service et les noms complets des services sur votre système, tapez Get-Service
. Les noms de service apparaissent dans la colonne Nom et les noms complets s’affichent dans la colonne DisplayName .