Delen via


Suspend-Service

Onderbreekt (pauzeert) een of meer actieve services.

Syntaxis

InputObject (Standaard)

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

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, zoals met behulp van de cmdlet Resume-Service. U kunt de services opgeven op basis van 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

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

Suspend-Service -Name lanman* -WhatIf

Met deze opdracht wordt aangegeven wat er zou gebeuren als u de services hebt onderbroken 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

Get-Service schedule | Suspend-Service

Met deze opdracht wordt de Get-Service-cmdlet gebruikt om een object op te halen dat de Taakplannerservice (Planning) 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

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

Met deze opdracht worden alle services op de computer onderbroken die kunnen worden onderbroken. Er wordt Get-Service gebruikt 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 met een waarde van $true voor de eigenschap CanPauseAndContinue. Een andere pijplijnoperator geeft de resultaten door aan Suspend-Service. De Bevestig parameter vraagt u om bevestiging voordat u elk van de services onderbreekt.

Parameters

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DisplayName

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

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:True
DontShow:False

Parametersets

DisplayName
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Exclude

Hiermee geeft u services om weg te laten van 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.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:True
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Include

Hiermee geeft u 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.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:True
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-InputObject

Hiermee geeft u ServiceController objecten 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.

Parametereigenschappen

Type:

ServiceController[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

InputObject
Position:0
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Name

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

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

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:True
DontShow:False
Aliassen:Dienstnaam

Parametersets

Default
Position:0
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-PassThru

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

ServiceController

U kunt een serviceobject doorsluisen naar deze cmdlet.

String

U kunt een tekenreeks met een servicenaam doorsturen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert standaard geen uitvoer.

ServiceController

Wanneer u de parameter PassThru gebruikt, retourneert deze cmdlet een ServiceController-object dat de service vertegenwoordigt.

Notities

Deze cmdlet is alleen beschikbaar op Windows-platforms.

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