New-Service

Membuat layanan Windows baru.

Sintaks

New-Service
   [-Name] <String>
   [-BinaryPathName] <String>
   [-DisplayName <String>]
   [-Description <String>]
   [-StartupType <ServiceStartMode>]
   [-Credential <PSCredential>]
   [-DependsOn <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Deskripsi

New-Service Cmdlet membuat entri baru untuk layanan Windows di registri dan di database layanan. Layanan baru memerlukan file yang dapat dieksekusi yang berjalan selama layanan.

Parameter cmdlet ini memungkinkan Anda mengatur nama tampilan, deskripsi, jenis startup, dan dependensi layanan.

Contoh

Contoh 1: Membuat layanan

New-Service -Name "TestService" -BinaryPathName '"C:\WINDOWS\System32\svchost.exe -k netsvcs"'

Perintah ini membuat layanan bernama TestService.

Contoh 2: Membuat layanan yang menyertakan deskripsi, jenis startup, dan nama tampilan

$params = @{
  Name = "TestService"
  BinaryPathName = '"C:\WINDOWS\System32\svchost.exe -k netsvcs"'
  DependsOn = "NetLogon"
  DisplayName = "Test Service"
  StartupType = "Manual"
  Description = "This is a test service."
}
New-Service @params

Perintah ini membuat layanan bernama TestService. Ini menggunakan parameter New-Service untuk menentukan deskripsi, jenis startup, dan nama tampilan untuk layanan baru.

Contoh 3: Menampilkan layanan baru

Get-CimInstance -ClassName Win32_Service -Filter "Name='testservice'"

ExitCode  : 0
Name      : testservice
ProcessId : 0
StartMode : Auto
State     : Stopped
Status    : OK

Perintah ini menggunakan Get-CimInstance untuk mendapatkan objek Win32_Service untuk layanan baru. Objek ini mencakup mode mulai dan deskripsi layanan.

Contoh 4: Menghapus layanan

sc.exe delete TestService
# - or -
(Get-CimInstance -Class Win32_Service -Filter "name='TestService'").delete()

Contoh ini menunjukkan dua cara untuk menghapus layanan TestService. Perintah pertama menggunakan opsi hapus dari Sc.exe. Perintah kedua menggunakan metode Hapus dari objek Win32_Service yang Get-CimInstance kembali.

Parameter

-BinaryPathName

Menentukan jalur file yang dapat dieksekusi untuk layanan. Parameter ini diperlukan.

Jalur yang sepenuhnya memenuhi syarat ke file biner layanan. Jika jalur berisi spasi, jalur harus dikutip sehingga ditafsirkan dengan benar. Misalnya, d:\my share\myservice.exe harus ditentukan sebagai '"d:\my share\myservice.exe"'.

Jalur juga dapat menyertakan argumen untuk layanan mulai otomatis. Contohnya:'"d:\myshare\myservice.exe arg1 arg2"' Argumen ini diteruskan ke titik entri layanan.

Untuk informasi selengkapnya, lihat parameter lpBinaryPathName dari CreateServiceW API.

Type:String
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Menentukan akun yang digunakan oleh layanan sebagai Akun Masuk Layanan.

Ketik nama pengguna, seperti User01 atau Domain01\User01, atau masukkan objek PSCredential , seperti yang dihasilkan oleh Get-Credential cmdlet. Jika Anda mengetik nama pengguna, cmdlet ini akan meminta kata sandi kepada Anda.

Kredensial disimpan dalam objek PSCredential dan kata sandi disimpan sebagai SecureString.

Catatan

Untuk informasi selengkapnya tentang perlindungan data SecureString , lihat Seberapa aman SecureString?.

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DependsOn

Menentukan nama layanan lain tempat layanan baru bergantung. Untuk memasukkan beberapa nama layanan, gunakan koma untuk memisahkan nama.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Description

Menentukan deskripsi layanan.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Menentukan nama tampilan untuk layanan.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

Menentukan nama layanan. Parameter ini diperlukan.

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

-StartupType

Mengatur jenis startup layanan. Nilai yang dapat diterima untuk parameter ini adalah:

  • Otomatis - Layanan dimulai atau dimulai oleh sistem operasi, pada saat start-up sistem. Jika layanan yang dimulai secara otomatis bergantung pada layanan yang dimulai secara manual, layanan yang dimulai secara manual juga dimulai secara otomatis saat startup sistem.
  • Dinonaktifkan - Layanan dinonaktifkan dan tidak dapat dimulai oleh pengguna atau aplikasi.
  • Manual - Layanan hanya dimulai secara manual, oleh pengguna, menggunakan Service Control Manager, atau oleh aplikasi.
  • Boot - Menunjukkan bahwa layanan adalah driver perangkat yang dimulai oleh pemuat sistem. Nilai ini hanya valid untuk driver perangkat.
  • Sistem - Menunjukkan bahwa layanan adalah driver perangkat yang dimulai oleh fungsi 'IOInitSystem()'. Nilai ini hanya valid untuk driver perangkat.

Nilai defaultnya adalah Otomatis.

Type:ServiceStartMode
Accepted values:Boot, System, Automatic, Manual, Disabled
Position:Named
Default value:Automatic
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
Accept pipeline input:False
Accept wildcard characters:False

Input

None

Anda tidak dapat menyalurkan input ke cmdlet ini.

Output

ServiceController

Cmdlet ini mengembalikan objek yang mewakili layanan baru.

Catatan

Untuk menjalankan cmdlet ini, mulai PowerShell dengan menggunakan opsi Jalankan sebagai administrator .

Untuk menghapus layanan, gunakan Sc.exe, atau gunakan Get-CimInstance cmdlet untuk mendapatkan objek Win32_Service yang mewakili layanan lalu gunakan metode Hapus untuk menghapus layanan. Objek yang Get-Service dikembalikan tidak memiliki metode penghapusan.