Stop-Service
Egy vagy több futó szolgáltatás leállítása.
Syntax
InputObject (Alapértelmezett)
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
A Szolgáltatás leállítása parancsmag egy stop üzenetet küld a Windows szolgáltatásvezérlőnek minden egyes megadott szolgáltatáshoz. Megadhatja a szolgáltatásokat a szolgáltatásnevek vagy megjelenítendő nevek alapján, vagy a InputObject paraméterrel átadhat egy szolgáltatásobjektumot, amely a leállítandó szolgáltatást jelöli.
Példák
1. példa: Szolgáltatás leállítása a helyi számítógépen
PS C:\> Stop-Service -Name "sysmonlog"
Ez a parancs leállítja a Teljesítménynaplók és riasztások (SysmonLog) szolgáltatást a helyi számítógépen.
2. példa: Szolgáltatás leállítása a megjelenített név használatával
PS C:\> Get-Service -DisplayName "telnet" | Stop-Service
Ez a parancs leállítja a Telnet szolgáltatást a helyi számítógépen.
A parancs Get-Service használatával lekér egy, a Telnet szolgáltatást képviselő objektumot.
A folyamatkezelő (|) az objektumot a Szolgáltatás leállítása
3. példa: Függő szolgáltatásokkal rendelkező szolgáltatás leállítása
PS C:\> Get-Service -Name "iisadmin" | Format-List -Property Name, DependentServices
PS C:\> Stop-Service -Name "iisadmin" -Force -Confirm
Ez a példa leállítja az IISAdmin szolgáltatást a helyi számítógépen. Mivel a szolgáltatás leállítása az IISAdmin szolgáltatástól függő szolgáltatásokat is leállítja, a legjobb, ha megelőzi Szolgáltatás leállítása egy olyan paranccsal, amely felsorolja az IISAdmin szolgáltatástól függő szolgáltatásokat.
Az első parancs felsorolja az IISAdmintól függő szolgáltatásokat. Get-Service használ az IISAdmin szolgáltatást képviselő objektum lekéréséhez. A folyamatkezelő (|) átadja az eredményt a Format-List parancsmagnak. A parancs a Format-ListTulajdonság paraméterével csak a szolgáltatás Név és Függő szolgáltatások tulajdonságait listázza.
A második parancs leállítja az IISAdmin szolgáltatást. A függő szolgáltatásokkal rendelkező szolgáltatások leállításához a Force paraméter szükséges. A parancs a Megerősítés paraméterrel kér megerősítést a felhasználótól, mielőtt leállítja az egyes szolgáltatásokat.
Paraméterek
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cf |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-DisplayName
Megadja a leállítandó szolgáltatások megjelenítendő nevét. A helyettesítő karakterek használata engedélyezett.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
DisplayName
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Exclude
Megadja a parancsmag által kihagyott szolgáltatásokat. A paraméter értéke megfelel a Név paraméternek. Adjon meg egy névelemet vagy mintát, például s*. A helyettesítő karakterek használata engedélyezett.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Force
Kényszeríti a parancsmagot, hogy állítsa le a szolgáltatást akkor is, ha az adott szolgáltatás függő szolgáltatásokkal rendelkezik.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Include
Megadja a parancsmag által leállított szolgáltatásokat. A paraméter értéke megfelel a Név paraméternek. Adjon meg egy névelemet vagy mintát, például s*. A helyettesítő karakterek használata engedélyezett.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-InputObject
Megadja ServiceController objektumokat, amelyek a leállítani kívánt szolgáltatásokat jelölik. Adjon meg egy változót, amely tartalmazza az objektumokat, vagy írjon be egy parancsot vagy kifejezést, amely lekéri az objektumokat.
Paramétertulajdonságok
| Típus: | ServiceController[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
InputObject
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Name
Megadja a leállítandó szolgáltatások szolgáltatásneveit. A helyettesítő karakterek használata engedélyezett.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
| Aliasok: | Szolgáltatás neve |
Paraméterkészletek
Default
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-NoWait
Azt jelzi, hogy ez a parancsmag a várakozás nélküli beállítást használja.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-PassThru
A szolgáltatást jelképező objektumot ad vissza. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Wi |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
System.ServiceProcess.ServiceController, System.String
A parancsmaghoz csövezhet egy szolgáltatásobjektumot vagy egy olyan sztringet, amely egy szolgáltatás nevét tartalmazza.
Kimenetek
None, System.ServiceProcess.ServiceController
Ez a parancsmag létrehoz egy System.ServiceProcess.ServiceController objektumot, amely a szolgáltatást jelöli, ha a PassThru paramétert használja. Ellenkező esetben ez a parancsmag nem hoz létre kimenetet.
Jegyzetek
A Stop-Service is hivatkozhat a beépített aliasára, spsv. További információ: about_Aliases.
Szolgáltatás leállítása csak akkor tudja vezérelni a szolgáltatásokat, ha az aktuális felhasználó rendelkezik erre vonatkozó engedéllyel. Ha egy parancs nem működik megfelelően, előfordulhat, hogy nem rendelkezik a szükséges engedélyekkel.
A szolgáltatások nevének és a szolgáltatások megjelenítendő nevének megkereséséhez írja be a
Get-Service. A szolgáltatásnevek a Név oszlopban jelennek meg, a megjelenített nevek pedig a DisplayName oszlopban jelennek meg.