Udostępnij przez

Suspend-Service

Moduł:
Microsoft.PowerShell.Management Module

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

Składnia

InputObject (Domyślne) 

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 parametrów

Typ:SwitchParameter
Wartość domyślna:False
Wspiera dzikie karty:False
DontShow:False
Aliasy:por

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość 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 parametrów

Typ:

String[]

Wartość domyślna:None
Wspiera dzikie karty:True
DontShow:False

Zbiory parametrów

DisplayName
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość 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 parametrów

Typ:

String[]

Wartość domyślna:None
Wspiera dzikie karty:True
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość 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 parametrów

Typ:

String[]

Wartość domyślna:None
Wspiera dzikie karty:True
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość 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 parametrów

Typ:

ServiceController[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

InputObject
Pozycja:0
Obowiązkowy:True
Wartość z pipeline:True
Wartość z pipeline według nazwy właściwości:False
Wartość 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 parametrów

Typ:

String[]

Wartość domyślna:None
Wspiera dzikie karty:True
DontShow:False
Aliasy:Nazwa usługi

Zbiory parametrów

Default
Pozycja:0
Obowiązkowy:True
Wartość z pipeline:True
Wartość z pipeline według nazwy właściwości:True
Wartość 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 parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

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

-WhatIf

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

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:False
Wspiera dzikie karty:False
DontShow:False
Aliasy:Wi

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość 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.

Wejścia

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.

Wyjść

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

Notatki

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.