Stop-Service (Microsoft.PowerShell.Management)

Stop-Service

โมดูล :

Microsoft.PowerShell.Management

หยุดบริการที่ทำงานอยู่อย่างน้อยหนึ่งบริการ

ไวยากรณ์

Stop-Service
    [-Force]
    [-NoWait]
    [-InputObject] <ServiceController[]>
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Stop-Service
    [-Force]
    [-NoWait]
    [-Name] <String[]>
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Stop-Service
    [-Force]
    [-NoWait]
    [-PassThru]
    -DisplayName <String[]>
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

คำอธิบาย

cmdlet นี้ใช้ได้เฉพาะบนแพลตฟอร์ม Windows เท่านั้น

Stop-Service cmdlet ส่งข้อความหยุดไปยัง Windows Service Controller สำหรับแต่ละบริการที่ระบุ คุณสามารถระบุบริการตามชื่อบริการหรือชื่อที่แสดง หรือคุณสามารถใช้พารามิเตอร์ InputObject เพื่อส่งวัตถุบริการที่แสดงถึงบริการที่คุณต้องการหยุด

ตัวอย่าง

ตัวอย่างที่ 1: หยุดบริการบนคอมพิวเตอร์เฉพาะที่

PS C:\> Stop-Service -Name "sysmonlog"

คำสั่งนี้หยุดบริการบันทึกประสิทธิภาพและการแจ้งเตือน (SysmonLog) บนเครื่องคอมพิวเตอร์

ตัวอย่างที่ 2: หยุดบริการโดยใช้ชื่อที่แสดง

PS C:\> Get-Service -DisplayName "telnet" | Stop-Service

คำสั่งนี้จะหยุดบริการ Telnet บนเครื่องคอมพิวเตอร์ คำสั่งใช้ Get-Service เพื่อรับวัตถุที่แสดงถึงบริการ Telnet ตัวดำเนินการไปป์ไลน์ (|) ไปป์วัตถุไปที่ Stop-Service ซึ่งจะหยุดการบริการ

ตัวอย่างที่ 3: หยุดบริการที่มีบริการที่ต้องพึ่งพา

PS C:\> Get-Service -Name "iisadmin" | Format-List -Property Name, DependentServices
PS C:\> Stop-Service -Name "iisadmin" -Force -Confirm

ตัวอย่างนี้หยุดบริการ IISAdmin บนเครื่องคอมพิวเตอร์ เนื่องจากการหยุดบริการนี้ยังหยุดบริการที่ขึ้นอยู่กับบริการ IISAdmin วิธีที่ดีที่สุดคือนำหน้า Stop-Service ด้วยคำสั่งที่แสดงรายการบริการที่ขึ้นอยู่กับบริการ IISAdmin

คำสั่งแรกแสดงรายการบริการที่ขึ้นอยู่กับ IISAdmin ใช้ Get-Service เพื่อรับวัตถุที่แสดงถึงบริการ IISAdmin ตัวดำเนินการไปป์ไลน์ (|) ส่งผ่านผลลัพธ์ไปยัง Format-List cmdlet คำสั่งใช้พารามิเตอร์ Property ของ Format-List เพื่อแสดงรายการเฉพาะคุณสมบัติ Name และ DependentServices ของบริการ

คำสั่งที่สองหยุดบริการ IISAdmin ต้องใช้พารามิเตอร์ บังคับ เพื่อหยุดบริการที่มีบริการที่ต้องพึ่งพา คำสั่งใช้พารามิเตอร์ ยืนยัน เพื่อขอการยืนยันจากผู้ใช้ก่อนที่จะหยุดแต่ละบริการ

พารามิเตอร์

-Confirm

แจ้งให้คุณยืนยันก่อนเรียกใช้ cmdlet

พิมพ์ :

SwitchParameter

นามแฝง :

cf

ตำแหน่ง:

ตั้งชื่อ

ค่าเริ่มต้น:

False

ที่จำเป็น:

False

ยอมรับอินพุตไปป์ไลน์:

False

ยอมรับอักขระตัวแทน:

False

-DisplayName

ระบุชื่อที่แสดงของบริการที่จะหยุด อนุญาตให้ใช้อักขระตัวแทนได้

พิมพ์ :

String[]

ตำแหน่ง:

ตั้งชื่อ

ค่าเริ่มต้น:

None

ที่จำเป็น:

True

ยอมรับอินพุตไปป์ไลน์:

False

ยอมรับอักขระตัวแทน:

True

-Exclude

ระบุบริการที่ cmdlet นี้ละเว้น ค่าของพารามิเตอร์นี้มีคุณสมบัติตรงตามพารามิเตอร์ ชื่อ ป้อนองค์ประกอบหรือรูปแบบชื่อ เช่น s* อนุญาตให้ใช้อักขระตัวแทนได้

พิมพ์ :

String[]

ตำแหน่ง:

ตั้งชื่อ

ค่าเริ่มต้น:

None

ที่จำเป็น:

