Restart-Service

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

Syntaxe

Restart-Service [-Name] <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Restart-Service -DisplayName <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Restart-Service [-InputObject <ServiceController[]>] [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Description

L'applet de commande Restart-Service envoie un message d'arrêt, puis un message de démarrage, au Contrôleur de services 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 à l'aide de leurs noms de services ou de leurs noms d'affichage. Il est également possible d'utiliser le paramètre InputObject pour passer un objet représentant chaque service à redémarrer.

Paramètres

-DisplayName <string[]>

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

Obligatoire ?	true
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-Exclude <string[]>

Omet les services spécifiés. La valeur de ce paramètre qualifie le paramètre Name. Entrez un élément ou un modèle de nom, tel que « s* ». Les caractères génériques sont autorisés.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-Force

Remplace des restrictions qui empêchent la commande de réussir, simplement de manière à ce que les modifications ne compromettent pas la sécurité. Par exemple, Force arrête et redémarre un service dont dépendent d'autres services.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-Include <string[]>

Redémarre uniquement les services spécifiés. La valeur de ce paramètre qualifie le paramètre Name. Entrez un élément ou un modèle de nom, tel que « s* ». Les caractères génériques sont autorisés.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-InputObject <ServiceController[]>

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 permettant d'obtenir les objets.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	true (ByValue)
Accepter les caractères génériques ?	false

-Name <string[]>

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

Obligatoire ?	true
Position ?	1
Valeur par défaut
Accepter l'entrée de pipeline ?	true (ByValue, ByPropertyName)
Accepter les caractères génériques ?	false

-PassThru

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

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-Confirm

Vous invite à confirmer l'exécution de la commande.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-WhatIf

Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Entrées	System.ServiceProcess.ServiceController, System.String Vous pouvez diriger un objet service ou une chaîne qui contient un nom de service vers Restart-Service.
Sorties	Aucun ou System.ServiceProcess.ServiceController Lorsque vous utilisez le paramètre PassThru, Restart-Service génère un objet System.ServiceProcess.ServiceController qui représente le service redémarré. Sinon, cette applet de commande ne génère aucune sortie.

Remarques

Restart-Service peut contrôler des services seulement lorsque l'utilisateur actuel est autorisé à le faire. Si une commande ne fonctionne pas correctement, cela signifie peut-être que vous ne disposez pas des autorisations requises.

Pour rechercher les noms de services et les noms d'affichage des services sur votre système, tapez « get-service ». Les noms de services figurent dans la colonne Name, tandis que les noms d'affichage apparaissent dans la colonne DisplayName.

Exemple 1

C:\PS>restart-service wmi

Description
-----------
Cette commande redémarre le service WMI (Windows Management Instrumentation) sur l'ordinateur local.

Exemple 2

C:\PS>restart-service -displayname net* -exclude "net logon"

Description
-----------
Cette commande redémarre les services dont le nom d'affichage commence par « Net », à l'exception du service « Net Logon ».

Exemple 3

C:\PS>get-service net* | where-object {$_.Status -eq "Stopped"} | restart-service

Description
-----------
Cette commande démarre tous les services réseau arrêtés sur l'ordinateur.

Elle utilise l'applet de commande Get-Service pour obtenir des objets représentant les services dont le nom de service commence par « net ». (Le nom du paramètre optionnel Name est omis.) 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 « Stopped ». Un autre opérateur de pipeline envoie les services sélectionnés à Restart-Service. En pratique, vous utiliseriez le paramètre WhatIf pour vérifier l'effet de la commande avant de l'utiliser.

Voir aussi

Concepts

Start-Service
Stop-Service
Suspend-Service
Resume-Service
New-Service
Get-Service
Set-Service