Udostępnij za pośrednictwem

Suspend-Service

  • Odwołanie
Moduł:
Microsoft.PowerShell.Management

Zawiesza (wstrzymuje) co najmniej jedną uruchomioną usługę.

Składnia

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

Opis

To polecenie cmdlet jest dostępne tylko na platformie Windows.

Polecenie Suspend-Service cmdlet wysyła komunikat wstrzymania do kontrolera usługi systemu Windows dla każdej z określonych usług. Mimo wstrzymania usługa jest nadal uruchomiona, ale jej akcja jest zatrzymywana do momentu wznowienia, na przykład za pomocą Resume-Service polecenia cmdlet . Możesz określić usługi według ich nazw usług lub nazw wyświetlanych albo użyć parametru InputObject , aby przekazać obiekt usługi reprezentujący usługi, które mają zostać wstrzymane.

Przykłady

Przykład 1. Wstrzymanie usługi

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

To polecenie zawiesza usługę Telnet (Tlntsvr) na komputerze lokalnym.

Przykład 2. Wyświetlanie, co się stanie w przypadku zawieszenia usług

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

To polecenie informuje, co się stanie, jeśli wstrzymano usługi, które mają nazwę usługi rozpoczynającą się od lanman. Aby zawiesić usługi, uruchom ponownie polecenie bez parametru WhatIf .

Przykład 3. Pobieranie i zawieszanie usługi

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

To polecenie używa Get-Service polecenia cmdlet do pobrania obiektu, który reprezentuje usługę Harmonogram zadań (harmonogram) na komputerze. Operator potoku (|) przekazuje wynik do Suspend-Serviceelementu , który zawiesza usługę.

Przykład 4. Wstrzymanie wszystkich usług, które można zawiesić

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

To polecenie zawiesza wszystkie usługi na komputerze, który można zawiesić. Get-Service Używa go do pobierania obiektów reprezentujących usługi na komputerze. Operator potoku przekazuje wyniki do Where-Object polecenia cmdlet, które wybiera tylko usługi, które mają wartość $True dla właściwości CanPauseAndContinue . Inny operator potoku przekazuje wyniki do Suspend-Service. Parametr Potwierdzanie monituje o potwierdzenie przed zawieszeniem każdej z usług.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Określa nazwy wyświetlane usług do zawieszenia. Dozwolone są symbole wieloznaczne.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-Exclude

Określa usługi pomijania z określonych usług. Wartość tego parametru kwalifikuje parametr Name . Wprowadź element nazwy lub wzorzec, taki jak "s*". Dozwolone są symbole wieloznaczne.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Include

Określa usługi do wstrzymania. Wartość tego parametru kwalifikuje parametr Name . Wprowadź element nazwy lub wzorzec, taki jak "s*". Dozwolone są symbole wieloznaczne.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-InputObject

Określa obiekty ServiceController , które reprezentują usługi do zawieszenia. Wprowadź zmienną zawierającą obiekty lub wpisz polecenie lub wyrażenie, które pobiera obiekty.

Type:ServiceController[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Określa nazwy usług do zawieszenia. Dozwolone są symbole wieloznaczne.

Nazwa parametru jest opcjonalna. Możesz użyć nazwy lub aliasu, nazwy usługi lub pominięcia nazwy parametru.

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

-PassThru

Zwraca obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet nie generuje żadnego wyniku.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

ServiceController

Do tego polecenia cmdlet można przekazać obiekt usługi.

String

Możesz przekazać potok ciągu zawierającego nazwę usługi do tego polecenia cmdlet.

Dane wyjściowe

None

Domyślnie to polecenie cmdlet nie zwraca żadnych danych wyjściowych.

ServiceController

Jeśli używasz parametru PassThru , to polecenie cmdlet zwraca obiekt ServiceController reprezentujący usługę.

Uwagi

To polecenie cmdlet jest dostępne tylko na platformach systemu Windows.

  • Suspend-Service może kontrolować usługi tylko wtedy, gdy bieżący użytkownik ma uprawnienia do tego. Jeśli polecenie nie działa poprawnie, być może nie masz wymaganych uprawnień.
  • Suspend-Service może zawiesić tylko usługi, które obsługują wstrzymanie i wznowienie. Aby określić, czy można zawiesić określoną usługę, użyj Get-Service polecenia cmdlet wraz z właściwością CanPauseAndContinue . Na przykład Get-Service wmi | Format-List Name, CanPauseAndContinue. Aby znaleźć wszystkie usługi na komputerze, które można zawiesić, wpisz Get-Service | Where-Object {$_.CanPauseAndContinue -eq $true}.
  • Aby znaleźć nazwy usług i nazwy wyświetlane usług w systemie, wpisz Get-Service. Nazwy usług są wyświetlane w kolumnie Nazwa , a nazwy wyświetlane są w kolumnie DisplayName .