Démarre un ou plusieurs services arrêtés.

Syntaxe

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

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

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

Description

L'applet de commande Start-Service envoie un message de démarrage au Contrôleur de services Windows pour chacun des services spécifiés. Si un service est déjà en cours d'exécution, le message est ignoré sans 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 service représentant chaque service à démarrer.

Paramètres

-DisplayName <string[]>

Spécifie les noms d'affichage des services à dé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

-Include <string[]>

Dé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 représentant les services à dé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 le nom de service du service à démarrer.

Le nom de paramètre est facultatif. Vous pouvez utiliser « -Name » ou son alias, « -ServiceName », ou encore omettre le nom de paramètre.

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 représentant le 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 vers Start-Service des objets qui représentent les services ou les chaînes contenant les noms de services.

Sorties

Aucun ou System.ServiceProcess.ServiceController

Lorsque vous utilisez le paramètre PassThru, Start-Service génère un objet System.ServiceProcess.ServiceController représentant le service. Sinon, cette applet de commande ne génère aucune sortie.

Remarques

Vous pouvez également faire référence à Start-Service par son alias intégré, « sasv ». Pour plus d'informations, consultez about_Aliases.

Start-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 et les noms d'affichage apparaissent dans la colonne DisplayName.

Vous pouvez uniquement démarrer les services dont le type de démarrage est « Manual » ou « Automatic ». Un service dont le type de démarrage est « Disabled » ne peut pas être démarré. Si une commande Start-Service échoue avec le message « Impossible de démarrer le service <nom_service> sur l'ordinateur », utilisez une commande Get-WmiObject pour identifier le type de démarrage du service, puis modifiez-le à l'aide d'une commande Set-Service, si nécessaire.

Certains services, tels le service Journaux et alertes de performance (Sysmonlog), s'arrêtent automatiquement lorsqu'ils n'ont aucune tâche à exécuter. Lorsque Windows PowerShell démarre un de ces services, presque immédiatement, le message suivant s'affiche : « Le démarrage du service <nom_affichage> a échoué ».

Exemple 1

C:\PS>start-service -name eventlog

Description
-----------
Cette commande démarre le service EventLog sur l'ordinateur local. Elle utilise le paramètre Name pour identifier le service à l'aide de son nom de service.






Exemple 2

C:\PS>start-service -displayname *remote* -whatif

Description
-----------
Cette commande indique le résultat que vous obtiendriez si vous démarriez les services avec un nom d'affichage qui inclut « remote ». Elle utilise le paramètre DisplayName pour spécifier les services par leur nom d'affichage au lieu de leur nom de service. Et, elle utilise le paramètre WhatIf pour indiquer ce qui arriverait si la commande était exécutée au lieu d'exécuter la commande.






Exemple 3

C:\PS>$s = get-service wmi

C:\PS>start-service -InputObject $s -passthru | format-list >> services.txt

Description
-----------
Ces commandes démarrent le service WMI (Windows Management Instrumentation) sur l'ordinateur et ajoutent un enregistrement de l'action au fichier services.txt. La première commande utilise l'applet de commande Get-Service pour obtenir un objet représentant le service WMI et le stocker dans la variable $s. 

La seconde commande utilise l'applet de commande Start-Service pour démarrer le service WMI. Elle identifie le service en utilisant le paramètre InputObject pour passer la variable $s contenant l'objet du service WMI à Start-Service. Ensuite, elle utilise le paramètre PassThru pour créer un objet qui représente le démarrage du service. Sans ce paramètre, Start-Service ne crée aucune sortie.

L'opérateur de pipeline (|) passe l'objet que Start-Service crée à l'applet de commande Format-List, laquelle met en forme l'objet pour afficher la liste de ses propriétés. L'opérateur de redirection d'ajout (>>) redirige la sortie vers le fichier services.txt, dans lequel elle est ajoutée à la fin du fichier existant.






Exemple 4

C:\PS># start-service

Description
-----------
Cette série de commandes montre comment démarrer un service lorsque le type de démarrage du service est « Disabled ». La première commande, qui utilise l'applet de commande Start-Service pour démarrer le service Telnet (tlntsvr), échoue.

C:\PS>start-service tlntsvr

Start-Service : Le service « Telnet (TlntSvr) » ne peut pas démarrer en raison de l'erreur suivante : Impossible de démarrer le service TlntSvr sur l'ordinateur « . ».
À la ligne : 1 Caractère : 14
+ start-service  <<<< tlntsvr

La deuxième commande utilise l'applet de commande Get-WmiObject pour obtenir le service Tlntsvr. Cette commande récupère un objet avec la propriété de type de démarrage dans le champ StartMode. Le résultat affiché indique que le type de démarrage du service Tlntsvr est « Disabled ».

C:\PS> get-wmiobject win32_service | where-object {$_.Name -eq "tlntsvr"}

ExitCode  : 0
Name      : TlntSvr
ProcessId : 0
StartMode : Disabled
State     : Stopped
Status    : OK

La commande suivante utilise l'applet de commande Set-Service pour modifier le type de démarrage du service Tlntsvr en « Manual ».

C:\PS> set-service tlntsvr -startuptype manual

Il est maintenant possible d'envoyer à nouveau la commande Start-Service. Cette fois, elle réussit.

C:\PS> start-service tlntsvr

Pour vérifier que la commande a réussi, utilisez une commande Get-Service.






Voir aussi




Table des matières