Start-Service
Démarre un ou plusieurs services arrêtés.
Syntax
Start-Service
[-InputObject] <ServiceController[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Start-Service
[-Name] <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Start-Service
[-PassThru]
-DisplayName <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Cette applet de commande est disponible uniquement sur la plateforme Windows.
L’applet Start-Service
de commande 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 leur nom de service ou leur nom 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 lancez les services dont le nom d’affichage inclut « remote ».
Start-Service -DisplayName *remote* -WhatIf
Le paramètre DisplayName identifie les services par leur nom d’affichage au lieu de leur nom de service. Le paramètre WhatIf permet à l’applet de commande d’afficher ce qui se produit 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
Nous utilisons Get-Service
d’abord pour obtenir un objet qui représente le service WMI et le stocker dans la $s
variable. Ensuite, nous commençons le service. Sans le paramètre PassThru , Start-Service
ne crée aucune sortie. L’opérateur de pipeline (|
) transmet la sortie de Start-Service
l’objet à l’applet Format-List
de commande pour mettre en forme l’objet en tant que liste de ses propriétés. L’opérateur de redirection d’ajout (>>
) 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 Get-CimInstance
commande indique que la propriété StartMode du service Tlntsvr est Désactivée. L’applet Set-Service
de commande remplace le type de démarrage par Manuel. À présent, nous pouvons soumettre à nouveau la Start-Service
commande. Cette fois, elle réussit. Pour vérifier que la commande a réussi, exécutez Get-Service
.
Paramètres
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Spécifie les noms d’affichage des services à démarrer. Les caractères génériques sont autorisés.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Exclude
Spécifie les services que cette applet de commande omet. 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Include
Spécifie les services que cette applet de commande 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-InputObject
Spécifie les objets ServiceController représentant les services à démarrer. Entrez une variable contenant les objets, ou tapez une commande ou une expression qui obtient ces objets.
Type: | ServiceController[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
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 omettre le nom du paramètre.
Type: | String[] |
Aliases: | ServiceName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Retourne un objet qui représente le nouveau service. Par défaut, cette applet de commande ne génère aucun résultat.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
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
Cette applet de commande est disponible uniquement sur les plateformes Windows.
- Vous pouvez également faire référence à par
Start-Service
son alias intégré,sasv
. Pour plus d’informations, consultez about_Aliases. Start-Service
peut contrôler les services uniquement si 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 service et les noms d’affichage des services sur votre système, tapez
Get-Service
. Les noms de service s’affichent dans la colonne Nom et les noms d’affichage apparaissent dans la colonne DisplayName . - Vous pouvez démarrer uniquement 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
Start-Service
commande échoue avec le messageCannot start service \<service-name\> on computer
, utilisezGet-CimInstance
pour rechercher le type de démarrage du service et, si vous le devez, utilisez l’appletSet-Service
de commande pour modifier le type de démarrage du service. - 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 PowerShell démarre un service qui s’arrête presque immédiatement, il affiche le message suivant :
Service \<display-name\> start failed.