Stop-Service

Modul:

Microsoft.PowerShell.Management Module

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

Ez a parancsmag csak a Windows platformon érhető el.

A Stop-Service parancsmag 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ál a Telnet szolgáltatást képviselő objektum lekéréséhez. A folyamatkezelő (|) az objektumot Stop-Service, amely leállítja a szolgáltatást.

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, érdemes megelőzni Stop-Service 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-List paraméterével csak a szolgáltatás Név és Függő szolgáltatások tulajdonságait sorolja fel.

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

ServiceController

A szolgáltatásobjektumot erre a parancsmagra csövezheti.

String

Erre a parancsmagra egy szolgáltatás nevét tartalmazó sztringet csövezhet.

Kimenetek

None

Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.

ServiceController

A PassThru paraméter használatakor ez a parancsmag egy ServiceController objektumot ad vissza, amely a szolgáltatást jelöli.

Jegyzetek

A PowerShell a következő aliasokat tartalmazza Stop-Service:

• Windows:
  • spsv

Ez a parancsmag csak Windows-platformokon érhető el.

Stop-Service csak akkor szabályozhatja 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.

Kapcsolódó hivatkozások

• Get-Service
• Új szolgáltatás
• Szolgáltatás újraindítása
• Önéletrajz-szolgáltatás
• Set-Service
• Start-Service
• Szolgáltatás felfüggesztése
• Szolgáltatás eltávolítása