Sdílet prostřednictvím

Suspend-Service

Modul:
Microsoft.PowerShell.Management Module

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

Syntaxe

InputObject (Výchozí) 

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

Default 

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

DisplayName 

Suspend-Service
    -DisplayName <String[]>
    [-PassThru]
    [-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í 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

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

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

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ý službu pozastaví.

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

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 Suspend-Service. Parametr Potvrďte, vás před pozastavením jednotlivých služeb vyzve k potvrzení.

Parametry

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:viz

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-DisplayName

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

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:True
DontShow:False

Sady parametrů

DisplayName
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

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

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:True
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

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

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:True
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

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

Vlastnosti parametru

Typ:

ServiceController[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

InputObject
Position:0
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:True
DontShow:False
Aliasy:Název služby

Sady parametrů

Default
Position:0
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-PassThru

Vrátí objekt představující položku, se kterou pracujete. Ve výchozím nastavení tato rutina negeneruje žádný výstup.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Wi

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

ServiceController

Objekt služby můžete předat tomuto cmdletu.

String

Do tohoto příkazu můžete předat řetězec obsahující 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 ServiceController objekt představující službu.

Poznámky

Tento cmdlet je dostupný pouze 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í. 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.