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

Tato rutina je dostupná jenom na platformě Windows.

Rutina Suspend-Service odešle zprávu o pozastavení 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í Resume-Service rutiny. 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ž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 Suspend-Service, který pozastaví službu.

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 se 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 CanPauseAndContinue vlastnost. Jiný operátor kanálu předává výsledky do Suspend-Service. Před pozastavením jednotlivých služeb vás parametr Confirm vyzve k potvrzení.

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í 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 k pozastavení. 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, ServiceName nebo 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

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

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

  • Suspend-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í.
  • Suspend-Service může pozastavit pouze služby, které podporují pozastavení a obnovení. Chcete-li zjistit, zda lze určitou službu pozastavit, použijte rutinu Get-Service společně s CanPauseAndContinue vlastnost. 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 .