ServiceSet

  • Artikel

Übersicht

Verwalten mehrerer Dienste mit allgemeinen Einstellungen.

Syntax

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

BESCHREIBUNG

ServiceSet ist eine zusammengesetzte Ressource, die es einfacher macht, mehrere Dienste gleichzeitig mit freigegebenen, aber begrenzten Konfigurationen zu verwalten. Diese Ressource kann nur vorhandene Dienste aktualisieren oder entfernen. Es kann keine Dienste erstellen. Weitere Kontrolle über die Konfiguration Ihrer Dienste finden Sie in der Dienstressource.

Wichtig

Zusammengesetzte Ressourcen funktionieren nicht mit Invoke-DscResource. Diese Ressource kann nur innerhalb einer Configuration Definition verwendet werden.

Requirements (Anforderungen)

Keine

Eigenschaften

Schlüsseleigenschaften

Name

Geben Sie die Namen der Dienste als Array von Zeichenfolgen an.

Dies unterscheidet sich möglicherweise vom Anzeigenamen des Diensts. Um eine Liste aller Dienste mit ihren Namen und aktuellen Status abzurufen, verwenden Sie das Get-Service Cmdlet.

Type: System.String[]
Behavior: Key

Optionale Eigenschaften

BuiltInAccount

Geben Sie den Namen des Computerkontos an, um den Dienst auszuführen. Das Konto muss Zugriff auf die ausführbare Datei jedes Diensts haben, um den Dienst zu starten.

Geben Sie diese Eigenschaft nicht mit der Credential-Eigenschaft an.

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

Anmeldeinformationen

Geben Sie die Anmeldeinformationen für ein Konto an, um die Dienste auszuführen. Das Konto muss Zugriff auf die ausführbare Datei jedes Diensts haben, um diesen Dienst zu starten. Die Ressource gewährt diesem Konto automatisch das Recht "Anmelden als Dienst".

Geben Sie diese Eigenschaft nicht mit der BuiltInAccount-Eigenschaft an.

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

Ensure

Geben Sie an, ob die Dienste vorhanden sein sollen. Um einen Dienst hinzuzufügen oder zu aktualisieren, legen Sie diese Eigenschaft auf Present. Um einen Dienst zu entfernen, legen Sie diese Eigenschaft auf Absent.

Standardwert: Present.

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

StartupType

Geben Sie an, wie sich die Dienste auf dem Systemstart verhalten sollten. Folgende Werte sind zulässig:

  • Automatic - Der Dienst wird vom Betriebssystemstart gestartet. Wenn ein automatisch gestarteter Dienst von einem manuell gestarteten Dienst abhängig ist, wird der manuell gestartete Dienst auch automatisch beim Systemstart gestartet.
  • Disabled - Der Dienst ist deaktiviert und kann nicht von einem Benutzer oder einer Anwendung gestartet werden.
  • Manual - Der Dienst wird nur manuell, von einem Benutzer, mithilfe des Dienststeuerungs-Managers oder einer Anwendung gestartet.

Wenn der Dienst nicht vorhanden ist, lautet Automaticder Standardwert .

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

State

Geben Sie an, ob die Dienste ausgeführt werden sollen. Folgende Werte sind zulässig:

  • Running - Die Ressource startet den Dienst, wenn er noch nicht gestartet wird.
  • Stopped - Die Ressource beendet den Dienst, wenn er ausgeführt wird.
  • Ignore - Die Ressource startet den Dienst nicht, oder beendet den Dienst.

Der Standardwert ist Running.

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

Beispiele