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 czasu wznowienia, na przykład za pomocą polecenia Resume-Service 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.

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, które mają być zawieszone. 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 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.

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

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 żadnych danych wyjściowych.

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

To polecenie cmdlet jest dostępne 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 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 .