Partager via

Remove-Service

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

Supprime un service Windows.

Syntaxe

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

Description

L’applet Remove-Service de commande 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 à l’aide du nom complet

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 complet. 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 demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Spécifie les objets ServiceController qui représentent les services à supprimer. Entrez une variable contenant les objets, ou tapez une commande ou une expression qui obtient ces objets.

Le paramètre InputObject n’énumère pas les collections. Si une collection est passée, une erreur est levée. Lorsque vous utilisez des collections, dirigez l’entrée pour énumérer les valeurs.

Type:ServiceController
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifie les noms de service des services à supprimer. Les caractères génériques sont autorisés.

Type:String
Alias:ServiceName, SN
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

-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
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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

Cette applet de commande ne retourne pas de 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 .