Stop-Service
Zastaví jednu nebo více spuštěných služeb.
Syntax
InputObject (Výchozí)
Stop-Service
[-InputObject] <ServiceController[]>
[-Force]
[-NoWait]
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Stop-Service
[-Name] <String[]>
[-Force]
[-NoWait]
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DisplayName
Stop-Service
-DisplayName <String[]>
[-Force]
[-NoWait]
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Tato rutina je dostupná jenom na platformě Windows.
Rutina Stop-Service odešle zprávu zastavení do kontroleru služeb systému Windows pro každou ze zadaných služeb. Služby můžete zadat podle jejich názvů služeb nebo zobrazované názvy, nebo můžete použít parametr InputObject předat objekt služby, který představuje službu, kterou chcete zastavit.
Příklady
Příklad 1: Zastavení služby v místním počítači
PS C:\> Stop-Service -Name "sysmonlog"
Tento příkaz zastaví službu Protokoly výkonu a výstrahy (SysmonLog) v místním počítači.
Příklad 2: Zastavení služby pomocí zobrazovaného názvu
PS C:\> Get-Service -DisplayName "telnet" | Stop-Service
Tento příkaz zastaví službu Telnet na místním počítači. Příkaz používá Get-Service k získání objektu, který představuje službu Telnet. Operátor kanálu (|) předá objekt Stop-Service, který zastaví službu.
Příklad 3: Zastavení služby, která má závislé služby
PS C:\> Get-Service -Name "iisadmin" | Format-List -Property Name, DependentServices
PS C:\> Stop-Service -Name "iisadmin" -Force -Confirm
Tento příklad zastaví službu IISAdmin na místním počítači. Vzhledem k tomu, že zastavení této služby také zastaví služby, které závisí na službě IISAdmin, je nejlepší předcházet Stop-Service příkazem, který uvádí služby, které závisí na službě IISAdmin.
První příkaz zobrazí seznam služeb, které jsou závislé na správci služby IIS. Používá Get-Service k získání objektu, který představuje službu IISAdmin. Operátor kanálu (|) předá výsledek rutině Format-List. Příkaz používá parametr vlastnostiFormat-List k výpisu pouze vlastností Name a DependentServices vlastnosti služby.
Druhý příkaz zastaví službu IISAdmin. Parametr Force je nutný k zastavení služby, která má závislé služby. Příkaz používá parametr Confirm k vyžádání potvrzení od uživatele předtím, než zastaví každou službu.
Parametry
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-DisplayName
Určuje zobrazované názvy služeb, které se mají zastavit. Jsou povoleny zástupné znaky.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
DisplayName
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Exclude
Určuje služby, které tato rutina vynechá. Hodnota tohoto parametru kvalifikuje parametr Name. Zadejte element nebo vzor názvu, například s*. Jsou povoleny zástupné znaky.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Force
Vynutí rutinu zastavit službu, i když má tato služba závislé služby.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Include
Určuje služby, které tato rutina zastaví. Hodnota tohoto parametru kvalifikuje parametr Name. Zadejte element nebo vzor názvu, například s*. Jsou povoleny zástupné znaky.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-InputObject
Určuje ServiceController objekty, které představují služby, které se mají zastavit. Zadejte proměnnou, která obsahuje objekty, nebo zadejte příkaz nebo výraz, který objekty získá.
Vlastnosti parametru
| Typ: | |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
InputObject
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Name
Určuje názvy služeb, které se mají zastavit. Jsou povoleny zástupné znaky.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
| Aliasy: | Název služby |
Sady parametrů
Default
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-NoWait
Označuje, že tato rutina používá možnost bez čekání.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-PassThru
Vrátí objekt, který představuje službu. Ve výchozím nastavení tato rutina negeneruje žádný výstup.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
System.ServiceProcess.ServiceController, System.String
Objekt služby nebo řetězec, který obsahuje název služby, můžete do této rutiny přeskakovat.
Výstupy
None, System.ServiceProcess.ServiceController
Tato rutina vygeneruje System.ServiceProcess.ServiceController objekt, který představuje službu, pokud použijete parametr PassThru. Jinak tento příkaz negeneruje žádný výstup.
Poznámky
Tento cmdlet je dostupný pouze na platformách Windows.
Můžete také odkazovat na Stop-Service jeho vestavěný alias spsv. Další informace najdete v tématu about_Aliases.
Stop-Service může řídit služby pouze v případě, že má aktuální uživatel oprávnění k tomu. Pokud příkaz nefunguje správně, možná nemáte požadovaná oprávnění.
Chcete-li najít názvy služeb a zobrazované názvy služeb v systému, zadejte Get-Service. Názvy služeb se zobrazí ve sloupci Název a zobrazované názvy se zobrazí ve sloupci DisplayName.