Suspend-Service
Egy vagy több futó szolgáltatást felfüggeszt (szüneteltet).
Syntax
InputObject (Alapértelmezett)
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>]
Description
Ez a parancsmag csak a Windows platformon érhető el.
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 használhatja a InputObject paramétert egy olyan szolgáltatásobjektum átadásához, amely a felfüggeszteni kívánt szolgáltatásokat jelöli.
Példák
1. példa: Szolgáltatás felfüggesztése
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
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
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 folyamatüzemeltető (|) átadja az eredményt Suspend-Service, amely felfüggeszti a szolgáltatást.
4. példa: Az összes felfüggeszthető szolgáltatás felfüggesztése
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.
Get-Service használ a számítógépen található szolgáltatásokat képviselő objektumok lekérésére. A folyamatkezelő átadja az eredményeket a Where-Object parancsmagnak, amely csak azokat a szolgáltatásokat választja ki, amelyek $true értékkel rendelkeznek a CanPauseAndContinue tulajdonsághoz. Egy másik folyamatkezelő átadja az eredményeket Suspend-Service. A Confirm paraméter megerősítést kér, mielőtt felfüggesztené az egyes szolgáltatásokat.
Paraméterek
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cf |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-DisplayName
Megadja a felfüggesztendő szolgáltatások megjelenítendő nevét. A helyettesítő karakterek használata engedélyezett.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
DisplayName
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Exclude
Megadja a megadott szolgáltatásokból kihagyandó szolgáltatásokat. A paraméter értéke megfelel a Név paraméternek. Adjon meg egy névelemet vagy mintát, például "s*". A helyettesítő karakterek használata engedélyezett.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Include
Megadja a felfüggesztendő szolgáltatásokat. A paraméter értéke megfelel a Név paraméternek. Adjon meg egy névelemet vagy mintát, például "s*". A helyettesítő karakterek használata engedélyezett.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-InputObject
Megadja ServiceController objektumokat, amelyek a felfüggesztendő szolgáltatásokat jelölik. Adjon meg egy változót, amely tartalmazza az objektumokat, vagy írjon be egy parancsot vagy kifejezést, amely lekéri az objektumokat.
Paramétertulajdonságok
| Típus: | |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
InputObject
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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 Név vagy annak aliasát, ServiceName, vagy kihagyhatja a paraméter nevét.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
| Aliasok: | Szolgáltatás neve |
Paraméterkészletek
Default
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-PassThru
Azt az elemet képviselő objektumot adja vissza, amellyel dolgozik. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Wi |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
ServiceController
A szolgáltatásobjektumot erre a parancsmagra csövezheti.
String
Erre a parancsmagra egy szolgáltatásnevet tartalmazó sztringet csövezhet.
Kimenetek
None
Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.
ServiceController
A PassThru paraméter használatakor ez a parancsmag egy ServiceController objektumot ad vissza, amely a szolgáltatást jelöli.
Jegyzetek
Ez a parancsmag csak Windows-platformokon érhető el.
-
Suspend-Servicecsak akkor szabályozhatja 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-Servicecsak 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-Serviceparancsmagot a CanPauseAndContinue tulajdonsággal együtt. Például:Get-Service wmi | Format-List Name, CanPauseAndContinue. A felfüggeszthető összes szolgáltatás megkereséséhez írja be aGet-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
Get-Service. A szolgáltatásnevek a Név oszlopban jelennek meg, a megjelenítendő nevek pedig a DisplayName oszlopban jelennek meg.