Suspend-Service (Microsoft.PowerShell.Management)
Suspend-Service
- โมดูล :
- Microsoft.PowerShell.Management
ระงับ (หยุดชั่วคราว) บริการที่ทำงานอยู่อย่างน้อยหนึ่งบริการ
ไวยากรณ์
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>]คำอธิบาย
cmdlet นี้ใช้ได้เฉพาะบนแพลตฟอร์ม Windows เท่านั้น
Suspend-Service cmdlet ส่งข้อความระงับไปยัง Windows Service Controller สำหรับแต่ละบริการที่ระบุ ในขณะที่ถูกระงับ บริการยังคงทำงานอยู่ แต่การดำเนินการจะหยุดจนกว่าจะกลับมาทำงานต่อ เช่น โดยใช้ cmdlet Resume-Service คุณสามารถระบุบริการตามชื่อบริการหรือชื่อที่แสดง หรือคุณสามารถใช้พารามิเตอร์ InputObject เพื่อส่งวัตถุบริการที่แสดงถึงบริการที่คุณต้องการระงับ
ตัวอย่าง
ตัวอย่างที่ 1: ระงับบริการ
PS C:\> Suspend-Service -DisplayName "Telnet"คำสั่งนี้ระงับบริการ Telnet (Tlntsvr) บนเครื่องคอมพิวเตอร์
ตัวอย่างที่ 2: แสดงสิ่งที่จะเกิดขึ้นหากคุณระงับบริการ
PS C:\> Suspend-Service -Name lanman* -WhatIfคำสั่งนี้บอกว่าจะเกิดอะไรขึ้นหากคุณระงับบริการที่มีชื่อบริการที่ขึ้นต้นด้วย lanman หากต้องการระงับบริการ ให้รันคำสั่งอีกครั้งโดยไม่มีพารามิเตอร์ WhatIf
ตัวอย่างที่ 3: รับและระงับบริการ
PS C:\> Get-Service schedule | Suspend-Service
คำสั่งนี้ใช้ cmdlet Get-Service เพื่อรับวัตถุที่แสดงถึงบริการ Task Scheduler (Schedule) บนคอมพิวเตอร์ ตัวดำเนินการไปป์ไลน์ (|) ส่งผลลัพธ์ไปยัง Suspend-Service ซึ่งจะระงับบริการ
ตัวอย่างที่ 4: ระงับบริการทั้งหมดที่สามารถระงับได้
PS C:\> Get-Service | Where-Object {$_.CanPauseAndContinue -eq "True"} | Suspend-Service -Confirmคำสั่งนี้จะระงับบริการทั้งหมดบนคอมพิวเตอร์ที่สามารถระงับได้ ใช้ Get-Service เพื่อรับวัตถุที่แสดงถึงบริการบนคอมพิวเตอร์ ตัวดำเนินการไปป์ไลน์จะส่งผลลัพธ์ไปยัง Where-Object cmdlet ซึ่งเลือกเฉพาะบริการที่มีค่า $True สำหรับคุณสมบัติ CanPauseAndContinue . ตัวดำเนินการไปป์ไลน์อื่นส่งผลลัพธ์ไปที่ Suspend-Service พารามิเตอร์ ยืนยัน จะแจ้งให้คุณยืนยันก่อนที่จะระงับบริการแต่ละรายการ
พารามิเตอร์
-Confirm
แจ้งให้คุณยืนยันก่อนเรียกใช้ cmdlet
- พิมพ์ :
SwitchParameter
- นามแฝง :
cf
- ตำแหน่ง:
ตั้งชื่อ
- ค่าเริ่มต้น:
False
- ที่จำเป็น:
False
- ยอมรับอินพุตไปป์ไลน์:
False
- ยอมรับอักขระตัวแทน:
False
-DisplayName
ระบุชื่อที่แสดงของบริการที่จะระงับ อนุญาตให้ใช้อักขระตัวแทนได้
- พิมพ์ :
String[]
- ตำแหน่ง:
ตั้งชื่อ
- ค่าเริ่มต้น:
None
- ที่จำเป็น:
True
- ยอมรับอินพุตไปป์ไลน์:
False
- ยอมรับอักขระตัวแทน:
True
-Exclude
ระบุบริการที่จะละเว้นจากบริการที่ระบุ ค่าของพารามิเตอร์นี้มีคุณสมบัติตรงตามพารามิเตอร์ ชื่อ ป้อนองค์ประกอบหรือรูปแบบชื่อ เช่น "s*" อนุญาตให้ใช้อักขระตัวแทนได้
- พิมพ์ :
String[]
- ตำแหน่ง:
ตั้งชื่อ
- ค่าเริ่มต้น:
-
None
- ที่จำเป็น:
False
- ยอมรับอินพุตไปป์ไลน์:
False
- ยอมรับอักขระตัวแทน:
True
-Include
ระบุบริการที่จะระงับ ค่าของพารามิเตอร์นี้มีคุณสมบัติตรงตามพารามิเตอร์ ชื่อ ป้อนองค์ประกอบหรือรูปแบบชื่อ เช่น "s*" อนุญาตให้ใช้อักขระตัวแทนได้
- พิมพ์ :
String[]
- ตำแหน่ง:
ตั้งชื่อ
- ค่าเริ่มต้น:
None
- ที่จำเป็น:
False
- ยอมรับอินพุตไปป์ไลน์:
False
- ยอมรับอักขระตัวแทน:
True
-InputObject
ระบุออบเจ็กต์ ServiceController ที่แสดงถึงบริการที่จะระงับ ป้อนตัวแปรที่มีวัตถุ หรือพิมพ์คำสั่งหรือนิพจน์ที่ได้รับวัตถุ
- พิมพ์ :
ตัวควบคุมบริการ[]
- ตำแหน่ง:
0
- ค่าเริ่มต้น:
None
- ที่จำเป็น:
True
- ยอมรับอินพุตไปป์ไลน์:
True
- ยอมรับอักขระตัวแทน:
False
-Name
ระบุชื่อบริการของบริการที่จะระงับ อนุญาตให้ใช้อักขระตัวแทนได้
ชื่อพารามิเตอร์เป็นทางเลือก คุณสามารถใช้ ชื่อ หรือชื่อแทน ชื่อบริการ หรือจะละชื่อพารามิเตอร์ก็ได้
- พิมพ์ :
String[]
- นามแฝง :
ServiceName
- ตำแหน่ง:
0
- ค่าเริ่มต้น:
None
- ที่จำเป็น:
True
- ยอมรับอินพุตไปป์ไลน์:
True
- ยอมรับอักขระตัวแทน:
True
-PassThru
ส่งกลับวัตถุที่เป็นตัวแทนของรายการที่คุณกำลังทำงานอยู่ ตามค่าเริ่มต้น cmdlet นี้ไม่สร้างผลลัพธ์ใดๆ
- พิมพ์ :
SwitchParameter
- ตำแหน่ง:
ตั้งชื่อ
- ค่าเริ่มต้น:
None
- ที่จำเป็น:
False
- ยอมรับอินพุตไปป์ไลน์:
False
- ยอมรับอักขระตัวแทน:
False
-WhatIf
แสดงสิ่งที่จะเกิดขึ้นหาก cmdlet ทำงาน cmdlet ไม่ทำงาน
- พิมพ์ :
SwitchParameter
- นามแฝง :
wi
- ตำแหน่ง:
ตั้งชื่อ
- ค่าเริ่มต้น:
False
- ที่จำเป็น:
False
- ยอมรับอินพุตไปป์ไลน์:
False
- ยอมรับอักขระตัวแทน:
False
อินพุต
ตัวควบคุมบริการ
คุณสามารถไปป์วัตถุบริการไปยัง cmdlet นี้
สตริง
คุณสามารถไปป์สตริงที่มีชื่อบริการไปยัง cmdlet นี้
เอาท์พุต
ไม่มี
ตามค่าเริ่มต้น cmdlet นี้จะส่งกลับไม่มีผลลัพธ์
ตัวควบคุมบริการ
เมื่อคุณใช้พารามิเตอร์ PassThru cmdlet นี้จะส่งคืนออบเจ็กต์ ServiceController ที่แสดงถึงบริการ
หมายเหตุ
cmdlet นี้ใช้ได้เฉพาะบนแพลตฟอร์ม Windows เท่านั้น
Suspend-Serviceสามารถควบคุมบริการได้เฉพาะเมื่อผู้ใช้ปัจจุบันได้รับอนุญาตให้ดำเนินการนี้เท่านั้น หากคำสั่งทำงานไม่ถูกต้อง คุณอาจไม่มีสิทธิ์ที่จำเป็นSuspend-Serviceสามารถระงับได้เฉพาะบริการที่รองรับการระงับและกลับมาทำงานต่อเท่านั้น หากต้องการตรวจสอบว่าบริการใดบริการหนึ่งสามารถระงับได้หรือไม่ ให้ใช้Get-Servicecmdlet ร่วมกับคุณสมบัติ CanPauseAndContinue ตัวอย่างเช่นรับบริการ wmi | ชื่อรูปแบบรายการ CanPauseAndContinueหากต้องการค้นหาบริการทั้งหมดบนคอมพิวเตอร์ที่สามารถระงับได้ ให้พิมพ์Get-Service | โดยที่วัตถุ {$_.CanPauseAndContinue -eq $true}- หากต้องการค้นหาชื่อบริการและชื่อที่แสดงของบริการในระบบของคุณ ให้พิมพ์
Get-Serviceชื่อบริการปรากฏในคอลัมน์ ชื่อ และชื่อที่แสดงปรากฏในคอลัมน์ ชื่อที่แสดง