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