Suspend-Service
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 Angehaltene Nachricht an den Windows Service Controller für jeden der angegebenen Dienste. Während sie angehalten wird, wird der Dienst weiterhin ausgeführt, die Aktion wird jedoch bis zum Fortsetzen beendet, 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 passiert, wenn Sie Dienste anhalten
PS C:\> Suspend-Service -Name lanman* -WhatIf
Dieser Befehl teilt mit, was passieren würde, wenn Sie die Dienste angehalten haben, die einen Dienstnamen 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
PS C:\> Get-Service schedule | Suspend-Service
Dieser Befehl verwendet das Get-Service
Cmdlet, um ein Objekt abzurufen, das den Task Scheduler -Dienst (Schedule) auf dem Computer darstellt. Der Pipelineoperator (|
) übergibt das Ergebnis an Suspend-Service
, an das 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. Es 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 einen Wert $True
für die CanPauseAndContinue-Eigenschaft haben. Ein anderer Pipelineoperator übergibt die Ergebnisse an Suspend-Service
. Der Parameter "Bestätigen " 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 dienste darstellen, die angehalten 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.
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 den Namen oder seinen Alias, ServiceName verwenden oder 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
System.ServiceProcess.ServiceController, System.String
Sie können ein Dienstobjekt oder eine Zeichenfolge mit einem Dienstnamen an dieses Cmdlet weiterleiten.
Ausgaben
None, System.ServiceProcess.ServiceController
Dieses Cmdlet generiert ein System.ServiceProcess.ServiceController-Objekt , das den Dienst darstellt, wenn Sie den PassThru-Parameter angeben. Andernfalls wird von diesem Cmdlet keine Ausgabe generiert.
Hinweise
Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.
Suspend-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.Suspend-Service
kann nur Dienste angehalten und fortgesetzt werden. Um zu ermitteln, ob ein bestimmter Dienst angehalten werden kann, verwenden Sie dasGet-Service
Cmdlet zusammen mit der CanPauseAndContinue-Eigenschaft . Beispiel:Get-Service wmi | Format-List Name, CanPauseAndContinue
. Um alle Dienste auf dem Computer zu suchen, die angehalten werden können, geben Sie den TypGet-Service | Where-Object {$_.CanPauseAndContinue -eq $true}
.- Um die Dienstnamen und Anzeigenamen der Dienste in Ihrem System zu finden, geben Sie den
Get-Service
Namen ein. Die Dienstnamen werden in der Spalte "Name " angezeigt, und die Anzeigenamen werden in der Spalte "DisplayName " angezeigt.