Freigeben über

Suspend-Service

Modul:
Microsoft.PowerShell.Management Module

Hält ausgeführte Dienste an.

Syntax

InputObject (Standardwert) 

Suspend-Service
    [-InputObject] <ServiceController[]>
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Default 

Suspend-Service
    [-Name] <String[]>
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DisplayName 

Suspend-Service
    -DisplayName <String[]>
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

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

Das Cmdlet Suspend-Service sendet eine Anhaltenachricht für jeden der angegebenen Dienste an den Windows Service Controller. Der Dienst wird zwar angehalten, aber seine Aktion wird bis zum Fortsetzen angehalten, z. B. mithilfe des Cmdlets Resume-Service. Sie können die Dienste anhand ihrer Dienstnamen oder Anzeigenamen angeben, oder Sie können den Parameter InputObject verwenden, um ein Dienstobjekt zu übergeben, das die Dienste darstellt, die Sie anhalten möchten.

Beispiele

Beispiel 1: Anhalten eines Diensts

Suspend-Service -DisplayName "Telnet"

Dieser Befehl hält den Telnet-Dienst (Tlntsvr) auf dem lokalen Computer an.

Beispiel 2: Anzeigen, was passiert, wenn Sie Dienste anhalten

Suspend-Service -Name lanman* -WhatIf

Dieser Befehl teilt mit, was passiert, wenn Sie die Dienste mit einem Dienstnamen angehalten haben, der mit Lanman beginnt. Um die Dienste anzusetzen, führen Sie den Befehl ohne den WhatIf-Parameter erneut aus.

Beispiel 3: Abrufen und Anhalten eines Diensts

Get-Service schedule | Suspend-Service

Dieser Befehl verwendet das Cmdlet Get-Service, um ein Objekt abzurufen, das den Aufgabenplanerdienst (Scheduler) auf dem Computer darstellt. Der Pipelineoperator (|) übergibt das Ergebnis an Suspend-Service, wodurch der Dienst angehalten wird.

Beispiel 4: Anhalten aller Dienste, die angehalten werden können

Get-Service |
    Where-Object {$_.CanPauseAndContinue -eq "True"} |
    Suspend-Service -Confirm

Dieser Befehl hält alle Dienste auf dem Computer an, die angehalten werden können. Es verwendet Get-Service, um Objekte abzurufen, die die Dienste auf dem Computer darstellen. Der Pipelineoperator übergibt die Ergebnisse an das Cmdlet Where-Object, das nur die Dienste auswählt, die einen Wert von $true für die CanPauseAndContinue-Eigenschaft aufweisen. Ein anderer Pipelineoperator übergibt die Ergebnisse an Suspend-Service. Die Bestätigen Parameter fordert Sie zur Bestätigung auf, bevor Sie die einzelnen Dienste anhalten.

Parameter

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DisplayName

Gibt die Anzeigenamen der Dienste an, die angehalten werden sollen. Platzhalterzeichen sind zulässig.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:True
Nicht anzeigen:False

Parametersätze

DisplayName
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Exclude

Gibt Dienste an, die von den angegebenen Diensten weggelassen werden sollen. Der Wert dieses Parameters qualifiziert den parameter Name. Geben Sie ein Namenselement oder ein Muster ein, z. B. "s*". Platzhalterzeichen sind zulässig.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:True
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Include

Gibt dienste an, die angehalten werden sollen. Der Wert dieses Parameters qualifiziert den parameter Name. Geben Sie ein Namenselement oder ein Muster ein, z. B. "s*". Platzhalterzeichen sind zulässig.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:True
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-InputObject

Gibt ServiceController- Objekte an, die die angehaltenen Dienste darstellen. Geben Sie eine Variable ein, die die Objekte enthält, oder geben Sie einen Befehl oder Ausdruck ein, der die Objekte ermittelt.

Parametereigenschaften

Typ:

ServiceController[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

InputObject
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Gibt die Dienstnamen der dienste an, die angehalten werden sollen. Platzhalterzeichen sind zulässig.

Der Parametername ist optional. Sie können Name oder dessen Alias, ServiceName-verwenden oder den Parameternamen weglassen.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:True
Nicht anzeigen:False
Aliase:Dienstname

Parametersätze

Default
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-PassThru

Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet keine Ausgabe.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

ServiceController

Sie können ein Dienstobjekt an dieses Cmdlet weiterleiten.

String

Sie können eine Zeichenfolge, die einen 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

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

  • Suspend-Service kann Dienste nur steuern, wenn der aktuelle Benutzer die Berechtigung dazu hat. Wenn ein Befehl nicht ordnungsgemäß funktioniert, verfügen Sie möglicherweise nicht über die erforderlichen Berechtigungen.
  • Suspend-Service können nur Dienste anhalten, die das Anhalten und Fortsetzen unterstützen. Um festzustellen, ob ein bestimmter Dienst angehalten werden kann, verwenden Sie das cmdlet Get-Service zusammen mit der CanPauseAndContinue-Eigenschaft. Beispiel: Get-Service wmi | Format-List Name, CanPauseAndContinue. Um alle Dienste auf dem Computer zu finden, der angehalten werden kann, geben Sie Get-Service | Where-Object {$_.CanPauseAndContinue -eq $true}ein.
  • Geben Sie Get-Serviceein, um die Dienstnamen und Anzeigenamen der Dienste in Ihrem System zu finden. Die Dienstnamen werden in der Spalte Name angezeigt, und die Anzeigenamen werden in der Spalte DisplayName angezeigt.