Restart-Service

  • Referensi
Modul:
Microsoft.PowerShell.Management

Berhenti lalu memulai satu atau beberapa layanan.

Sintaks

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>]

Deskripsi

Restart-Service Cmdlet 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 mulai 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 Get-Service cmdlet untuk mendapatkan objek yang mewakili layanan yang nama layanannya dimulai dengan net. Operator alur (|) mengirim objek layanan ke Where-Object cmdlet, 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 Menjalankannya.

Parameter

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

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

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-Exclude

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Force

Memaksa perintah untuk dijalankan tanpa meminta konfirmasi pengguna.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Include

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-InputObject

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

Type:ServiceController[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Menentukan nama layanan layanan yang akan dimulai ulang.

Type:String[]
Aliases:ServiceName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

  • Restart-Service dapat mengontrol layanan hanya 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 .