False

ยอมรับอินพุตไปป์ไลน์:

False

ยอมรับอักขระตัวแทน:

True

-Force

บังคับให้ cmdlet หยุดบริการแม้ว่าบริการนั้นมีบริการที่ต้องพึ่งพาก็ตาม

พิมพ์ :

SwitchParameter

ตำแหน่ง:

ตั้งชื่อ

ค่าเริ่มต้น:

None

ที่จำเป็น:

False

ยอมรับอินพุตไปป์ไลน์:

False

ยอมรับอักขระตัวแทน:

False

-Include

ระบุบริการที่ cmdlet นี้หยุด ค่าของพารามิเตอร์นี้มีคุณสมบัติตรงตามพารามิเตอร์ ชื่อ ป้อนองค์ประกอบหรือรูปแบบชื่อ เช่น s* อนุญาตให้ใช้อักขระตัวแทนได้

พิมพ์ :

String[]

ตำแหน่ง:

ตั้งชื่อ

ค่าเริ่มต้น:

None

ที่จำเป็น:

False

ยอมรับอินพุตไปป์ไลน์:

False

ยอมรับอักขระตัวแทน:

True

-InputObject

ระบุออบเจ็กต์ ServiceController ที่แสดงถึงบริการที่จะหยุด ป้อนตัวแปรที่มีวัตถุ หรือพิมพ์คำสั่งหรือนิพจน์ที่ได้รับวัตถุ

พิมพ์ :

ตัวควบคุมบริการ[]

ตำแหน่ง:

0

ค่าเริ่มต้น:

None

ที่จำเป็น:

True

ยอมรับอินพุตไปป์ไลน์:

True

ยอมรับอักขระตัวแทน:

False

-Name

ระบุชื่อบริการของบริการที่จะหยุด อนุญาตให้ใช้อักขระตัวแทนได้

พิมพ์ :

String[]

นามแฝง :

ServiceName

ตำแหน่ง:

0

ค่าเริ่มต้น:

None

ที่จำเป็น:

True

ยอมรับอินพุตไปป์ไลน์:

True

ยอมรับอักขระตัวแทน:

True

-NoWait

บ่งชี้ว่า cmdlet นี้ใช้ตัวเลือกไม่ต้องรอ

พิมพ์ :

SwitchParameter

ตำแหน่ง:

ตั้งชื่อ

ค่าเริ่มต้น:

None

ที่จำเป็น:

False

ยอมรับอินพุตไปป์ไลน์:

False

ยอมรับอักขระตัวแทน:

False

-PassThru

ส่งกลับวัตถุที่แสดงถึงบริการ ตามค่าเริ่มต้น cmdlet นี้ไม่สร้างผลลัพธ์ใดๆ

พิมพ์ :

SwitchParameter

ตำแหน่ง:

ตั้งชื่อ

ค่าเริ่มต้น:

None

ที่จำเป็น:

False

ยอมรับอินพุตไปป์ไลน์:

False

ยอมรับอักขระตัวแทน:

False

-WhatIf

แสดงสิ่งที่จะเกิดขึ้นหาก cmdlet ทำงาน cmdlet ไม่ทำงาน

พิมพ์ :

SwitchParameter

นามแฝง :

wi

ตำแหน่ง:

ตั้งชื่อ

ค่าเริ่มต้น:

False

ที่จำเป็น:

False

ยอมรับอินพุตไปป์ไลน์:

False

ยอมรับอักขระตัวแทน:

False

อินพุต

ตัวควบคุมบริการ

คุณสามารถไปป์วัตถุบริการไปยัง cmdlet นี้

สตริง

คุณสามารถไปป์สตริงที่ประกอบด้วยชื่อของบริการไปยัง cmdlet นี้

เอาท์พุต

ไม่มี

ตามค่าเริ่มต้น cmdlet นี้จะส่งกลับไม่มีผลลัพธ์

ตัวควบคุมบริการ

เมื่อคุณใช้พารามิเตอร์ PassThru cmdlet นี้จะส่งคืนออบเจ็กต์ ServiceController ที่แสดงถึงบริการ

หมายเหตุ

PowerShell มีนามแฝงต่อไปนี้สำหรับ Stop-Service:

• Windows:

  spsv

cmdlet นี้ใช้ได้เฉพาะบนแพลตฟอร์ม Windows เท่านั้น

Stop-Service สามารถควบคุมบริการได้เฉพาะเมื่อผู้ใช้ปัจจุบันได้รับอนุญาตให้ดำเนินการนี้เท่านั้น หากคำสั่งทำงานไม่ถูกต้อง คุณอาจไม่มีสิทธิ์ที่จำเป็น

หากต้องการค้นหาชื่อบริการและชื่อที่แสดงของบริการในระบบของคุณ ให้พิมพ์ Get-Service ชื่อบริการปรากฏในคอลัมน์ ชื่อ และชื่อที่แสดงปรากฏในคอลัมน์ ชื่อที่แสดง