Freigeben über

Resume-Service

  • Referenz
Modul:
Microsoft.PowerShell.Management

Setzt angehaltene (unterbrochene) Dienste fort.

Syntax

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

Beschreibung

Das Resume-Service Cmdlet sendet eine Fortsetzungsmeldung für jeden der angegebenen Dienste an den Windows Service Controller. Wenn ein Dienst angehalten wird, wird er fortgesetzt. Wenn sie derzeit ausgeführt wird, wird die Nachricht ignoriert. 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 fortsetzen möchten.

Beispiele

Beispiel 1: Fortsetzen eines Diensts auf dem lokalen Computer

PS C:\> Resume-Service "sens"

Mit diesem Befehl wird der Systemereignisbenachrichtigungsdienst auf dem lokalen Computer fortgesetzt. Der Dienstname wird im Befehl durch sens dargestellt. Der Befehl verwendet den Parameter Name , um den Dienstnamen des Diensts anzugeben, aber der Befehl lässt den Parameternamen aus, da der Parametername optional ist.

Beispiel 2: Fortsetzen aller angehaltenen Dienste

PS C:\> Get-Service | Where-Object {$_.Status -eq "Paused"} | Resume-Service

Mit diesem Befehl werden alle angehaltenen Dienste auf dem Computer fortgesetzt. Der Get-Service Cmdlet-Befehl ruft alle Dienste auf dem Computer ab. Der Pipelineoperator (|) übergibt die Ergebnisse an das Where-Object Cmdlet, das die Dienste auswählt, die über eine Status-Eigenschaft von Paused verfügen. Der nächste Pipelineoperator sendet die Ergebnisse an Resume-Service, wodurch die angehaltenen Dienste fortgesetzt werden.

In der Praxis würden Sie den WhatIf-Parameter verwenden, um die Wirkung des Befehls zu bestimmen, bevor Sie ihn ausführen.

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 fortzusetzenden 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. B. s*. Platzhalterzeichen sind zulässig.

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

-Include

Gibt dienste an, die fortgesetzt werden sollen. Der Wert dieses Parameters qualifiziert den Name-Parameter . Geben Sie ein Namenselement oder ein Muster ein, z. B. s*. 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 dienste darstellen, die fortgesetzt werden sollen. 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 der fortzusetzenden Dienste an.

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 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 fortgesetzten Dienst darstellt.

Hinweise

  • Der Status der Dienste, die angehalten wurden, ist angehalten. Wenn Dienste fortgesetzt werden, wird ihr Status ausgeführt.
  • Resume-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.