Restart-Service
Arrête, puis démarre un ou plusieurs services.
Syntax
Restart-Service
[-Force]
[-InputObject] <ServiceController[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Restart-Service
[-Force]
[-Name] <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Restart-Service
[-Force]
[-PassThru]
-DisplayName <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet Restart-Service
de commande envoie un message d’arrêt, puis un message de démarrage au contrôleur de service Windows pour un service spécifié. Si un service est déjà arrêté, il est démarré sans notification d'erreur. Vous pouvez spécifier les services par leurs noms de service ou noms d’affichage, ou vous pouvez utiliser le paramètre InputObject pour transmettre un objet qui représente chaque service que vous souhaitez redémarrer.
Exemples
Exemple 1 : Redémarrer un service sur l’ordinateur local
PS C:\> Restart-Service -Name winmgmt
Cette commande redémarre le service WMI (Windows Management Instrumentation) WinMgmt sur l'ordinateur local.
Exemple 2 : Exclure un service
PS C:\> Restart-Service -DisplayName "net*" -Exclude "net logon"
Cette commande redémarre les services qui ont un nom complet qui commence par Net, à l’exception du service d’ouverture de session Net.
Exemple 3 : Démarrer tous les services réseau arrêtés
PS C:\> Get-Service -Name "net*" | Where-Object {$_.Status -eq "Stopped"} | Restart-Service
Cette commande démarre tous les services réseau arrêtés sur l'ordinateur.
Cette commande utilise l’applet de commande pour obtenir des objets qui représentent les services dont le Get-Service
nom de service commence par net. L’opérateur de pipeline (|
) envoie l’objet services à l’applet Where-Object
de commande, qui sélectionne uniquement les services dont l’état est arrêté. Un autre opérateur de pipeline envoie les services sélectionnés à Restart-Service
.
Dans la pratique, vous utiliserez le paramètre WhatIf pour déterminer l’effet de la commande avant de l’exécuter.
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 à redémarrer. 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’exécution de la commande sans demander la confirmation de l’utilisateur.
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 redémarre. 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 à redémarrer. 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 à redémarrer.
Type: | String[] |
Aliases: | ServiceName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-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
System.ServiceProcess.ServiceController, System.String
Vous pouvez diriger un objet de service ou une chaîne qui contient un nom de service vers cette applet de commande.
Sorties
None, System.ServiceProcess.ServiceController
Cette applet de commande génère un objet System.ServiceProcess.ServiceController qui représente le service redémarré, si vous spécifiez le paramètre PassThru . Sinon, cette applet de commande ne génère aucune sortie.
Notes
Cette applet de commande est disponible uniquement sur les plateformes Windows.
Restart-Service
peut contrôler les services uniquement lorsque l’utilisateur actuel dispose de l’autorisation d’effectuer cette opération. 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 Nom et les noms d’affichage apparaissent dans la colonne DisplayName .