Service

  • Article

Synopsis

Gérer un service Windows.

Syntaxe

Service [String] #ResourceName
{
    Name = [string]
    [BuiltInAccount = [string]{ LocalService | LocalSystem | NetworkService }]
    [Credential = [PSCredential]]
    [Dependencies = [string[]]]
    [DependsOn = [string[]]]
    [Description = [string]]
    [DesktopInteract = [bool]]
    [DisplayName = [string]]
    [Ensure = [string]{ Absent | Present }]
    [Path = [string]]
    [PsDscRunAsCredential = [PSCredential]]
    [StartupTimeout = [UInt32]]
    [StartupType = [string]{ Automatic | Disabled | Manual }]
    [State = [string]{ Ignore | Running | Stopped }]
    [TerminateTimeout = [UInt32]]
}

Description

La Service ressource vous permet d’ajouter, de mettre à jour et de supprimer des services.

Configuration requise

Aucun.

Propriétés de la clé

Nom

Spécifiez le nom du service sous forme de chaîne.

Notes

Parfois, cette valeur est différente du nom complet. Vous pouvez obtenir une liste des services et leur état actuel avec l’applet de commande Get-Service.

Type: System.String

Propriétés facultatives

BuiltInAccount

Spécifiez le nom du compte d’ordinateur pour exécuter le service en tant que. Le compte doit avoir accès à l’exécutable spécifié par Path pour démarrer le service.

Ne spécifiez pas cette propriété avec la propriété Credential .

Type: System.String
Accepted Values:
  - LocalService
  - LocalSystem
  - NetworkService
Default Value: Null

Informations d'identification

Spécifiez les informations d’identification d’un compte pour exécuter le service en tant que. Le compte doit avoir accès à l’exécutable spécifié par Chemin d’accès pour démarrer le service. La ressource accorde automatiquement le droit « Se connecter en tant que service » à ce compte.

Ne spécifiez pas cette propriété avec la propriété BuiltInAccount .

Type: System.Management.Automation.PSCredential
Default Value: None

Les dépendances

Spécifiez les noms des services que ce service doit exécuter en tant que tableau de chaînes.

Type: System.String[]
Default Value: None

Description

Spécifiez la description du service sous forme de chaîne. La description du service s’affiche dans Gestion de l’ordinateur, Services.

Type: System.String
Default Value: None

DesktopInteract

Spécifiez si le service peut créer ou communiquer avec une fenêtre sur le bureau. Cette propriété doit être $false si BuiltInAccount n’est pas spécifié en tant que LocalSystem.

La valeur par défaut est $false.

Type: System.Boolean
Default Value: false

DisplayName

Spécifiez le nom complet convivial du service sous forme de chaîne.

Type: System.String
Default Value: None

Ensure

Spécifiez si le service doit exister. Pour ajouter ou mettre à jour un service, définissez cette propriété Presentsur . Pour supprimer un service, définissez cette propriété Absentsur .

La valeur par défaut est Present.

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

Chemin d’accès

Spécifiez le chemin d’accès au fichier exécutable du service sous forme de chaîne. Cette propriété est requise si le service n’existe pas.

Type: System.String
Default Value: None

StartupTimeout

Spécifiez le temps d’attente pour que le service démarre en millisecondes.

La valeur par défaut est 30000.

Type: System.UInt32
Default Value: 30000

StartupType

Spécifiez le comportement du service lors du démarrage du système. La valeur doit être l'une des suivantes :

  • Automatic - Le service est 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.
  • Disabled - Le service est désactivé et ne peut pas être démarré par un utilisateur ou une application.
  • Manual - Le service est démarré manuellement, par un utilisateur, à l’aide du Gestionnaire de contrôle de service ou d’une application.

Si le service n’existe pas, la valeur par défaut est Automatic.

Type: System.String
Behavior: Write
Accepted Values:
  - Automatic
  - Disabled
  - Manual
Default Value: None

State

Spécifiez si le service doit s’exécuter. La valeur doit être l'une des suivantes :

  • Running - La ressource démarre le service s’il n’est pas déjà démarré.
  • Stopped - La ressource arrête le service s’il est en cours d’exécution.
  • Ignore - La ressource ne démarre pas ou n’arrête pas le service.

La valeur par défaut est Running.

Type: System.String
Accepted Values:
  - Running
  - Stopped
  - Ignore
Default Value: Running

TerminateTimeout

Spécifiez le temps d’attente pour que le service s’arrête en millisecondes. La valeur par défaut est 30000.

Type: System.UInt32
Default Value: 30000

Exemples