Bagikan melalui

Stop-Service

  • Referensi
Modul:
Microsoft.PowerShell.Management

Menghentikan satu atau beberapa layanan yang sedang berjalan.

Sintaks

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

Deskripsi

Cmdlet ini hanya tersedia di platform Windows.

Stop-Service Cmdlet mengirimkan pesan berhenti ke Pengontrol Layanan Windows untuk setiap layanan yang ditentukan. Anda dapat menentukan layanan dengan nama layanan atau nama tampilannya, atau Anda dapat menggunakan parameter InputObject untuk meneruskan objek layanan yang mewakili layanan yang ingin Anda hentikan.

Contoh

Contoh 1: Menghentikan layanan di komputer lokal

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

Perintah ini menghentikan layanan Log Performa dan Pemberitahuan (SysmonLog) di komputer lokal.

Contoh 2: Hentikan layanan dengan menggunakan nama tampilan

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

Perintah ini menghentikan layanan Telnet di komputer lokal. Perintah menggunakan Get-Service untuk mendapatkan objek yang mewakili layanan Telnet. Operator alur (|) menyalurkan objek ke Stop-Service, yang menghentikan layanan.

Contoh 3: Menghentikan layanan yang memiliki layanan dependen

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

Contoh ini menghentikan layanan IISAdmin di komputer lokal. Karena menghentikan layanan ini juga menghentikan layanan yang bergantung pada layanan IISAdmin, yang terbaik adalah mendahului Stop-Service dengan perintah yang mencantumkan layanan yang bergantung pada layanan IISAdmin.

Perintah pertama mencantumkan layanan yang bergantung pada IISAdmin. Ini menggunakan Get-Service untuk mendapatkan objek yang mewakili layanan IISAdmin. Operator alur (|) meneruskan hasil ke Format-List cmdlet. Perintah menggunakan parameter Properti untuk Format-List hanya mencantumkan properti Nama dan DependentServices layanan.

Perintah kedua menghentikan layanan IISAdmin. Parameter Force diperlukan untuk menghentikan layanan yang memiliki layanan dependen. Perintah menggunakan parameter Konfirmasi untuk meminta konfirmasi dari pengguna sebelum menghentikan setiap layanan.

Parameter

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Alias:cf
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DisplayName

Menentukan nama tampilan layanan yang akan dihentikan. Karakter kartubebas diizinkan.

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard: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.

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:True

-Force

Memaksa cmdlet untuk menghentikan layanan meskipun layanan tersebut memiliki layanan dependen.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Include

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

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:True

-InputObject

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

Jenis:ServiceController[]
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Name

Menentukan nama layanan layanan yang akan dihentikan. Karakter kartubebas diizinkan.

Jenis:String[]
Alias:ServiceName
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:True

-NoWait

Menunjukkan bahwa cmdlet ini menggunakan opsi tanpa tunggu.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-PassThru

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

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-WhatIf

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

Jenis:SwitchParameter
Alias:wi
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard: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.

Catatan

PowerShell menyertakan alias berikut untuk Stop-Service:

  • Windows:
    • spsv

Cmdlet ini hanya tersedia di platform Windows.

Stop-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 .