Sdílet prostřednictvím

Stop-Service

  • Reference
Modul:
Microsoft.PowerShell.Management

Zastaví jednu nebo více spuštěných služeb.

Syntaxe

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

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 pomocí parametru 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-Servicekterý 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 se seznamem služeb závislých 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 se k získání objektu, který představuje službu IISAdmin. Operátor kanálu (|) předá výsledek rutině Format-List . Příkaz pomocí parametru Format-List Property vypíše pouze vlastnosti Name a DependentServices služby.

Druhý příkaz zastaví službu IISAdmin. Parametr Force se vyžaduje k zastavení služby, která má závislé služby. Příkaz pomocí parametru Confirm požádá uživatele o potvrzení předtím, než zastaví každou službu.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DisplayName

Určuje zobrazované názvy služeb, které se mají zastavit. Jsou povoleny zástupné znaky.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:True

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

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:True

-Force

Vynutí rutinu zastavit službu, i když má tato služba závislé služby.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:True

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

Typ:ServiceController[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Určuje názvy služeb, které se mají zastavit. Jsou povoleny zástupné znaky.

Typ:String[]
Aliasy:ServiceName
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-NoWait

Označuje, že tato rutina používá možnost bez čekání.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PassThru

Vrátí objekt, který představuje službu. Ve výchozím nastavení tato rutina negeneruje žádný výstup.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

ServiceController

Objekt služby můžete do této rutiny převést.

String

Do této rutiny můžete zamísit řetězec, který obsahuje název služby.

Výstupy

None

Ve výchozím nastavení tato rutina nevrací žádný výstup.

ServiceController

Pokud použijete parametr PassThru , vrátí tato rutina objekt ServiceController představující službu.

Poznámky

PowerShell obsahuje následující aliasy pro Stop-Service:

  • Windows:
    • spsv

Tato rutina je dostupná jenom na platformách Windows.

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 .