Stop-Service

  • Referencia
Modul:
Microsoft.PowerShell.Management

Egy vagy több futó szolgáltatás leállítása.

Syntax

Stop-Service
    [-Force]
    [-NoWait]
    [-InputObject] <ServiceController[]>
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Stop-Service
    [-Force]
    [-NoWait]
    [-Name] <String[]>
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Stop-Service
    [-Force]
    [-NoWait]
    [-PassThru]
    -DisplayName <String[]>
    [-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 az egyes megadott szolgáltatásokhoz. Megadhatja a szolgáltatásokat a szolgáltatásnevek vagy megjelenítendő nevek alapján, vagy az 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 a Telnet szolgáltatást képviselő objektum lekérésére szolgál Get-Service . A folyamatkezelő (|) az objektumot a szolgáltatás leállításához Stop-Servicecsövezi.

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 IIS Rendszergazda szolgáltatást a helyi számítógépen. Mivel a szolgáltatás leállítása az IIS Rendszergazda szolgáltatástól függő szolgáltatásokat is leállítja, a legjobb, ha egy olyan parancsot használ, amely felsorolja Stop-Service az IIS Rendszergazda szolgáltatástól függő szolgáltatásokat.

Az első parancs felsorolja az IIS-től függő szolgáltatásokat Rendszergazda. Az IIS Rendszergazda szolgáltatást jelképező objektum lekérésére szolgálGet-Service. A folyamatkezelő (|) átadja az eredményt a Format-List parancsmagnak. A parancs a Tulajdonság paraméter használatával Format-List csak a szolgáltatás név- és függőszolgáltatás-tulajdonságait sorolja fel.

A második parancs leállítja az IIS Rendszergazda szolgáltatást. A Force paraméter szükséges egy függő szolgáltatással rendelkező szolgáltatás leállításához. 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

Jóváhagyást kér a parancsmag futtatása előtt.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Megadja a leállítandó szolgáltatások megjelenítendő nevét. A helyettesítő karakterek használata engedélyezett.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-Exclude

Megadja a parancsmag által kihagyott szolgáltatásokat. Ennek a paraméternek az értéke a Név paramétert minősíti. Adjon meg egy névelemet vagy mintát, például s*. A helyettesítő karakterek használata engedélyezett.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Include

Megadja a parancsmag által leállított szolgáltatásokat. Ennek a paraméternek az értéke a Név paramétert minősíti. Adjon meg egy névelemet vagy mintát, például s*. A helyettesítő karakterek használata engedélyezett.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-InputObject

A leállítani kívánt szolgáltatásokat képviselő ServiceController-objektumokat adja meg. Adjon meg egy változót, amely tartalmazza az objektumokat, vagy írjon be egy parancsot vagy kifejezést, amely lekéri az objektumokat.

Type:ServiceController[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Megadja a leállítandó szolgáltatások szolgáltatásneveit. A helyettesítő karakterek használata engedélyezett.

Type:String[]
Aliases:ServiceName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-NoWait

Azt jelzi, hogy ez a parancsmag a várakozás nélküli beállítást használja.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

A szolgáltatást jelképező objektumot ad vissza. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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 a szolgáltatást képviselő ServiceController-objektumot adja vissza.

Jegyzetek

A PowerShell a következő aliasokat Stop-Servicetartalmazza:

  • Windows:
    • spsv

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

Stop-Service 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 következőt Get-Service: . A szolgáltatásnevek a Név oszlopban, a megjelenített nevek pedig a DisplayName oszlopban jelennek meg.