Udostępnij za pomocą

Suspend-Service

Moduł:
Microsoft.PowerShell.Management Module

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

Składnia

InputObject (Domyślna) 

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

Opis

Ten cmdlet jest dostępny tylko na platformie Windows.

Polecenie cmdlet Suspend-Service 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 czasu wznowienia, na przykład przy użyciu polecenia cmdlet Resume-Service. Możesz określić usługi według nazw usług lub nazw wyświetlanych. Można też użyć parametru InputObject, aby przekazać obiekt usługi reprezentujący usługi, które mają zostać zawieszone.

Przykłady

Przykład 1. Wstrzymanie usługi

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

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

Get-Service schedule | Suspend-Service

To polecenie używa polecenia cmdlet Get-Service, aby uzyskać obiekt reprezentujący usługę Harmonogram zadań (harmonogram) na komputerze. Operator potoku (|) przekazuje wynik do Suspend-Service, który zawiesza usługę.

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

Get-Service |
    Where-Object {$_.CanPauseAndContinue -eq "True"} |
    Suspend-Service -Confirm

To polecenie zawiesza wszystkie usługi na komputerze, które można zawiesić. Używa Get-Service do pobierania obiektów reprezentujących usługi na komputerze. Operator potoku przekazuje wyniki do polecenia cmdlet Where-Object, 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 Confirm monituje o potwierdzenie przed wstrzymaniem każdej z usług.

Parametry

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:por

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DisplayName

Określa nazwy wyświetlane usług, które mają być zawieszone. Symbole wieloznaczne są dozwolone.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:True
DontShow:False

Zestawy parametrów

DisplayName
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Exclude

Określa usługi do pominięcia z określonych usług. Wartość tego parametru kwalifikuje parametr Name. Wprowadź element nazwy lub wzorzec, taki jak "s*". Symbole wieloznaczne są dozwolone.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:True
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Include

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

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:True
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-InputObject

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

Właściwości parametru

Typ:

ServiceController[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

InputObject
Position:0
Obowiązkowy:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Name

Określa nazwy usług, które mają być zawieszone. Symbole wieloznaczne są dozwolone.

Nazwa parametru jest opcjonalna. Możesz użyć Nazwa lub jego aliasu, ServiceName, lub można pominąć nazwę parametru.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:True
DontShow:False
Aliasy:Nazwa usługi

Zestawy parametrów

Default
Position:0
Obowiązkowy:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-PassThru

Zwraca obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Wi

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

ServiceController

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

String

Możesz przekazywać ciąg zawierający nazwę usługi do tego cmdletu.

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

Ten cmdlet jest dostępny tylko na platformach 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 polecenia cmdlet Get-Service razem 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ą wyświetlane w kolumnie DisplayName.