Stop-Service

Arrête un ou plusieurs services en cours d'exécution.

Syntaxe

Stop-Service [-Name] <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Stop-Service -DisplayName <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Stop-Service [-InputObject <ServiceController[]>] [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Description

L'applet de commande Stop-Service envoie un message d'arrêt au Contrôleur de services Windows pour chacun des services spécifiés. Vous pouvez spécifier les services à l'aide de leurs noms de services ou de leurs noms d'affichage. Il est également possible d'utiliser un paramètre InputObject pour passer un objet service représentant chacun des services à arrêter.

Paramètres

-DisplayName <string[]>

Spécifie les noms d'affichage des services à arrêter. Les caractères génériques sont autorisés.

-Exclude <string[]>

Omet les services spécifiés. La valeur de ce paramètre qualifie le paramètre Name. Entrez un élément ou un modèle de nom, tel que « s* ». Les caractères génériques sont autorisés.

-Force

Permet à l'applet de commande d'arrêter un service même si ce service a des services dépendants.

-Include <string[]>

Arrête uniquement les services spécifiés. La valeur de ce paramètre qualifie le paramètre Name. Entrez un élément ou un modèle de nom, tel que « s* ». Les caractères génériques sont autorisés.

-InputObject <ServiceController[]>

Spécifie les objets ServiceController représentant les services à arrêter. Entrez une variable contenant les objets ou tapez une commande ou une expression permettant d'obtenir ces objets.

-Name <string[]>

Spécifie les noms des services à arrêter. Les caractères génériques sont autorisés.

Le nom de paramètre est facultatif. Vous pouvez utiliser « Name » ou son alias, « ServiceName », ou encore omettre le nom de paramètre.

-PassThru

Retourne un objet représentant le service. Par défaut, cette applet de commande ne génère aucune sortie.

-Confirm

Vous invite à confirmer l'exécution de la commande.

-WhatIf

Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Remarques

Vous pouvez également faire référence à Stop-Service par son alias intégré, « spsv ». Pour plus d'informations, consultez about_Aliases.

Stop-Service peut contrôler des services seulement 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 services et les noms d'affichage des services sur votre système, tapez « get-service ». Les noms de services figurent dans la colonne Name et les noms d'affichage apparaissent dans la colonne DisplayName.

Exemple 1

C:\PS>stop-service sysmonlog

Description
-----------
Cette commande arrête le service Journaux et alertes de performance (SysmonLog) sur l'ordinateur local.

Exemple 2

C:\PS>get-service -displayname telnet | stop-service

Description
-----------
Cette commande arrête le service Telnet sur l'ordinateur local. La commande utilise l'applet de commande Get-Service pour obtenir un objet représentant le service Telnet. L'opérateur de pipeline (|) dirige l'objet vers l'applet de commande Stop-Service qui arrête le service.

Exemple 3

C:\PS>get-service iisadmin | format-list -property name, dependentservices

C:PS>stop-service iisadmin -force -confirm

Description
-----------
La commande Stop-Service arrête le service IISAdmin sur l'ordinateur local. Dans la mesure où l'arrêt du service IISAdmin arrête également les services qui dépendent de celui-ci, il est recommandé d'exécuter une commande répertoriant les services dépendant du service IISAdmin avant la commande Stop-Service.

La première commande répertorie les services qui dépendent d'IISAdmin. Elle utilise l'applet de commande Get-Service pour obtenir un objet qui représente le service IISAdmin. L'opérateur de pipeline (|) passe 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 Confirm pour demander la confirmation de l'utilisateur avant d'arrêter chaque service.

Voir aussi

Concepts

Get-Service
Suspend-Service
Start-Service
Restart-Service
Resume-Service
Set-Service
New-Service