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

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 czasu wznowienia, na przykład za pomocą Resume-Service polecenia cmdlet . Możesz określić usługi według nazw usług lub nazw wyświetlanych albo użyć parametru InputObject do przekazania obiektu usługi reprezentującego usługi, które mają zostać zawieszone.

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 reprezentującego 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óre można zawiesić. Używa Get-Service 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 Confirm monituje o potwierdzenie przed wstrzymaniem każdej z usług.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DisplayName

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

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:True

-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*". Dozwolone są symbole wieloznaczne.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:ServiceController[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

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

Nazwa parametru jest opcjonalna. Możesz użyć nazwy parametru Name lub jego aliasu, Nazwy usługi lub można pominąć nazwę parametru.

Typ:String[]
Aliasy:ServiceName
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-PassThru

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

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

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

ServiceController

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

String

Możesz potokować ciąg zawierający 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

  • 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 program 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 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ą w kolumnie DisplayName .