Bagikan melalui

Restart-Service

Modul:
Microsoft.PowerShell.Management Module

Berhenti lalu memulai satu atau beberapa layanan.

Sintaks

InputObject (Default) 

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

Default 

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

DisplayName 

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

Deskripsi

Cmdlet ini hanya tersedia di platform Windows.

Cmdlet Restart-Service mengirim pesan berhenti lalu pesan mulai ke Pengontrol Layanan Windows untuk layanan tertentu. Jika layanan sudah dihentikan, layanan dimulai tanpa memberi tahu Anda tentang kesalahan. Anda dapat menentukan layanan dengan nama layanan atau nama tampilannya, atau Anda dapat menggunakan parameter InputObject untuk meneruskan objek yang mewakili setiap layanan yang ingin Anda hidupkan ulang.

Contoh

Contoh 1: Memulai ulang layanan di komputer lokal

PS C:\> Restart-Service -Name winmgmt

Perintah ini memulai ulang layanan Instrumentasi Manajemen Windows (WinMgmt) pada komputer lokal.

Contoh 2: Mengecualikan layanan

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

Perintah ini memulai ulang layanan yang memiliki nama tampilan yang dimulai dengan Net, kecuali untuk layanan Net Logon.

Contoh 3: Mulai semua layanan jaringan yang dihentikan

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

Perintah ini memulai semua layanan jaringan yang dihentikan pada komputer.

Perintah ini menggunakan cmdlet Get-Service untuk mendapatkan objek yang mewakili layanan yang nama layanannya dimulai dengan net. Operator alur (|) mengirim objek layanan ke cmdlet Where-Object, yang hanya memilih layanan yang memiliki status dihentikan. Operator alur lain mengirimkan layanan yang dipilih ke Restart-Service.

Dalam praktiknya, Anda akan menggunakan parameter WhatIf untuk menentukan efek perintah sebelum Anda menjalankannya.

Parameter

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:Cf

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-DisplayName

Menentukan nama tampilan layanan yang akan dimulai ulang. Karakter pengganti diizinkan.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:True
DontShow:False

Set parameter

DisplayName
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Exclude

Menentukan layanan yang dihilangkan cmdlet ini. Nilai parameter ini memenuhi syarat parameter Nama . Masukkan elemen atau pola nama, seperti s*. Karakter pengganti diizinkan.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:True
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Force

Memaksa perintah untuk dijalankan tanpa meminta konfirmasi pengguna.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Include

Menentukan layanan yang dimulai ulang cmdlet ini. Nilai parameter ini memenuhi syarat parameter Nama . Masukkan elemen atau pola nama, seperti s*. Karakter pengganti diizinkan.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:True
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-InputObject

Menentukan objek ServiceController yang mewakili layanan yang akan dimulai ulang. Masukkan variabel yang berisi objek, atau ketik perintah atau ekspresi yang mendapatkan objek.

Properti parameter

Jenis:

ServiceController[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

InputObject
Position:0
Wajib:True
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Name

Menentukan nama layanan layanan yang akan dimulai ulang.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:True
DontShow:False
Alias:Nama Layanan

Set parameter

Default
Position:0
Wajib:True
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-PassThru

Mengembalikan objek yang mewakili layanan. Secara default, cmdlet ini tidak menghasilkan output apa pun.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:wi

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

ServiceController

Anda dapat menyalurkan objek layanan ke cmdlet ini.

String

Anda dapat menyalurkan string yang berisi nama layanan ke cmdlet ini.

Output

None

Secara default, cmdlet ini tidak mengembalikan output.

ServiceController

Saat Anda menggunakan parameter PassThru, cmdlet ini mengembalikan objek ServiceController yang mewakili layanan yang dimulai ulang.

Catatan

Cmdlet ini hanya tersedia di platform Windows.

  • Restart-Service hanya dapat mengontrol layanan ketika pengguna saat ini memiliki izin untuk melakukan ini. Jika perintah tidak berfungsi dengan benar, Anda mungkin tidak memiliki izin yang diperlukan.
  • Untuk menemukan nama layanan dan nama tampilan layanan pada sistem Anda, ketik Get-Service". Nama layanan muncul di kolom Nama, dan nama tampilan muncul di kolom DisplayName.