Start-Service
Démarre un ou plusieurs services arrêtés.
Syntaxe
InputObject (Par défaut)
Start-Service
[-InputObject] <ServiceController[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Start-Service
[-Name] <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DisplayName
Start-Service
-DisplayName <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Start-Service envoie un message de démarrage au contrôleur de service 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 par leurs noms de service ou noms d’affichage, ou vous pouvez utiliser le paramètre InputObject pour fournir un objet de service qui représente les services que vous souhaitez démarrer.
Exemples
Exemple 1 : Démarrer un service à l’aide de son nom
Cet exemple démarre le service EventLog sur l’ordinateur local. Le paramètre Name identifie le service par son nom de service.
Start-Service -Name "eventlog"
Exemple 2 : Afficher des informations sans démarrer un service
Cet exemple montre ce qui se produirait si vous avez démarré les services dont le nom d’affichage inclut « remote ».
Start-Service -DisplayName *remote* -WhatIf
Le paramètre DisplayName identifie les services par leur nom complet au lieu de leur nom de service. Le paramètre WhatIf entraîne l’affichage de l’applet de commande lorsque vous exécutez la commande, mais n’apporte pas de modifications.
Exemple 3 : Démarrer un service et enregistrer l’action dans un fichier texte
Cet exemple démarre le service WMI (Windows Management Instrumentation) sur l’ordinateur et ajoute un enregistrement de l’action au fichier services.txt.
$s = Get-Service wmi
Start-Service -InputObject $s -PassThru | Format-List >> services.txt
Tout d’abord, nous utilisons Get-Service pour obtenir un objet qui représente le service WMI et le stocker dans la variable $s. Ensuite, nous commençons le service. Sans le paramètre passThru Start-Service à l’applet de commande Format-List pour mettre l’objet en forme sous forme de liste de ses propriétés. L’opérateur de redirection append (>>) redirige la sortie vers le fichier services.txt. La sortie est ajoutée à la fin du fichier existant.
Exemple 4 : Démarrer un service désactivé
Cet exemple montre comment démarrer un service lorsque le type de démarrage du service est Désactivé.
PS> Start-Service tlntsvr
Start-Service : Service 'Telnet (TlntSvr)' cannot be started due to the following error: Cannot start service TlntSvr on computer '.'.
At line:1 char:14
+ Start-Service <<<< tlntsvr
PS> Get-CimInstance win32_service | Where-Object Name -eq "tlntsvr"
ExitCode : 0
Name : TlntSvr
ProcessId : 0
StartMode : Disabled
State : Stopped
Status : OK
PS> Set-Service tlntsvr -StartupType manual
PS> Start-Service tlntsvr
La première tentative de démarrage du service Telnet (tlntsvr) échoue. La commande Get-CimInstance montre que la propriété StartMode du service Tlntsvr est Disabled. L’applet de commande Set-Service modifie le type de démarrage en manuel. À présent, nous pouvons renvoyer la commande Start-Service. Cette fois, la commande réussit. Pour vérifier que la commande a réussi, exécutez Get-Service.
Paramètres
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DisplayName
Spécifie les noms d’affichage des services à démarrer. Les caractères génériques sont autorisés.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
DisplayName
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-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.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Include
Spécifie les services que ce cmdlet dé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.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-InputObject
Spécifie les objets ServiceController représentant les services à démarrer. Entrez une variable qui contient les objets, ou tapez une commande ou une expression qui obtient les objets.
Propriétés du paramètre
| Type: | ServiceController[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
InputObject
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Spécifie les noms des services à démarrer.
Le nom du paramètre est facultatif. Vous pouvez utiliser Nom ou son alias, ServiceName, ou vous pouvez omettre le nom du paramètre.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Nom du Service |
Jeux de paramètres
Default
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-PassThru
Retourne un objet qui représente le nouveau service. Par défaut, cette applet de commande ne génère aucune sortie.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Entrées
System.ServiceProcess.ServiceController, System.String
Vous pouvez diriger des objets qui représentent les services ou les chaînes qui contiennent les noms 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, si vous spécifiez passThru. Sinon, cette applet de commande ne génère aucune sortie.
Notes
- Vous pouvez également faire référence à
Start-Servicepar son alias intégré,sasv. Pour plus d’informations, consultez about_Aliases. -
Start-Servicepouvez contrôler les services uniquement si 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. - Vous ne pouvez démarrer que les services qui ont un type de démarrage Manuel, Automatique ou Automatique (Démarrage différé). Vous ne pouvez pas démarrer les services dont le type de démarrage est Désactivé. Si une commande
Start-Serviceéchoue avec le messageCannot start service \<service-name\> on computer, utilisezGet-CimInstancepour rechercher le type de démarrage du service et, si vous le souhaitez, utilisez l’applet de commandeSet-Servicepour modifier le type de démarrage du service. - Certains services, tels que les journaux de performances et les alertes (SysmonLog) s’arrêtent automatiquement s’ils n’ont pas de travail à faire. Lorsque PowerShell démarre un service qui s’arrête presque immédiatement, il affiche le message suivant :
Service \<display-name\> start failed.