Share via

Suspend-Service

  • Referentie
Module:
Microsoft.PowerShell.Management

Hiermee wordt een of meer actieve services onderbroken (onderbroken).

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>]

Description

Deze cmdlet is alleen beschikbaar op het Windows-platform.

De Suspend-Service cmdlet verzendt een onderbrekingsbericht naar de Windows-servicecontroller voor elk van de opgegeven services. Terwijl de service is onderbroken, wordt de service nog steeds uitgevoerd, maar wordt de actie gestopt totdat deze is hervat, bijvoorbeeld met behulp van de Resume-Service cmdlet. U kunt de services opgeven met hun servicenamen of weergavenamen, of u kunt de parameter InputObject gebruiken om een serviceobject door te geven dat de services vertegenwoordigt die u wilt onderbreken.

Voorbeelden

Voorbeeld 1: Een service onderbreken

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

Met deze opdracht wordt de Telnet-service (Tlntsvr) op de lokale computer onderbroken.

Voorbeeld 2: weergeven wat er zou gebeuren als u services onderbreekt

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

Met deze opdracht wordt aangegeven wat er zou gebeuren als u de services onderbreekt die een servicenaam hebben die begint met lanman. Als u de services wilt onderbreken, voert u de opdracht opnieuw uit zonder de parameter WhatIf .

Voorbeeld 3: Een service ophalen en onderbreken

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

Met deze opdracht wordt de Get-Service cmdlet gebruikt om een object op te halen dat de Service Task Scheduler (Scheduler) op de computer vertegenwoordigt. De pijplijnoperator (|) geeft het resultaat door aan Suspend-Service, waardoor de service wordt onderbroken.

Voorbeeld 4: Alle services onderbreken die kunnen worden onderbroken

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

Met deze opdracht worden alle services op de computer onderbroken die kunnen worden onderbroken. Het gebruikt Get-Service om objecten op te halen die de services op de computer vertegenwoordigen. De pijplijnoperator geeft de resultaten door aan de Where-Object cmdlet, die alleen de services selecteert die een waarde van $True hebben voor de eigenschap CanPauseAndContinue . Een andere pijplijnoperator geeft de resultaten door aan Suspend-Service. De parameter Confirm vraagt u om bevestiging voordat u elk van de services onderbreekt.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-DisplayName

Hiermee geeft u de weergavenamen op van de services die moeten worden onderbroken. Jokertekens zijn toegestaan.

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

-Exclude

Hiermee geeft u de services op die moeten worden weggelaten uit de opgegeven services. De waarde van deze parameter komt in aanmerking voor de parameter Name . Voer een naamelement of -patroon in, zoals 's*'. Jokertekens zijn toegestaan.

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

-Include

Hiermee geeft u de services op die moeten worden onderbroken. De waarde van deze parameter komt in aanmerking voor de parameter Name . Voer een naamelement of -patroon in, zoals 's*'. Jokertekens zijn toegestaan.

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

-InputObject

Hiermee geeft u ServiceController-objecten op die de services vertegenwoordigen die moeten worden onderbroken. Voer een variabele in die de objecten bevat of typ een opdracht of expressie waarmee de objecten worden opgehaald.

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

-Name

Hiermee geeft u de servicenamen op van de services die moeten worden onderbroken. Jokertekens zijn toegestaan.

De parameternaam is optioneel. U kunt Name of de bijbehorende alias , ServiceName gebruiken, of u kunt de parameternaam weglaten.

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

-PassThru

Retourneert een object dat het item vertegenwoordigt waarmee u werkt. Deze cmdlet genereert standaard geen uitvoer.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

System.ServiceProcess.ServiceController, System.String

U kunt een serviceobject of een tekenreeks met een servicenaam doorspezen naar deze cmdlet.

Uitvoerwaarden

None, System.ServiceProcess.ServiceController

Met deze cmdlet wordt een System.ServiceProcess.ServiceController-object gegenereerd dat de service vertegenwoordigt, als u de parameter PassThru opgeeft. Anders genereert deze cmdlet geen uitvoer.

Notities

Deze cmdlet is alleen beschikbaar op Windows-platforms.

  • Suspend-Service kan services alleen beheren wanneer de huidige gebruiker hiertoe gemachtigd is. Als een opdracht niet goed werkt, beschikt u mogelijk niet over de vereiste machtigingen.
  • Suspend-Service kan alleen services die ondersteuning bieden, onderbreken en hervatten. Als u wilt bepalen of een bepaalde service kan worden onderbroken, gebruikt u de Get-Service cmdlet samen met de eigenschap CanPauseAndContinue . Bijvoorbeeld Get-Service wmi | Format-List Name, CanPauseAndContinue. Als u wilt zoeken naar alle services op de computer die kunnen worden onderbroken, typt Get-Service | Where-Object {$_.CanPauseAndContinue -eq $true}u .
  • Als u de servicenamen en weergavenamen van de services op uw systeem wilt vinden, typt Get-Serviceu . De servicenamen worden weergegeven in de kolom Naam en de weergavenamen worden weergegeven in de kolom DisplayName .