Start-Service

  • Referensi
Modul:
Microsoft.PowerShell.Management

Memulai satu atau beberapa layanan yang dihentikan.

Sintaks

Start-Service
     [-InputObject] <ServiceController[]>
     [-PassThru]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-Service
     [-Name] <String[]>
     [-PassThru]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-Service
     [-PassThru]
     -DisplayName <String[]>
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Deskripsi

Start-Service Cmdlet mengirimkan 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 gunakan Get-Service untuk mendapatkan objek yang mewakili layanan WMI dan menyimpannya dalam $s variabel. Selanjutnya, kita memulai layanan. Tanpa parameter PassThru, Start-Service tidak membuat output apa pun. Operator alur (|) meneruskan output objek ke Start-ServiceFormat-List cmdlet 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 awal 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 Get-CimInstance menunjukkan bahwa properti StartMode dari layanan Tlntsvr dinonaktifkan. Set-Service Cmdlet mengubah jenis mulai menjadi Manual. Sekarang, kita dapat mengirim Start-Service ulang perintah. Kali ini, perintah berhasil. Untuk memverifikasi bahwa perintah berhasil, jalankan Get-Service.

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

-Include

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

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

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

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

Catatan

Windows PowerShell menyertakan alias berikut untuk Start-Service:

  • sasv

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

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