Freigeben über

Suspend-Service

  • Referenz
Modul:
Microsoft.PowerShell.Management

Hält ausgeführte Dienste an.

Syntax

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

Beschreibung

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

Das Suspend-Service Cmdlet sendet eine Anhaltemeldung an den Windows-Dienstcontroller für jeden der angegebenen Dienste. Während er angehalten ist, wird der Dienst weiterhin ausgeführt, aber seine Aktion wird beendet, bis er fortgesetzt wird, z. B. mithilfe des Resume-Service Cmdlets. Sie können die Dienste anhand ihrer Dienstnamen oder Anzeigenamen angeben, oder Sie können den InputObject-Parameter verwenden, um ein Dienstobjekt zu übergeben, das die Dienste darstellt, die Sie anhalten möchten.

Beispiele

Beispiel 1: Anhalten eines Diensts

PS C:\> Suspend-Service -DisplayName "Telnet"

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

Beispiel 2: Anzeigen, was passieren würde, wenn Sie Dienste anhalten

PS C:\> Suspend-Service -Name lanman* -WhatIf

Mit diesem Befehl erfahren Sie, was passieren würde, wenn Sie die Dienste mit einem Dienstnamen anhalten, der mit lanman beginnt. Führen Sie den Befehl ohne den WhatIf-Parameter erneut aus, um die Dienste anzusetzen.

Beispiel 3: Abrufen und Anhalten eines Diensts

PS C:\> Get-Service schedule | Suspend-Service

Dieser Befehl verwendet das Get-Service Cmdlet, um ein Objekt abzurufen, das den Taskplanerdienst (Schedule) 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

PS C:\> Get-Service | Where-Object {$_.CanPauseAndContinue -eq "True"} | Suspend-Service -Confirm

Mit diesem Befehl werden alle Dienste auf dem Computer angehalten, die angehalten werden können. Wird verwendet Get-Service , um Objekte abzurufen, die die Dienste auf dem Computer darstellen. Der Pipelineoperator übergibt die Ergebnisse an das Where-Object Cmdlet, das nur die Dienste auswählt, die den Wert für $True die Eigenschaft CanPauseAndContinue aufweisen. Ein anderer Pipelineoperator übergibt die Ergebnisse an Suspend-Service. Der Confirm-Parameter fordert Sie zur Bestätigung auf, bevor Sie die einzelnen Dienste anhalten.

Parameter

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

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

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-Exclude

Gibt Dienste an, die von den angegebenen Diensten weggelassen werden sollen. Der Wert dieses Parameters qualifiziert den Name-Parameter . Geben Sie ein Namenselement oder -muster wie %%amp;quot;s*%%amp;quot; ein. Platzhalterzeichen sind zulässig.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Include

Gibt dienste an, die angehalten werden sollen. Der Wert dieses Parameters qualifiziert den Name-Parameter . Geben Sie ein Namenselement oder -muster wie %%amp;quot;s*%%amp;quot; ein. Platzhalterzeichen sind zulässig.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-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 einen Ausdruck ein, mit dem die Objekte abgerufen werden.

Type:ServiceController[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 den zugehörigen Alias ServiceName verwenden, oder Sie können den Parameternamen weglassen.

Type:String[]
Aliases:ServiceName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

ServiceController

Sie können ein Dienstobjekt an dieses Cmdlet übergeben.

String

Sie können eine Zeichenfolge, die einen Dienstnamen enthält, an dieses Cmdlet übergeben.

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 dann steuern, wenn der aktuelle Benutzer dazu berechtigt ist. Wenn ein Befehl nicht ordnungsgemäß verarbeitet wird, verfügen Sie u. U. nicht über die erforderlichen Berechtigungen.
  • Suspend-Service kann nur Dienste anhalten, die das Anhalten und Fortsetzen unterstützen. Verwenden Sie das Cmdlet zusammen mit der Get-ServiceCanPauseAndContinue-Eigenschaft , um zu bestimmen, ob ein bestimmter Dienst angehalten werden kann. Beispiel: Get-Service wmi | Format-List Name, CanPauseAndContinue. Um alle Dienste auf dem Computer zu finden, die angehalten werden können, geben Sie ein Get-Service | Where-Object {$_.CanPauseAndContinue -eq $true}.
  • Um die Dienstnamen und Anzeigenamen der Dienste auf Ihrem System zu ermitteln, geben Sie ein Get-Service. Die Dienstnamen werden in der Spalte Name und die Anzeigenamen in der Spalte DisplayName angezeigt.