Stop-Service
Menghentikan satu atau beberapa layanan yang sedang berjalan.
Sintaks
InputObject (Default)
Stop-Service
[-InputObject] <ServiceController[]>
[-Force]
[-NoWait]
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Stop-Service
[-Name] <String[]>
[-Force]
[-NoWait]
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DisplayName
Stop-Service
-DisplayName <String[]>
[-Force]
[-NoWait]
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
Cmdlet ini hanya tersedia di platform Windows.
Cmdlet Stop-Service mengirim 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
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 cmdlet Format-List. Perintah menggunakan parameter Properti dari Format-List untuk mencantumkan hanya Nama dan DependentServices properti 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 konfirmasi sebelum menjalankan cmdlet.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | Cf |
Kumpulan 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 dihentikan. Karakter pengganti diizinkan.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | True |
| DontShow: | False |
Kumpulan 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
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | True |
| DontShow: | False |
Kumpulan 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 cmdlet untuk menghentikan layanan meskipun layanan tersebut memiliki layanan dependen.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan 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 dihentikan cmdlet ini. Nilai parameter ini memenuhi syarat parameter Nama
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | True |
| DontShow: | False |
Kumpulan 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 dihentikan. Masukkan variabel yang berisi objek, atau ketik perintah atau ekspresi yang mendapatkan objek.
Properti parameter
| Jenis: | |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan 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 dihentikan. Karakter pengganti diizinkan.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | True |
| DontShow: | False |
| Alias: | Nama Layanan |
Kumpulan parameter
Default
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-NoWait
Menunjukkan bahwa cmdlet ini menggunakan opsi tanpa tunggu.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| 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 |
Kumpulan 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 |
Kumpulan 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.
Catatan
PowerShell menyertakan alias berikut untuk Stop-Service:
- Windows:
spsv
Cmdlet ini hanya tersedia di platform Windows.
Stop-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
Dimulai di PowerShell 6.0, perintah tidak lagi menyertakan parameter ComputerName . Untuk menggunakan perintah ini pada komputer jarak jauh, gunakan untuk menargetkan Invoke-Command sistem jarak jauh.