ServiceSet

  • Article

Synopsis

Gérez plusieurs services avec des paramètres courants.

Syntaxe

ServiceSet [String] #ResourceName
{
    [DependsOn = [String[]]]
    [PsDscRunAsCredential = [PSCredential]]
    Name = [String[]]
    [Ensure = [String]]
    [StartupType = [String]]
    [BuiltInAccount = [String]]
    [State = [String]]
    [Credential = [PSCredential]]
}

Description

ServiceSet est une ressource composite qui simplifie la gestion de plusieurs services à la fois avec des configurations partagées mais limitées. Cette ressource ne peut mettre à jour ou supprimer que des services existants. Il ne peut pas créer de services. Pour plus de contrôle sur la configuration de vos services, consultez la ressource service.

Important

Les ressources composites ne fonctionnent pas avec Invoke-DscResource. Cette ressource est utilisable uniquement à l’intérieur d’une Configuration définition.

Configuration requise

Aucun.

Propriétés

Propriétés de la clé

Nom

Spécifiez les noms des services sous forme de tableau de chaînes.

Cela peut être différent du nom complet du service. Pour récupérer une liste de tous les services avec leurs noms et états actuels, utilisez l’applet Get-Service de commande.

Type: System.String[]
Behavior: Key

Propriétés facultatives

BuiltInAccount

Spécifiez le nom du compte d’ordinateur à exécuter le service en tant que. Le compte doit avoir accès à l’exécutable de chaque service 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 les services en tant que. Le compte doit avoir accès à l’exécutable de chaque service pour démarrer ce service. La ressource accorde automatiquement à ce compte le droit « Se connecter en tant que service ».

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

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

Ensure

Spécifiez si les services doivent exister. Pour ajouter ou mettre à jour un service, définissez cette propriété sur Present. Pour supprimer un service, définissez cette propriété sur Absent.

La valeur par défaut est Present.

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

StartupType

Spécifiez comment les services doivent se comporter au 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 les services doivent 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 arrête le service.

La valeur par défaut est Running.

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

Exemples