Démarre, arrête et interrompt un service, puis modifie ses propriétés.
Syntaxe
Set-Service [-Name] <string> [-Description <string>] [-DisplayName <string>] [-PassThru] [-StartupType {<Automatic> | <Manual> | <Disabled>}] [-Status <string>] [-ComputerName <string[]>] [-Confirm] [-WhatIf] [<CommonParameters>]
Set-Service [-Description <string>] [-DisplayName <string>] [-InputObject <ServiceController>] [-PassThru] [-StartupType {<Automatic> | <Manual> | <Disabled>}] [-Status <string>] [-ComputerName <string[]>] [-Confirm] [-WhatIf] [<CommonParameters>]
Description
L'applet de commande Set-Service modifie les propriétés d'un service local ou distant, notamment l'état, la description, le nom d'affichage et le mode de démarrage. Vous pouvez utiliser cette applet de commande pour démarrer, arrêter ou interrompre (suspendre) un service. Pour identifier un service, entrez son nom de service, envoyez un objet service ou dirigez un nom de service ou un objet service vers Set-Service.
Paramètres
-ComputerName <string[]>
Spécifie un ou plusieurs ordinateurs. La valeur par défaut est l'ordinateur local.
Tapez le nom NetBIOS, une adresse IP ou un nom de domaine complet d'un ordinateur distant. Pour spécifier l'ordinateur local, tapez le nom de l'ordinateur, un point (.) ou « localhost ».
Ce paramètre ne s'appuie pas sur la communication à distance Windows PowerShell. Vous pouvez utiliser le paramètre ComputerName de Set-Service même si votre ordinateur n'est pas configuré pour exécuter des commandes distantes.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
local computer |
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
|
Accepter les caractères génériques ? |
false |
-Description <string>
Spécifie une nouvelle description pour le service.
La description du service s'affiche sous Services dans l'outil Gestion de l'ordinateur. La description n'est pas une propriété de l'objet ServiceController obtenue par Get-Service. Pour afficher la description d'un service, utilisez Get-WmiObject pour obtenir un objet Win32_Service qui représente le service.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-DisplayName <string>
Spécifie le nouveau nom d'affichage du service.
|
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 un objet ServiceController qui représente le service à modifier. Entrez une variable qui contient l'objet ou tapez une commande ou une expression qui obtient l'objet (commande Get-Service, par exemple). Vous pouvez également diriger un objet service vers Set-Service.
|
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 du service à modifier. Les caractères génériques ne sont pas autorisés. Vous pouvez également diriger un nom de service vers Set-Service.
|
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 des objets qui représentent les services qui ont été modifiés. 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 |
-StartupType <ServiceStartMode>
Modifie le mode de démarrage du service. Les valeurs valides pour StartupType sont les suivantes :
-- Automatic : démarre lorsque le système démarre.
-- Manual : démarre uniquement en cas de démarrage par un utilisateur ou un programme.
-- Disabled : ne peut pas être démarré.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Status <string>
Démarre, arrête ou interrompt (suspend) les services. Les valeurs valides sont :
-- Running : démarre le service.
--Stopped : arrête le service.
-- Paused : interrompt le service.
|
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 Set-Service. |
|
Sorties |
None Cette applet de commande ne retourne pas d'objets. |
Remarques
Pour utiliser Set-Service sur Windows Vista et les versions ultérieures de Windows, démarrez Windows PowerShell avec l'option Exécuter en tant qu'administrateur.
Set-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.
Exemple 1
C:\PS>set-service -name lanmanworkstation -DisplayName "LanMan Workstation" Description ----------- Cette commande modifie le nom d'affichage du service lanmanworkstation en « LanMan Workstation ». La valeur par défaut est « Workstation ».
Exemple 2
C:\PS>get-wmiobject win32_service -filter "name = 'SysmonLog'" ExitCode : 0 Name : SysmonLog ProcessId : 0 StartMode : Manual State : Stopped Status : OK C:\PS> set-service sysmonlog -startuptype automatic C:\PS> get-wmiobject win32_service -filter "name = 'SysmonLog'" ExitCode : 0 Name : SysmonLog ProcessId : 0 StartMode : Auto State : Stopped Status : OK C:\PS> get-wmiobject win32_service | format-table Name, StartMode -auto Name StartMode ---- --------- AdtAgent Auto Alerter Disabled ALG Manual AppMgmt Manual ... Description ----------- Ces commandes obtiennent le type de démarrage du service Journaux et alertes de performance (SysmonLog), affectent la valeur « Automatic » au mode de démarrage et affichent le résultat de la modification. Ces commandes utilisent l'applet de commande Get-WmiObject pour obtenir l'objet Win32_Service du service, car l'objet ServiceController retourné par Get-Service n'inclut pas le mode de démarrage. La première commande utilise l'applet de commande Get-WmiObject pour obtenir l'objet WMI (Windows Management Instrumentation) qui représente le service SysmonLog. La sortie par défaut de cette commande affiche le mode de démarrage du service. La deuxième commande utilise Set-Service pour modifier le mode de démarrage en « Automatic ». La première commande est ensuite répétée pour afficher la modification. La dernière commande affiche le mode de démarrage de tous les services sur l'ordinateur.
Exemple 3
C:\PS>set-service -name Schedule -computername S1 -description "Configures and schedules tasks."
C:\PS> get-wmiobject win32_service -computername s1 | where-object {$_.Name -eq "Schedule"} | format-list Name, Description
Description
-----------
Ces commandes modifient la description du service Planificateur de tâches sur l'ordinateur distant S1, puis elles affichent le résultat.
Ces commandes utilisent l'applet de commande Get-WmiObject pour obtenir l'objet Win32_Service du service, car l'objet ServiceController retourné par Get-Service n'inclut pas la description du service.
La première commande utilise une commande Set-Service pour modifier la description. Elle identifie le service à l'aide de son nom de service, « Schedule ».
La deuxième commande utilise l'applet de commande Get-WmiObject pour obtenir une instance de WMI Win32_Service qui représente le service Planificateur de tâches. Le premier élément de la commande obtient toutes les instances de la classe Win32_service.
L'opérateur de pipeline (|) passe le résultat à l'applet de commande Where-Object qui sélectionne les instances dont la propriété Name a la valeur « Schedule ».
Un autre opérateur de pipeline envoie le résultat à l'applet de commande Format-List qui met en forme la sortie afin d'afficher une liste répertoriant uniquement les propriétés Name et Description.
Exemple 4
C:\PS>set-service winrm -status Running -passthru -computername Server02 Description ----------- Cette commande démarre le service WinRM sur l'ordinateur Server02. La commande utilise le paramètre Status pour spécifier l'état souhaité (« Running ») et le paramètre PassThru pour diriger Set-Service de manière à retourner un objet qui représente le service WinRM.
Exemple 5
C:\PS>get-service schedule -computername S1, S2 | set-service -status paused Description ----------- Cette commande interrompt le service Planification sur les ordinateurs distants S1 et S2. Elle utilise l'applet de commande Get-Service pour obtenir le service. Un opérateur de pipeline (|) envoie le service à l'applet de commande Set-Service, qui change son état en « Paused ».
Exemple 6
C:\PS>$s = get-service schedule C:\PS> set-service -inputobject $s -status stopped Description ----------- Ces commandes arrêtent le service Planification sur l'ordinateur local. La première commande utilise l'applet de commande Get-Service pour obtenir le service Planification. La commande enregistre le service dans la variable $s. La deuxième commande utilise l'applet de commande Set-Service pour changer l'état du service Planification en « Stopped ». Elle utilise le paramètre InputObject pour envoyer le service stocké dans la variable $s et le paramètre Status pour spécifier l'état souhaité.
Voir aussi