Suspend-Service
Egy vagy több futó szolgáltatást felfüggeszt (szüneteltet).
Syntax
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>]
Description
A Suspend-Service
parancsmag felfüggesztő üzenetet küld a Windows szolgáltatásvezérlőnek minden egyes megadott szolgáltatáshoz. Felfüggesztve a szolgáltatás továbbra is fut, de a művelet a folytatásig leáll, például a Resume-Service
parancsmag használatával. Megadhatja a szolgáltatásokat a szolgáltatásnevek vagy megjelenítendő nevek alapján, vagy az InputObject paraméterrel átadhat egy szolgáltatásobjektumot, amely a felfüggeszteni kívánt szolgáltatásokat jelöli.
Példák
1. példa: Szolgáltatás felfüggesztése
PS C:\> Suspend-Service -DisplayName "Telnet"
Ez a parancs felfüggeszti a Telnet szolgáltatás (Tlntsvr) szolgáltatást a helyi számítógépen.
2. példa: Mi történne, ha felfüggesztené a szolgáltatásokat
PS C:\> Suspend-Service -Name lanman* -WhatIf
Ez a parancs bemutatja, mi történne, ha felfüggesztette a lanmannel kezdődő szolgáltatásnevet tartalmazó szolgáltatásokat. A szolgáltatások felfüggesztéséhez futtassa újra a parancsot a WhatIf paraméter nélkül.
3. példa: Szolgáltatás lekérése és felfüggesztése
PS C:\> Get-Service schedule | Suspend-Service
Ez a parancs a Get-Service
parancsmaggal lekér egy objektumot, amely a feladatütemező (Schedule) szolgáltatást jelöli a számítógépen. A folyamatkezelő (|
) átadja az eredményt a szolgáltatás felfüggesztéséhez Suspend-Service
.
4. példa: Az összes felfüggeszthető szolgáltatás felfüggesztése
PS C:\> Get-Service | Where-Object {$_.CanPauseAndContinue -eq "True"} | Suspend-Service -Confirm
Ez a parancs felfüggeszti a számítógépen lévő összes olyan szolgáltatást, amelyet fel lehet függeszteni. A számítógépen található szolgáltatásokat képviselő objektumok lekérésére használ Get-Service
. A folyamatüzemeltető átadja az eredményeket a Where-Object
parancsmagnak, amely csak azokat a szolgáltatásokat választja ki, amelyek értéke $True
a CanPauseAndContinue tulajdonság. Egy másik folyamatkezelő átadja az eredményeket a következőnek Suspend-Service
: . A Megerősítés paraméter megerősítést kér az egyes szolgáltatások felfüggesztése előtt.
Paraméterek
-Confirm
Jóváhagyást kér a parancsmag futtatása előtt.
Típus: | SwitchParameter |
Aliasok: | cf |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-DisplayName
Megadja a felfüggesztendő szolgáltatások megjelenítendő nevét. A helyettesítő karakterek használata engedélyezett.
Típus: | String[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | True |
-Exclude
Megadja a megadott szolgáltatásokból kihagyandó szolgáltatásokat. Ennek a paraméternek az értéke a Név paramétert minősíti. Adjon meg egy névelemet vagy mintát, például "s*". A helyettesítő karakterek használata engedélyezett.
Típus: | String[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | True |
-Include
Megadja a felfüggesztendő szolgáltatásokat. Ennek a paraméternek az értéke a Név paramétert minősíti. Adjon meg egy névelemet vagy mintát, például "s*". A helyettesítő karakterek használata engedélyezett.
Típus: | String[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | True |
-InputObject
A felfüggesztendő szolgáltatásokat képviselő ServiceController-objektumokat adja meg. Adjon meg egy változót, amely tartalmazza az objektumokat, vagy írjon be egy parancsot vagy kifejezést, amely lekéri az objektumokat.
Típus: | ServiceController[] |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Name
Megadja a felfüggesztendő szolgáltatások szolgáltatásneveit. A helyettesítő karakterek használata engedélyezett.
A paraméter neve nem kötelező. Használhatja a Nevet vagy annak aliasát, a ServiceName nevet, vagy kihagyhatja a paraméter nevét.
Típus: | String[] |
Aliasok: | ServiceName |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | True |
-PassThru
Azt az elemet képviselő objektumot adja vissza, amellyel dolgozik. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
Típus: | SwitchParameter |
Aliasok: | wi |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
A szolgáltatásobjektumot erre a parancsmagra csövezheti.
Erre a parancsmagra egy szolgáltatásnevet tartalmazó sztringet csövezhet.
Kimenetek
None
Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.
A PassThru paraméter használatakor ez a parancsmag a szolgáltatást képviselő ServiceController-objektumot adja vissza.
Jegyzetek
Suspend-Service
csak akkor tudja vezérelni a szolgáltatásokat, ha az aktuális felhasználó rendelkezik erre vonatkozó engedéllyel. Ha egy parancs nem működik megfelelően, előfordulhat, hogy nem rendelkezik a szükséges engedélyekkel.Suspend-Service
csak olyan szolgáltatásokat függeszthet fel, amelyek támogatják a felfüggesztést és a folytatást. Annak megállapításához, hogy egy adott szolgáltatás felfüggeszthető-e, használja aGet-Service
parancsmagot a CanPauseAndContinue tulajdonsággal együtt. Például:Get-Service wmi | Format-List Name, CanPauseAndContinue
. Ha meg szeretné keresni a számítógépen a felfüggeszthető összes szolgáltatást, írja be a következőtGet-Service | Where-Object {$_.CanPauseAndContinue -eq $true}
: .- A szolgáltatások nevének és a szolgáltatások megjelenítendő nevének megkereséséhez írja be a következőt
Get-Service
: . A szolgáltatásnevek a Név oszlopban, a megjelenített nevek pedig a DisplayName oszlopban jelennek meg.