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

Rutina Stop-Service odešle zprávu zastavení 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 použít parametr 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 do Stop-Service , který 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, který uvádí služby závislé na službě IISAdmin.

První příkaz zobrazí seznam služeb, které jsou závislé na správci služby IIS. K získání objektu, který představuje službu IISAdmin, používá get-Service. Operátor kanálu (|) předá výsledek rutině Format-List. Příkaz používá parametr vlastnosti Format-List pouze Name a DependentServices vlastnosti služby.

Druhý příkaz zastaví službu IISAdmin. Parametr Force je nutný k zastavení služby, která má závislé služby. Příkaz používá parametr Confirm k vyžádání potvrzení od uživatele předtím, než zastaví každou službu.

Parametry

-Confirm

Před spuštěním rutiny vás vyzve 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

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

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

System.ServiceProcess.ServiceController, System.String

Objekt služby nebo řetězec, který obsahuje název služby, můžete do této rutiny přeskakovat.

Výstupy

None, System.ServiceProcess.ServiceController

Tato rutina vygeneruje System.ServiceProcess.ServiceController objekt, který představuje službu, pokud použijete parametr PassThru. Jinak tato rutina negeneruje žádný výstup.

Poznámky

  • Můžete také odkazovat na stop-service jeho předdefinovaný alias, spsv. Další informace najdete v tématu about_Aliases.

    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.