Partager via

Restart-Service

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

Arrête, puis démarre un ou plusieurs services.

Syntaxe

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

Cette applet de commande est disponible uniquement sur la plateforme Windows.

L’applet de commande Restart-Service 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 a déjà été arrêté, il est démarré sans vous avertir d’une 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 passer 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 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 dont le nom d’affichage 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 Get-Service pour obtenir des objets qui représentent les services dont le nom de service commence par net. L’opérateur de pipeline (|) envoie l’objet services à l’applet de commande Where-Object, 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 utilisez le paramètre WhatIf pour déterminer l’effet de la commande avant de l’exécuter.

Paramètres

-Confirm

Vous invite à confirmer 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

-DisplayName

Spécifie les noms d’affichage des services à redémarrer. Les caractères génériques sont autorisés.

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

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

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

-InputObject

Spécifie 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.

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

-Name

Spécifie les noms de service des services à redémarrer.

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

-PassThru

Retourne un objet qui représente le service. Par défaut, cette applet de commande ne génère aucune sortie.

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

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. 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

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 ne peut contrôler les services que lorsque l’utilisateur actuel est autorisé à le faire. Si une commande ne fonctionne pas correctement, vous n’avez peut-être pas les 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.