Stop-Service

  • Reference
Modul:
Microsoft.PowerShell.Management

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

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

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 IIS Správa 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ě IIS Správa, je nejlepší předcházet Stop-Service příkazem se seznamem služeb závislých na službě IIS Správa.

První příkaz zobrazí seznam služeb závislých na službě IIS Správa. Používá Get-Service se k získání objektu, který představuje službu IIS Správa. 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 IIS Správa. 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í.

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

-DisplayName

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

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

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

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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á.

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

-Name

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

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

-NoWait

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

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

-PassThru

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

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .