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.