Suspend-Service
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 wordt 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 whatif-parameter .
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 Task Scheduler-service 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 van de services die moeten worden opgeschort. Jokertekens zijn toegestaan.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Exclude
Hiermee geeft u 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 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 van de services te onderbreken. Jokertekens zijn toegestaan.
De parameternaam is optioneel. U kunt Name of de 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
U kunt een serviceobject doorsnijden naar deze cmdlet.
U kunt een tekenreeks met een servicenaam doorsnijden naar deze cmdlet.
Uitvoerwaarden
None
Deze cmdlet retourneert standaard geen uitvoer.
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 hiertoe gemachtigd is. Als een opdracht niet goed werkt, beschikt u mogelijk niet over de vereiste machtigingen.Suspend-Service
kan alleen services onderbreken die ondersteuning bieden voor onderbroken en hervat worden. Als u wilt bepalen of een bepaalde service kan worden onderbroken, gebruikt u deGet-Service
cmdlet samen met de eigenschap CanPauseAndContinue . BijvoorbeeldGet-Service wmi | Format-List Name, CanPauseAndContinue
. Als u wilt zoeken naar alle services op de computer 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 worden weergegeven in de kolom Naam en de weergavenamen worden weergegeven in de kolom DisplayName .