Partager via


Remove-Service

Supprime un service Windows.

Syntaxe

Name (Par défaut)

Remove-Service
    [-Name] <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObject

Remove-Service
    [-InputObject <ServiceController>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

L’applet de commande Remove-Service supprime un service Windows dans le Registre et dans la base de données de service.

L’applet de commande Remove-Service a été introduite dans PowerShell 6.0.

Exemples

Exemple 1 : Supprimer un service

Cela supprime un service nommé TestService.

Remove-Service -Name "TestService"

Exemple 2 : supprimer un service en utilisant le nom d’affichage

Cet exemple supprime un service nommé TestService. La commande utilise Get-Service pour obtenir un objet qui représente le service TestService à l’aide du nom d'affichage. L’opérateur de pipeline (|) dirige l’objet vers Remove-Service, ce qui supprime le service.

Get-Service -DisplayName "Test Service" | Remove-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

-InputObject

Spécifie les objets ServiceController qui représentent les services à redémarrer. Entrez une variable qui contient les objets, ou tapez une commande ou une expression qui obtient les objets.

Le paramètre InputObject n’énumère pas les collections. Si une collection est passée, une erreur est générée. Lorsque vous travaillez avec des collections, acheminez les données d'entrée pour en énumérer les valeurs.

Propriétés du paramètre

Type:ServiceController
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

InputObject
Position:Named
Obligatoire:False
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 à supprimer. 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, SN

Jeux de paramètres

Name
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
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

Cette applet de commande ne retourne aucune sortie.

Notes

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

Pour exécuter cette applet de commande, démarrez PowerShell à l’aide de l’option Exécuter en tant qu’administrateur.