Hält einen oder mehrere ausgeführte Dienste an.

Syntax

Suspend-Service [-Name] <string[]> [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-Bestätigung] [-WhatIf] [<CommonParameters>]

Suspend-Service -DisplayName <string[]> [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-Bestätigung] [-WhatIf] [<CommonParameters>]

Suspend-Service [-InputObject <ServiceController[]>] [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-Bestätigung] [-WhatIf] [<CommonParameters>]

Beschreibung

Mit dem Cmdlet "Suspend-Service" wird für jeden der angegebenen Dienste eine Unterbrechungsmeldung an den Windows-Dienstcontroller gesendet. Wenn er angehalten wurde, wird der Dienst weiterhin ausgeführt, die Aktion wird jedoch unterbrochen, bis sie fortgesetzt wird, z. B. mit Resume-Service. Sie können die Dienste mit ihren Dienstnamen oder Anzeigenamen angeben, oder Sie können mit dem InputObject-Parameter ein Dienstobjekt übergeben, das die anzuhaltenden Dienste darstellt.

Parameter

-DisplayName <string[]>

Gibt die Anzeigenamen der anzuhaltenden Dienste an. Platzhalter sind zulässig.

Erforderlich?

true

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Exclude <string[]>

Lässt die angegebenen Dienste aus. Der Name-Parameter wird durch den Wert dieses Parameters qualifiziert. Geben Sie ein Namenselement oder -muster wie "s*" ein. Platzhalter sind zulässig.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Include <string[]>

Hält nur die angegebenen Dienste an. Der Name-Parameter wird durch den Wert dieses Parameters qualifiziert. Geben Sie ein Namenselement oder -muster wie "s*" ein. Platzhalter sind zulässig.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-InputObject <ServiceController[]>

Gibt ServiceController-Objekte an, die die anzuhaltenden 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.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

true (ByValue)

Platzhalterzeichen akzeptieren?

false

-Name <string[]>

Gibt die Dienstnamen der anzuhaltenden Dienste an. Platzhalter sind zulässig.

Der Parametername ist optional. Sie können "Name" oder den zugehörigen Alias "ServiceName" verwenden oder aber den Parameternamen auslassen.

Erforderlich?

true

Position?

1

Standardwert

Pipelineeingaben akzeptieren?

true (ByValue, ByPropertyName)

Platzhalterzeichen akzeptieren?

false

-PassThru

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

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Bestätigung

Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-WhatIf

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

<CommonParameters>

Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.

Eingaben und Ausgaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.

Eingaben

System.ServiceProcess.ServiceController oder System.String

Sie können ein Dienstobjekt oder eine Zeichenfolge, die einen Dienstnamen enthält, über die Pipeline an Suspend-Service übergeben.

Ausgaben

Keiner oder System.ServiceProcess.ServiceController

Wenn Sie den PassThru-Parameter verwenden, generiert Suspend-Service ein System.ServiceProcess.ServiceController-Objekt, das den Dienst darstellt. Andernfalls wird von diesem Cmdlet keine Ausgabe generiert.

Hinweise

Mit Suspend-Service können nur dann Dienste gesteuert werden, wenn der aktuelle Benutzer über die entsprechende Berechtigung verfügt. Wenn ein Befehl nicht ordnungsgemäß verarbeitet wird, verfügen Sie u. U. nicht über die erforderlichen Berechtigungen.

Mit Suspend-Service können zudem nur Dienste angehalten werden, für die das Anhalten und Fortsetzen unterstützt wird. Um zu bestimmen, ob ein bestimmter Dienst angehalten werden kann, verwenden Sie das Cmdlet "Get-Service" mit der CanPauseAndContinue-Eigenschaft. Beispiel: "Get-Service wmi | Format-List name, canpauseandcontinue". Wenn Sie alle Dienste auf dem Computer ermitteln möchten, die angehalten werden können, geben Sie "Get-Service | Where-Object {$_.canpauseandcontinue -eq "True"}" ein.

Geben Sie "Get-Service" ein, um die Dienstnamen und die Anzeigenamen der Dienste auf dem System zu suchen. Die Dienstnamen werden in der Spalte "Name" und die Anzeigenamen in der Spalte "DisplayName" aufgeführt.

Beispiel 1

C:\PS>suspend-service -displayname "Telnet"

Beschreibung
-----------
Mit diesem Befehl wird der Telnet-Dienst ("Tlntsvr") auf dem lokalen Computer angehalten.

Beispiel 2

C:\PS>suspend-service -name lanman* -whatif

Beschreibung
-----------
Dieser Befehl zeigt, was geschieht, wenn Sie die Dienste anhalten, deren Dienstname mit "lanman" beginnt. Führen Sie den Befehl ohne den WhatIf-Parameter erneut aus, um die Dienste anzuhalten.

Beispiel 3

C:\PS>get-service schedule | suspend-service

Beschreibung
-----------
In diesem Befehl wird mit dem Cmdlet "Get-Service" ein Objekt abgerufen, das den Taskplaner-Dienst ("Schedule") auf dem Computer darstellt. Mit dem Pipelineoperator (|) wird das Ergebnis an das Cmdlet "Suspend-Service" übergeben, das den Dienst anhält.

Beispiel 4

C:\PS>get-service | where-object {$_.canpauseandcontinue -eq "True"} | suspend-service -confirm

Beschreibung
-----------
Mit diesem Befehl werden alle Dienste auf dem Computer angehalten, die angehalten werden können. Mit dem Cmdlet "Get-Service" werden Objekte abgerufen, die die Dienste auf dem Computer darstellen. Mit dem Pipelineoperator (|) werden die Ergebnisse an das Cmdlet "Where-Object" übergeben, von dem nur die Dienste ausgewählt werden, deren CanPauseAndContinue-Eigenschaft den Wert "True" aufweist. Ein weiterer Pipelineoperator übergibt die Ergebnisse an das Cmdlet "Suspend-Service". Durch den Confirm-Parameter werden Sie vor dem Anhalten der einzelnen Dienste zum Bestätigen des Vorgangs aufgefordert.

Siehe auch



Inhaltsverzeichnis