Suspend-Service

  • Reference
Modul:
Microsoft.PowerShell.Management

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

Syntax

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

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í pozastavit. 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é 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.

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

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

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

-PassThru

Vrátí objekt představující položku, se kterou pracujete. 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

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 .