Set-Service
Démarre, arrête et interrompt un service et modifie ses propriétés.
Syntaxe
Name (Par défaut)
Set-Service
[-Name] <String>
[-ComputerName <String[]>]
[-DisplayName <String>]
[-Description <String>]
[-StartupType <ServiceStartMode>]
[-Status <String>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
Set-Service
[-ComputerName <String[]>]
[-DisplayName <String>]
[-Description <String>]
[-StartupType <ServiceStartMode>]
[-Status <String>]
[-InputObject <ServiceController>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Set-Service modifie les propriétés d’un service, telles que l'd’état, Description, DisplayNameet StartupType.
Set-Service peut démarrer, arrêter, suspendre ou mettre en pause un service. Pour identifier un service, entrez son nom de service ou envoyez un objet de service. Ou envoyez un nom de service ou un objet de service le long du pipeline vers Set-Service.
Exemples
Exemple 1 : Modifier un nom d'affichage
Dans cet exemple, le nom d’affichage d’un service est modifié. Pour afficher le nom d'affichage d'origine, utilisez Get-Service.
Set-Service -Name LanmanWorkstation -DisplayName "LanMan Workstation"
Set-Service utilise le paramètre Name pour spécifier le nom du service, LanmanWorkstation. Le paramètre DisplayName spécifie le nouveau nom d’affichage Station de travail LanMan.
Exemple 2 : Modifier le type de démarrage des services
Cet exemple montre comment modifier le type de démarrage d’un service.
Set-Service -Name BITS -StartupType Automatic
Get-Service BITS | Select-Object -Property Name, StartType, Status
Name StartType Status
---- --------- ------
BITS Automatic Running
Set-Service utilise le paramètre Name pour spécifier le nom du service, BITS. Le paramètre StartupType définit le service sur Automatique.
Get-Service utilise le paramètre Name pour spécifier le service BITS et envoyer l’objet plus loin dans le pipeline.
Select-Object utilise le paramètre Property pour afficher l’état du service BITS.
Exemple 3 : Modifier la description d’un service
Cet exemple montre comment modifier la description du service BITS et afficher le résultat.
L’applet de commande Get-CimInstance est utilisée parce qu'elle renvoie un objet Win32_Service qui comprend la Description du service.
Get-CimInstance Win32_Service -Filter 'Name = "BITS"' | Format-List Name, Description
Name : BITS
Description : Transfers files in the background using idle network bandwidth. If the service is
disabled, then any applications that depend on BITS, such as Windows Update or MSN
Explorer, will be unable to automatically download programs and other information.
Set-Service -Name BITS -Description "Transfers files in the background using idle network bandwidth."
Get-CimInstance Win32_Service -Filter 'Name = "BITS"' | Format-List Name, Description
Name : BITS
Description : Transfers files in the background using idle network bandwidth.
Get-CimInstance envoie l’objet vers le bas du pipeline pour Format-List et affiche le nom et la description du service. À des fins de comparaison, la commande est exécutée avant et après la mise à jour de la description.
Set-Service utilise le paramètre Name pour spécifier le service BITS. Le paramètre Description spécifie le texte mis à jour pour la description des services.
Exemple 4 : Démarrer un service
Dans cet exemple, un service est démarré.
Set-Service -Name WinRM -Status Running -PassThru
Status Name DisplayName
------ ---- -----------
Running WinRM Windows Remote Management (WS-Manag...
Set-Service utilise le paramètre Name pour spécifier le service, WinRM . Le paramètre Status utilise la valeur En cours d’exécution pour démarrer le service. Le paramètre passThru génère un objet ServiceController qui affiche les résultats.
Exemple 5 : Suspendre un service
Cet exemple utilise le pipeline pour mettre le service en pause.
Get-Service -Name Schedule | Set-Service -Status Paused
Get-Service utilise le paramètre Name pour spécifier le service Schedule, et envoie l’objet vers le bas du pipeline. La cmdlet Set-Service utilise le paramètre Status pour définir le service sur Paused.
Exemple 6 : Arrêter un service
Cet exemple utilise une variable pour arrêter un service.
$S = Get-Service -Name Schedule
Set-Service -InputObject $S -Status Stopped
Get-Service utilise le paramètre Name pour spécifier le service Schedule. L’objet est stocké dans la variable, $S.
Set-Service utilise le paramètre InputObject et spécifie l’objet stocké $S. Le paramètre Status définit le service sur Stopped.
Exemple 7 : Définir le type de démarrage pour plusieurs services
L’applet de commande Set-Service accepte un seul nom de service à la fois. Toutefois, vous pouvez diriger plusieurs services vers Set-Service pour modifier la configuration de plusieurs services.
Get-Service SQLWriter,spooler |
Set-Service -StartupType Automatic -PassThru |
Select-Object Name, StartType
Name StartType
---- ---------
spooler Automatic
SQLWriter Automatic
Paramètres
-ComputerName
Spécifie un ou plusieurs ordinateurs. Pour les ordinateurs distants, tapez le nom NetBIOS, une adresse IP ou un nom de domaine complet. Si le paramètre ComputerName n’est pas spécifié, la commande s’exécute sur l’ordinateur local.
Ce paramètre ne repose pas sur la communication à distance de PowerShell. Vous pouvez utiliser le paramètre ComputerName même si votre ordinateur n’est pas configuré pour exécuter des commandes distantes.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | Local computer |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Chine |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Confirm
Vous invite à confirmer avant d’exécuter Set-Service.
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 |
-Description
Spécifie une nouvelle description pour le service.
La description du service s’affiche dans Gestion des ordinateurs, Services. La Description n’est pas une propriété de l’objet Get-ServiceServiceController. Pour afficher la description du service, utilisez Get-CimInstance qui retourne un objet Win32_Service qui représente le service.
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 |
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 un nouveau nom d'affichage pour le service.
Remarque
En règle générale, Set-Service fonctionne uniquement sur les services Windows et non sur les pilotes. Toutefois, si vous spécifiez le nom d’un pilote, Set-Service pouvez cibler le pilote.
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: | DN |
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 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, telle qu’une commande Get-Service. Vous pouvez utiliser le pipeline pour envoyer un objet de service à Set-Service.
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: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Spécifie le nom du service à modifier. Les caractères génériques ne sont pas autorisés. Vous pouvez utiliser le pipeline pour envoyer un nom de service à Set-Service.
Remarque
En règle générale, Set-Service fonctionne uniquement sur les services Windows et non sur les pilotes. Toutefois, si vous spécifiez le nom d’un pilote, Set-Service pouvez cibler le pilote.
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, SN |
Jeux de paramètres
Name
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-PassThru
Renvoie un objet ServiceController qui représente les services qui ont été modifiés. Par défaut, Set-Service ne génère aucune sortie.
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 |
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 |
-StartupType
Définit le type de démarrage du service. Les valeurs acceptables pour ce paramètre sont les suivantes :
- automatique : le service est démarré ou a été démarré par le système d’exploitation, au démarrage du système. Si un service démarré automatiquement dépend d’un service démarré manuellement, le service démarré manuellement est également démarré automatiquement au démarrage du système.
- désactivé : le service est désactivé et ne peut pas être démarré par un utilisateur ou une application.
- manuel : le service est démarré manuellement, par un utilisateur, à l’aide du Gestionnaire de contrôle de service ou d’une application.
- de démarrage : indique que le service est un pilote de périphérique démarré par le chargeur système. Cette valeur est valide uniquement pour les pilotes de périphérique.
- système : indique que le service est un pilote de périphérique démarré par la fonction « IOInitSystem() ». Cette valeur est valide uniquement pour les pilotes de périphérique.
La valeur par défaut est automatique.
Propriétés du paramètre
| Type: | ServiceStartMode |
| Valeur par défaut: | Automatic |
| Valeurs acceptées: | Boot, System, Automatic, Manual, Disabled |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | StartMode, SM, ST |
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 |
-Status
Spécifie l’état du service.
Les valeurs acceptables pour ce paramètre sont les suivantes :
- En pause. suspend le service.
- En cours d'exécution. démarre le service.
- Arrêtée. Arrête le service.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Valeurs acceptées: | Paused, Running, Stopped |
| 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
Montre ce qui se passerait si Set-Service s’exécute. L’applet de commande n’est pas exécutée.
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
ServiceController
Vous pouvez diriger un objet de service vers cette applet de commande.
String
Vous pouvez diriger une chaîne qui contient un nom de service vers cette applet de commande.
Sorties
None
Par défaut, cette applet de commande ne retourne aucune sortie.
ServiceController
Lorsque vous utilisez le paramètre passThru, cette applet de commande retourne un objet ServiceController.
Notes
Set-Service nécessite des autorisations élevées. Utilisez l’option Exécuter en tant qu’administrateur.
Set-Service ne peut contrôler que les services lorsque l’utilisateur actuel dispose des autorisations nécessaires pour gérer les services. Si une commande ne fonctionne pas correctement, vous n’avez peut-être pas les autorisations requises.
Pour rechercher le nom du service ou le nom d’affichage d’un service, utilisez Get-Service. Les noms de service se trouvent dans la colonne Name et les noms d’affichage se trouvent dans la colonne DisplayName.
