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
A Szolgáltatás felfüggesztése 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
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 folyamatüzemeltető (|) átadja az eredményt Szolgáltatás felfüggesztése, amely felfüggeszti a szolgáltatást.
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 Get-Service használatával szerzi be a számítógépen található szolgáltatásokat képviselő objektumokat. 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 Szolgáltatás felfüggesztése. 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: | ServiceController[] |
| 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
System.ServiceProcess.ServiceController, System.String
A parancsmaghoz egy szolgáltatásobjektumot vagy egy szolgáltatásnevet tartalmazó sztringet is csövezhet.
Kimenetek
None, System.ServiceProcess.ServiceController
Ez a parancsmag létrehoz egy System.ServiceProcess.ServiceController objektumot, amely a szolgáltatást jelöli, ha megadja a PassThru paramétert. Ellenkező esetben ez a parancsmag nem hoz létre kimenetet.
Jegyzetek
- Szolgáltatás felfüggesztése csak akkor tudja szabályozni 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.
-
Szolgáltatás felfüggesztése csak azokat a szolgáltatásokat függesztheti 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 a Get-Service parancsmagot 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.