Restart-Service (Microsoft.PowerShell.Management)

Restart-Service

โมดูล :: Microsoft.PowerShell.Management

หยุดแล้วเริ่มบริการอย่างน้อยหนึ่งรายการ

ไวยากรณ์

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

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

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

คำอธิบาย

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

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

ตัวอย่าง

ตัวอย่างที่ 1: เริ่มบริการบนเครื่องคอมพิวเตอร์ใหม่

PS C:\> Restart-Service -Name winmgmt

คำสั่งนี้รีสตาร์ทบริการ Windows Management Instrumentation (WinMgmt) บนเครื่องคอมพิวเตอร์

ตัวอย่างที่ 2: ไม่รวมบริการ

PS C:\> Restart-Service -DisplayName "net*" -Exclude "net logon"

คำสั่งนี้รีสตาร์ทบริการที่มีชื่อที่แสดงซึ่งขึ้นต้นด้วย Net ยกเว้นบริการ Net Logon

ตัวอย่างที่ 3: เริ่มบริการเครือข่ายที่หยุดทำงานทั้งหมด

PS C:\> Get-Service -Name "net*" | Where-Object {$_.Status -eq "Stopped"} | Restart-Service

คำสั่งนี้จะเริ่มบริการเครือข่ายที่หยุดทำงานทั้งหมดบนคอมพิวเตอร์

คำสั่งนี้ใช้ cmdlet Get-Service เพื่อรับออบเจ็กต์ที่แสดงถึงบริการที่มีชื่อบริการขึ้นต้นด้วย net ตัวดำเนินการไปป์ไลน์ (|) ส่งออบเจ็กต์บริการไปที่ Where-Object cmdlet ซึ่งเลือกเฉพาะบริการที่มีสถานะหยุดทำงาน ผู้ดำเนินการไปป์ไลน์รายอื่นส่งบริการที่เลือกไปที่ Restart-Service

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

พารามิเตอร์

-Confirm

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

พิมพ์ :: SwitchParameter
นามแฝง :: cf
ตำแหน่ง:: ตั้งชื่อ
ค่าเริ่มต้น:: False
ที่จำเป็น:: False
ยอมรับอินพุตไปป์ไลน์:: False
ยอมรับอักขระตัวแทน:: False

-DisplayName

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

พิมพ์ :: String[]
ตำแหน่ง:: ตั้งชื่อ
ค่าเริ่มต้น:: None
ที่จำเป็น:: True
ยอมรับอินพุตไปป์ไลน์:: False
ยอมรับอักขระตัวแทน:: True

-Exclude

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

พิมพ์ :: String[]
ตำแหน่ง:: ตั้งชื่อ
ค่าเริ่มต้น:: None
ที่จำเป็น:: False
ยอมรับอินพุตไปป์ไลน์:: False
ยอมรับอักขระตัวแทน:: True

-Force

บังคับให้คำสั่งทำงานโดยไม่ต้องขอการยืนยันจากผู้ใช้

พิมพ์ :: 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

-PassThru

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

พิมพ์ :: SwitchParameter
ตำแหน่ง:: ตั้งชื่อ
ค่าเริ่มต้น:: None
ที่จำเป็น:: False
ยอมรับอินพุตไปป์ไลน์:: False
ยอมรับอักขระตัวแทน:: False

-WhatIf

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

พิมพ์ :: SwitchParameter
นามแฝง :: wi
ตำแหน่ง:: ตั้งชื่อ
ค่าเริ่มต้น:: False
ที่จำเป็น:: False
ยอมรับอินพุตไปป์ไลน์:: False
ยอมรับอักขระตัวแทน:: False

อินพุต

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

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

สตริง

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

เอาท์พุต

ไม่มี

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