Suspend-Service
Onderbreekt (pauzeert) een of meer actieve services.
Syntax
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 opgeschort, wordt deze nog steeds uitgevoerd, maar wordt de actie gestopt totdat deze wordt hervat, bijvoorbeeld door de Resume-Service cmdlet te gebruiken. 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
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 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
PS C:\> 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
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. 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: | |
| 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
System.ServiceProcess.ServiceController, System.String
U kunt een serviceobject of een tekenreeks met een servicenaam doorsluisen 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-Servicekan services alleen beheren wanneer de huidige gebruiker hiervoor gemachtigd is. Als een opdracht niet goed werkt, hebt u mogelijk niet de vereiste machtigingen. -
Suspend-Servicekan alleen services onderbreken die ondersteuning bieden voor onderbroken en hervat. Als u wilt bepalen of een bepaalde service kan worden onderbroken, gebruikt u de cmdletGet-Servicesamen 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 uGet-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.