Start-Service
Memulai satu atau beberapa layanan yang dihentikan.
Sintaks
InputObject (Default)
Start-Service
[-InputObject] <ServiceController[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Start-Service
[-Name] <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DisplayName
Start-Service
-DisplayName <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
Cmdlet ini hanya tersedia di platform Windows.
Cmdlet Start-Service mengirim pesan awal ke Pengontrol Layanan Windows untuk setiap layanan yang ditentukan. Jika layanan sudah berjalan, pesan diabaikan tanpa kesalahan. Anda dapat menentukan layanan dengan nama layanan atau nama tampilannya, atau Anda dapat menggunakan parameter InputObject untuk menyediakan objek layanan yang mewakili layanan yang ingin Anda mulai.
Contoh
Contoh 1: Memulai layanan dengan menggunakan namanya
Contoh ini memulai layanan EventLog di komputer lokal. Parameter Nama
Start-Service -Name "eventlog"
Contoh 2: Menampilkan informasi tanpa memulai layanan
Contoh ini menunjukkan apa yang akan terjadi jika Anda memulai layanan yang memiliki nama tampilan yang menyertakan "jarak jauh".
Start-Service -DisplayName *remote* -WhatIf
Parameter DisplayName mengidentifikasi layanan dengan nama tampilannya, bukan nama layanannya. Parameter WhatIf menyebabkan cmdlet menampilkan apa yang akan terjadi saat Anda menjalankan perintah tetapi tidak membuat perubahan.
Contoh 3: Memulai layanan dan merekam tindakan dalam file teks
Contoh ini memulai layanan Instrumentasi Manajemen Windows (WMI) di komputer dan menambahkan catatan tindakan ke file services.txt.
$s = Get-Service wmi
Start-Service -InputObject $s -PassThru | Format-List >> services.txt
Pertama, kita menggunakan Get-Service untuk mendapatkan objek yang mewakili layanan WMI dan menyimpannya dalam variabel $s. Selanjutnya, kita memulai layanan. Tanpa parameter PassThru |) meneruskan output objek dengan Start-Service ke cmdlet Format-List untuk memformat objek sebagai daftar propertinya. Operator pengalihan tambahan (>>) mengalihkan output ke file services.txt. Output ditambahkan ke akhir file yang ada.
Contoh 4: Memulai layanan yang dinonaktifkan
Contoh ini menunjukkan cara memulai layanan saat jenis mulai layanan Dinonaktifkan.
PS> Start-Service tlntsvr
Start-Service : Service 'Telnet (TlntSvr)' cannot be started due to the following error: Cannot
start service TlntSvr on computer '.'.
At line:1 char:14
+ Start-Service <<<< tlntsvr
PS> Get-CimInstance Win32_Service | Where-Object Name -EQ "tlntsvr"
ExitCode : 0
Name : TlntSvr
ProcessId : 0
StartMode : Disabled
State : Stopped
Status : OK
PS> Set-Service tlntsvr -StartupType manual
PS> Start-Service tlntsvr
Upaya pertama untuk memulai layanan Telnet (tlntsvr) gagal. Perintah Set-Service mengubah jenis mulai menjadi Manual. Sekarang, kita dapat mengirim ulang perintah Start-Service. Kali ini, perintah berhasil. Untuk memverifikasi bahwa perintah berhasil, jalankan Get-Service.
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. 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 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 |
-Include
Menentukan layanan yang dimulai cmdlet ini. Nilai parameter ini memenuhi syarat parameter Nama 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. Masukkan variabel yang berisi objek, atau ketik perintah atau ekspresi yang mendapatkan objek.
Properti parameter
| Jenis: | |
| 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 untuk layanan yang akan dimulai.
Nama parameter bersifat opsional. Anda dapat menggunakan Nama
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| 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.
Catatan
PowerShell menyertakan alias berikut untuk Start-Service:
- Windows:
sasv
Cmdlet ini hanya tersedia di platform Windows.
- Secara default, hanya anggota grup Administrator yang dapat memulai, menghentikan, menjeda, melanjutkan, atau memulai ulang layanan. Jika Anda adalah anggota grup Administrator, Anda perlu menjalankan
Start-Servicedari sesi PowerShell yang ditinggikan. Gunakan opsi Jalankan sebagai Administrator untuk memulai PowerShell. - 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. - Anda hanya dapat memulai layanan yang memiliki jenis mulai Manual, Otomatis, atau Otomatis (Mulai Tertunda). Anda tidak dapat memulai layanan yang memiliki tipe awal Dinonaktifkan. Jika perintah
Start-Servicegagal dengan pesanCannot start service \<service-name\> on computer, gunakanGet-CimInstanceuntuk menemukan jenis awal layanan dan, jika perlu, gunakan cmdletSet-Serviceuntuk mengubah jenis mulai layanan. - Beberapa layanan, seperti Log Performa dan Pemberitahuan (SysmonLog) berhenti secara otomatis jika mereka tidak memiliki pekerjaan yang harus dilakukan. Ketika PowerShell memulai layanan yang segera menghentikan dirinya sendiri, powerShell akan menampilkan pesan berikut:
Service \<display-name\> start failed.