Stop-Service

  • Référence
Module:
Microsoft.PowerShell.Management

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 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 performance (SysmonLog) sur l’ordinateur local.

Exemple 2 : Arrêter un service à l’aide du nom complet

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 IIS Administration sur l’ordinateur local. Étant donné que l’arrêt de ce service arrête également les services qui dépendent du service IIS Administration, il est préférable de précéder Stop-Service d’une commande qui répertorie les services qui dépendent du service IIS Administration.

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 IIS Administration. L’opérateur de pipeline (|) transmet le résultat à l’applet Format-List de 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 nécessaire 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.

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 d’affichage 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 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.

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 d’absence d’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

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 , cette applet de commande retourne un objet ServiceController représentant le service.

Notes

PowerShell inclut les alias suivants pour Stop-Service:

  • Windows :
    • spsv

Cette applet de commande est disponible uniquement sur les plateformes Windows.

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 d’affichage des services sur votre système, tapez Get-Service. Les noms de service apparaissent dans la colonne Name et les noms d’affichage apparaissent dans la colonne DisplayName .