Bagikan melalui


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 mengidentifikasi layanan dengan nama layanannya.

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 , tidak membuat output apa pun. Operator alur (|) 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 menunjukkan bahwa properti StartMode dari layanan Tlntsvr Dinonaktifkan. Cmdlet 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 . 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

-Include

Menentukan layanan yang dimulai 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. 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 untuk layanan yang akan dimulai.

Nama parameter bersifat opsional. Anda dapat menggunakan Nama atau aliasnya, ServiceName, atau Anda dapat menghilangkan nama parameter.

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-Service dari 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-Service gagal dengan pesan Cannot start service \<service-name\> on computer, gunakan Get-CimInstance untuk menemukan jenis awal layanan dan, jika perlu, gunakan cmdlet Set-Service untuk 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.