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.

Obligatoire ?

true

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-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.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Force

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

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-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.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-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.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

true (ByValue)

Accepter les caractères génériques ?

false

-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.

Obligatoire ?

true

Position ?

1

Valeur par défaut

Accepter l'entrée de pipeline ?

true (ByValue, ByPropertyName)

Accepter les caractères génériques ?

false

-PassThru

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

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Confirm

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

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-WhatIf

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

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

<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.

Entrées

System.ServiceProcess.ServiceController ou System.String

Vous pouvez diriger un objet service ou une chaîne qui contient le nom d'un service vers Stop-Service.

Sorties

Aucun ou System.ServiceProcess.ServiceController

Lorsque vous utilisez le paramètre PassThru, Stop-Service génère un objet System.ServiceProcess.ServiceController représentant le service. Sinon, cette applet de commande ne génère aucune sortie.

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




Table des matières