Sdílet prostřednictvím

Suspend-Service

  • Reference
Modul:
Microsoft.PowerShell.Management

Pozastaví (pozastaví) jednu nebo více spuštěných služeb.

Syntaxe

Suspend-Service
       [-InputObject] <ServiceController[]>
       [-PassThru]
       [-Include <String[]>]
       [-Exclude <String[]>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Suspend-Service
       [-Name] <String[]>
       [-PassThru]
       [-Include <String[]>]
       [-Exclude <String[]>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Suspend-Service
       [-PassThru]
       -DisplayName <String[]>
       [-Include <String[]>]
       [-Exclude <String[]>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Rutina Suspend-Service odešle zprávu o pozastavení do kontroleru služeb systému Windows pro každou ze zadaných služeb. Během pozastavení je služba stále spuštěná, ale její akce se zastaví, dokud se neobnoví, například pomocí rutiny Resume-Service. 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žby, které chcete pozastavit.

Příklady

Příklad 1: Pozastavení služby

PS C:\> Suspend-Service -DisplayName "Telnet"

Tento příkaz pozastaví službu Telnet (Tlntsvr) v místním počítači.

Příklad 2: Zobrazení toho, co by se stalo, když pozastavíte služby

PS C:\> Suspend-Service -Name lanman* -WhatIf

Tento příkaz řekne, co se stane, když pozastavíte služby, které mají název služby, která začíná lanmanem. Pokud chcete služby pozastavit, spusťte příkaz znovu bez parametru WhatIf.

Příklad 3: Získání a pozastavení služby

PS C:\> Get-Service schedule | Suspend-Service

Tento příkaz používá rutinu Get-Service k získání objektu, který představuje službu Plánovač úloh (Schedule) v počítači. Operátor kanálu (|) předá výsledek pozastavení služby, která službu pozastaví.

Příklad 4: Pozastavení všech služeb, které je možné pozastavit

PS C:\> Get-Service | Where-Object {$_.CanPauseAndContinue -eq "True"} | Suspend-Service -Confirm

Tento příkaz pozastaví všechny služby v počítači, který je možné pozastavit. Používá Get-Service k získání objektů, které představují služby v počítači. Operátor kanálu předá výsledky rutině Where-Object, která vybere pouze služby, které mají hodnotu $True pro vlastnost CanPauseAndContinue. Jiný operátor kanálu předá výsledky pozastavení služby. Parametr Potvrďte, vás před pozastavením jednotlivých služeb vyzve k potvrzení.

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í pozastavit. 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é se mají vynechat ze zadaných služeb. 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

-Include

Určuje služby, které se mají pozastavit. 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é mají být pozastaveny. 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í pozastavit. Jsou povoleny zástupné znaky.

Název parametru je volitelný. Můžete použít Název nebo jeho alias, ServiceNamenebo můžete vynechat název parametru.

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

-PassThru

Vrátí objekt představující položku, se kterou pracujete. 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 objekt System.ServiceProcess.ServiceController, který představuje službu, pokud zadáte parametr PassThru. Jinak tato rutina negeneruje žádný výstup.

Poznámky

  • pozastavit službu 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í.
  • pozastavit službu může pozastavit pouze služby, které podporují pozastavení a obnovení. Pokud chcete zjistit, jestli je možné určitou službu pozastavit, použijte rutinu Get-Service společně s vlastností CanPauseAndContinue. Například Get-Service wmi | Format-List Name, CanPauseAndContinue. Chcete-li najít všechny služby v počítači, který lze pozastavit, zadejte Get-Service | Where-Object {$_.CanPauseAndContinue -eq $true}.
  • 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.