Partager via

Set-Service

  • Référence
Module:
Microsoft.PowerShell.Management

Démarre, arrête et interrompt un service, puis modifie ses propriétés.

Syntaxe

Set-Service
   [-ComputerName <String[]>]
   [-Name] <String>
   [-DisplayName <String>]
   [-Description <String>]
   [-StartupType <ServiceStartMode>]
   [-Status <String>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Service
   [-ComputerName <String[]>]
   [-DisplayName <String>]
   [-Description <String>]
   [-StartupType <ServiceStartMode>]
   [-Status <String>]
   [-InputObject <ServiceController>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet Set-Service de commande modifie les propriétés d’un service, telles que Status, Description, DisplayName et StartupType. Set-Service peut démarrer, arrêter, suspendre ou suspendre 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 vers le pipeline Set-Service.

Exemples

Exemple 1 : Modifier un nom complet

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 complet, 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-Serviceutilise le paramètre Name pour spécifier le service BITS et envoie l’objet vers le bas du 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 Get-CimInstance de commande est utilisée, car elle retourne un objet Win32_Service qui inclut 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 et Format-List 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 suspendre le service.

Get-Service -Name Schedule | Set-Service -Status Paused

Get-Serviceutilise le paramètre Name pour spécifier le service Schedule et envoie l’objet vers le bas du pipeline. Set-Serviceutilise le paramètre Status pour définir le service sur Pause.

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 Arrêté.

Exemple 7 : Définir le type de démarrage pour plusieurs services

L’applet Set-Service de commande accepte un seul nom de service à la fois. Toutefois, vous pouvez diriger plusieurs services pour Set-Service 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 s’appuie pas sur la communication à distance PowerShell. Vous pouvez utiliser le paramètre ComputerName même si votre ordinateur n’est pas configuré pour exécuter des commandes distantes.

Type:String[]
Alias:cn
Position:Named
Valeur par défaut:Local computer
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Confirm

Vous invite à confirmer avant d’exécuter Set-Service.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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-Service ServiceController . Pour afficher la description du service, utilisez Get-CimInstance cette propriété qui renvoie un objet Win32_Service qui représente le service.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisplayName

Spécifie le nouveau nom d'affichage du 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 vous pouvez cibler le pilote.

Type:String
Alias:DN
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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, par exemple une Get-Service commande. Vous pouvez utiliser le pipeline pour envoyer un objet de service à Set-Service.

Type:ServiceController
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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 vous pouvez cibler le pilote.

Type:String
Alias:ServiceName, SN
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-StartupType

Définit le type de démarrage du service. Les valeurs valides pour ce paramètre sont :

  • Automatique : le service est démarré ou a été démarré par le système d’exploitation, au démarrage du système. Lorsqu'un service automatiquement démarré dépend d'un service manuellement démarré, le service manuellement démarré est également automatiquement démarré 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.
  • 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.

Type:ServiceStartMode
Alias:StartMode, SM, ST
Valeurs acceptées:Boot, System, Automatic, Manual, Disabled
Position:Named
Valeur par défaut:Automatic
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Status

Spécifie l’état du service.

Les valeurs acceptables pour ce paramètre sont les suivantes :

  • En pause. suspend le service.
  • Exécution en cours. démarre le service.
  • Arrêté. arrête le service.
Type:String
Valeurs acceptées:Paused, Running, Stopped
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passe si Set-Service des exécutions sont exécutées. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

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 peut uniquement contrôler 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 .