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.
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.
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.
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
Spécifie le mode de démarrage du service.
Les valeurs acceptables pour ce paramètre sont les suivantes :
- Automatique. Démarre au démarrage du système.
- Disabled. Le service ne peut pas être démarré.
- Manuelle. Démarre uniquement quand un utilisateur ou un programme a démarré.
Propriétés du paramètre
| Type: | ServiceStartMode |
| Valeur par défaut: | None |
| Valeurs acceptées: | Automatic, Boot, Disabled, Manual, System |
| 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
System.ServiceProcess.ServiceController, System.String
Vous pouvez utiliser le pipeline pour envoyer un objet de service ou une chaîne contenant un nom de service à Set-Service.
Sorties
ServiceController
Par défaut, Set-Service ne renvoie aucun objet. Utilisez le paramètre PassThru pour générer 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.