Freigeben über

Start-Service

  • Referenz
Modul:
Microsoft.PowerShell.Management

Startet beendete Dienste.

Syntax

Start-Service
     [-InputObject] <ServiceController[]>
     [-PassThru]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-Service
     [-Name] <String[]>
     [-PassThru]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-Service
     [-PassThru]
     -DisplayName <String[]>
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Beschreibung

Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.

Das Start-Service Cmdlet sendet eine Startnachricht an den Windows Service Controller für jeden der angegebenen Dienste. Wenn ein Dienst bereits ausgeführt wird, wird die Meldung ignoriert, ohne dass ein Fehler ausgegeben wird. Sie können die Dienste anhand ihrer Dienstnamen oder Anzeigenamen angeben, oder Sie können den InputObject-Parameter verwenden, um ein Dienstobjekt bereitzustellen, das die Dienste darstellt, die Sie starten möchten.

Beispiele

Beispiel 1: Starten eines Diensts mithilfe des Namens

In diesem Beispiel wird der EventLog-Dienst auf dem lokalen Computer gestartet. Der Name-Parameter identifiziert den Dienst anhand seines Dienstnamens.

Start-Service -Name "eventlog"

Beispiel 2: Anzeigen von Informationen ohne Starten eines Diensts

In diesem Beispiel wird gezeigt, was geschieht, wenn Sie die Dienste gestartet haben, die einen Anzeigenamen haben, der "remote" enthält.

Start-Service -DisplayName *remote* -WhatIf

Der DisplayName-Parameter identifiziert die Dienste anhand ihres Anzeigenamens anstelle des Dienstnamens. Der WhatIf-Parameter bewirkt, dass das Cmdlet anzeigt, was passiert, wenn Sie den Befehl ausführen, aber keine Änderungen vornehmen.

Beispiel 3: Starten eines Diensts und Aufzeichnen der Aktion in einer Textdatei

In diesem Beispiel wird der Windows-Verwaltungsinstrumentationsdienst (Windows Management Instrumentation, WMI) auf dem Computer gestartet und der services.txt Datei ein Datensatz der Aktion hinzugefügt.

$s = Get-Service wmi
Start-Service -InputObject $s -PassThru | Format-List >> services.txt

Zunächst wird Get-Service ein Objekt abgerufen, das den WMI-Dienst darstellt, und es in der $s Variablen speichern. Als Nächstes starten wir den Dienst. Ohne den Parameter "PassThruStart-Service" wird keine Ausgabe erstellt. Der Pipelineoperator (|) übergibt die Objektausgabe an Start-Service das Format-List Cmdlet, um das Objekt als Liste seiner Eigenschaften zu formatieren. Der Anfügeumleitungsoperator (>>) leitet die Ausgabe an die services.txt Datei um. Die Ausgabe wird am Ende der vorhandenen Datei hinzugefügt.

Beispiel 4: Starten eines deaktivierten Diensts

In diesem Beispiel wird gezeigt, wie ein Dienst gestartet wird, wenn der Starttyp des Diensts deaktiviert ist.

PS> Start-Service tlntsvr
Start-Service : Service 'Telnet (TlntSvr)' cannot be started due to the following error: Cannot start service TlntSvr on computer '.'.
At line:1 char:14
+ Start-Service  <<<< tlntsvr

PS> Get-CimInstance win32_service | Where-Object Name -eq "tlntsvr"
ExitCode  : 0
Name      : TlntSvr
ProcessId : 0
StartMode : Disabled
State     : Stopped
Status    : OK

PS> Set-Service tlntsvr -StartupType manual
PS> Start-Service tlntsvr

Der erste Versuch, den Telnet-Dienst (tlntsvr) zu starten, schlägt fehl. Der Get-CimInstance Befehl zeigt an, dass die StartMode-Eigenschaft des Tlntsvr-Diensts deaktiviert ist. Das Set-Service Cmdlet ändert den Starttyp in "Manuell". Jetzt können wir den Start-Service Befehl erneut übermitteln. Dieses Mal wird der Befehl ohne Fehler verarbeitet. Um zu überprüfen, ob der Befehl erfolgreich war, führen Sie den Befehl aus Get-Service.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisplayName

Gibt die Anzeigenamen der zu startenden Dienste an. Platzhalterzeichen sind zulässig.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-Exclude

Gibt Dienste an, die von diesem Cmdlet weggelassen werden. Der Wert dieses Parameters qualifiziert den Name-Parameter . Geben Sie ein Namenselement oder ein Muster ein, z s*. B. . Platzhalterzeichen sind zulässig.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-Include

Gibt Dienste an, die dieses Cmdlet startet. Der Wert dieses Parameters qualifiziert den Name-Parameter . Geben Sie ein Namenselement oder ein Muster ein, z s*. B. . Platzhalterzeichen sind zulässig.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-InputObject

Gibt ServiceController-Objekte an, die die zu startenden Dienste darstellen. Geben Sie eine Variable ein, die die Objekte enthält, oder geben Sie einen Befehl oder einen Ausdruck ein, mit dem die Objekte abgerufen werden.

Typ:ServiceController[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt die Dienstnamen für die zu startenden Dienste an.

Der Parametername ist optional. Sie können name oder deren Alias, ServiceName oder den Parameternamen weglassen.

Typ:String[]
Aliase:ServiceName
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt ein Objekt zurück, das den Dienst darstellt. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

ServiceController

Sie können ein Dienstobjekt an dieses Cmdlet weiterleiten.

String

Sie können eine Zeichenfolge, die den Dienstnamen enthält, an dieses Cmdlet weiterleiten.

Ausgaben

None

Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.

ServiceController

Wenn Sie den PassThru-Parameter verwenden, gibt dieses Cmdlet ein ServiceController-Objekt zurück, das den Dienst darstellt.

Hinweise

PowerShell enthält die folgenden Aliase für Start-Service:

  • Windows:
    • sasv

Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.

  • Start-Service kann Dienste nur steuern, wenn der aktuelle Benutzer über die Berechtigung verfügt, dies zu tun. Wenn ein Befehl nicht ordnungsgemäß verarbeitet wird, verfügen Sie u. U. nicht über die erforderlichen Berechtigungen.
  • Um die Dienstnamen und Anzeigenamen der Dienste in Ihrem System zu finden, geben Sie folgendes ein Get-Service. Die Dienstnamen werden in der Spalte "Name " angezeigt, und die Anzeigenamen werden in der Spalte "DisplayName " angezeigt.
  • Sie können nur die Dienste starten, die über einen Starttyp von "Manuell", "Automatisch" oder "Automatisch" verfügen (verzögerter Start). Sie können die Dienste, die über einen Starttyp "Deaktiviert" verfügen, nicht starten. Wenn ein Start-Service Befehl mit der Meldung Cannot start service \<service-name\> on computerfehlschlägt, verwenden Sie die Verwendung Get-CimInstance , um den Starttyp des Diensts zu finden, und verwenden Sie ggf. das Set-Service Cmdlet, um den Starttyp des Diensts zu ändern.
  • Einige Dienste, beispielsweise der Dienst für Leistungsprotokolle und -warnungen (SysmonLog), werden automatisch beendet, wenn sie keine Vorgänge ausführen müssen. Wenn PowerShell einen Dienst startet, der sich fast sofort anhält, wird die folgende Meldung angezeigt: Service \<display-name\> start failed.