Dienst

  • Artikel

Übersicht

Verwalten eines Windows-Diensts.

Syntax

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]]
}

BESCHREIBUNG

Mit der Service Ressource können Sie Dienste hinzufügen, aktualisieren und entfernen.

Requirements (Anforderungen)

Keine

Schlüsseleigenschaften

Name

Geben Sie den Dienstnamen als Zeichenfolge an.

Hinweis

Manchmal unterscheidet sich dieser Wert vom Anzeigenamen. Mit dem Cmdlet Get-Service können Sie eine Liste der Dienste und ihren aktuellen Status abrufen.

Type: System.String

Optionale Eigenschaften

BuiltInAccount

Geben Sie den Namen des Computerkontos an, um den Dienst auszuführen. Das Konto muss Zugriff auf die von Path angegebene ausführbare Datei 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 den Dienst auszuführen. Das Konto muss Zugriff auf die von Path angegebene ausführbare Datei haben, um den 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

Abhängigkeiten

Geben Sie die Namen von Diensten an, die dieser Dienst als Array von Zeichenfolgen ausführen muss.

Type: System.String[]
Default Value: None

Beschreibung

Geben Sie die Beschreibung des Diensts als Zeichenfolge an. Die Dienstbeschreibung wird in computerverwaltung, Dienste angezeigt.

Type: System.String
Default Value: None

DesktopInteract

Geben Sie an, ob der Dienst ein Fenster auf dem Desktop erstellen oder kommunizieren kann. Diese Eigenschaft muss $false sein, wenn BuiltInAccount nicht als LocalSystemangegeben ist.

Standardwert: $false.

Type: System.Boolean
Default Value: false

DisplayName

Geben Sie den Anzeigenamen des menschlichen Anzeigenamens des Diensts als Zeichenfolge an.

Type: System.String
Default Value: None

Ensure

Geben Sie an, ob der Dienst vorhanden sein soll. 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

Pfad

Geben Sie den Pfad zur ausführbaren Datei des Diensts als Zeichenfolge an. Diese Eigenschaft ist erforderlich, wenn der Dienst nicht vorhanden ist.

Type: System.String
Default Value: None

StartupTimeout

Geben Sie die Zeit an, bis der Dienst in Millisekunden gestartet werden soll.

Standardwert: 30000.

Type: System.UInt32
Default Value: 30000

StartupType

Geben Sie an, wie sich der Dienst beim Systemstart verhalten soll. Folgende Werte sind zulässig:

  • Automatic - Der Dienst wird vom Betriebssystemstart gestartet. Wenn ein automatisch gestarteter Dienst von einem manuell gestarteten Dienst abhängt, 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 der Dienst ausgeführt werden soll. Folgende Werte sind zulässig:

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

Standardwert: Running.

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

TerminateTimeout

Geben Sie die Zeit an, bis der Dienst in Millisekunden beendet werden soll. Der Standardwert ist 30000.

Type: System.UInt32
Default Value: 30000

Beispiele