Set-Service

  • Referensi
Modul:
Microsoft.PowerShell.Management

Memulai, menghentikan, dan menangguhkan layanan, dan mengubah propertinya.

Sintaks

Set-Service
   [-ComputerName <String[]>]
   [-Name] <String>
   [-DisplayName <String>]
   [-Description <String>]
   [-StartupType <ServiceStartMode>]
   [-Status <String>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Service
   [-ComputerName <String[]>]
   [-DisplayName <String>]
   [-Description <String>]
   [-StartupType <ServiceStartMode>]
   [-Status <String>]
   [-InputObject <ServiceController>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Deskripsi

Set-Service Cmdlet mengubah properti layanan seperti Status, Deskripsi, DisplayName, dan StartupType. Set-Service dapat memulai, menghentikan, menangguhkan, atau menjeda layanan. Untuk mengidentifikasi layanan, masukkan nama layanannya atau kirim objek layanan. Atau, kirim nama layanan atau objek layanan ke alur ke Set-Service.

Contoh

Contoh 1: Mengubah nama tampilan

Dalam contoh ini, nama tampilan layanan diubah. Untuk melihat nama tampilan asli, gunakan Get-Service.

Set-Service -Name LanmanWorkstation -DisplayName "LanMan Workstation"

Set-Servicemenggunakan parameter Nama untuk menentukan nama layanan, LanmanWorkstation. Parameter DisplayName menentukan nama tampilan baru, LanMan Workstation.

Contoh 2: Mengubah jenis layanan startup

Contoh ini menunjukkan cara mengubah jenis startup layanan.

Set-Service -Name BITS -StartupType Automatic
Get-Service BITS | Select-Object -Property Name, StartType, Status

Name  StartType   Status
----  ---------   ------
BITS  Automatic  Running

Set-Servicemenggunakan parameter Nama untuk menentukan nama layanan, BITS. Parameter StartupType mengatur layanan ke Otomatis.

Get-Servicemenggunakan parameter Nama untuk menentukan layanan BITS dan mengirim objek ke bawah alur. Select-Objectmenggunakan parameter Properti untuk menampilkan status layanan BITS.

Contoh 3: Mengubah deskripsi layanan

Contoh ini mengubah deskripsi layanan BITS dan menampilkan hasilnya.

Get-CimInstance Cmdlet digunakan karena mengembalikan objek Win32_Service yang menyertakan Deskripsi layanan.

Get-CimInstance Win32_Service -Filter 'Name = "BITS"'  | Format-List  Name, Description

Name        : BITS
Description : Transfers files in the background using idle network bandwidth. If the service is
              disabled, then any applications that depend on BITS, such as Windows Update or MSN
              Explorer, will be unable to automatically download programs and other information.

Set-Service -Name BITS -Description "Transfers files in the background using idle network bandwidth."
Get-CimInstance Win32_Service -Filter 'Name = "BITS"' | Format-List  Name, Description

Name        : BITS
Description : Transfers files in the background using idle network bandwidth.

Get-CimInstance mengirim objek ke alur Format-List dan menampilkan nama dan deskripsi layanan. Untuk tujuan perbandingan, perintah dijalankan sebelum dan sesudah deskripsi diperbarui.

Set-Servicemenggunakan parameter Nama untuk menentukan layanan BITS. Parameter Deskripsi menentukan teks yang diperbarui untuk deskripsi layanan.

Contoh 4: Memulai layanan

Dalam contoh ini, layanan dimulai.

Set-Service -Name WinRM -Status Running -PassThru

Status   Name               DisplayName
------   ----               -----------
Running  WinRM              Windows Remote Management (WS-Manag...

Set-Servicemenggunakan parameter Nama untuk menentukan layanan, WinRM. Parameter Status menggunakan nilai Berjalan untuk memulai layanan. Parameter PassThru menghasilkan objek ServiceController yang menampilkan hasilnya.

Contoh 5: Menangguhkan layanan

Contoh ini menggunakan alur untuk menjeda layanan.

Get-Service -Name Schedule | Set-Service -Status Paused

Get-Servicemenggunakan parameter Nama untuk menentukan layanan Jadwal, dan mengirim objek ke bawah alur. Set-Servicemenggunakan parameter Status untuk mengatur layanan ke Dijeda.

Contoh 6: Menghentikan layanan

Contoh ini menggunakan variabel untuk menghentikan layanan.

$S = Get-Service -Name Schedule
Set-Service -InputObject $S -Status Stopped

Get-Servicemenggunakan parameter Nama untuk menentukan layanan, Jadwal. Objek disimpan dalam variabel , $S. Set-Servicemenggunakan parameter InputObject dan menentukan objek yang disimpan $S. Parameter Status mengatur layanan ke Dihentikan.

Contoh 7: Mengatur jenis startup untuk beberapa layanan

Set-Service Cmdlet hanya menerima satu nama layanan pada satu waktu. Namun, Anda dapat menyalurkan beberapa layanan untuk Set-Service mengubah konfigurasi beberapa layanan.

Get-Service SQLWriter,spooler |
    Set-Service -StartupType Automatic -PassThru |
    Select-Object Name, StartType

Name      StartType
----      ---------
spooler   Automatic
SQLWriter Automatic

Parameter

-ComputerName

Menentukan satu atau beberapa komputer. Untuk komputer jarak jauh, ketik nama NetBIOS, alamat IP, atau nama domain yang sepenuhnya memenuhi syarat. Jika parameter ComputerName tidak ditentukan, perintah berjalan di komputer lokal.

Parameter ini tidak bergantung pada remoting PowerShell. Anda dapat menggunakan parameter ComputerName meskipun komputer Anda tidak dikonfigurasi untuk menjalankan perintah jarak jauh.

Type:String[]
Aliases:cn
Position:Named
Default value:Local computer
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Meminta konfirmasi sebelum menjalankan Set-Service.

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

-Description

Menentukan deskripsi baru untuk layanan.

Deskripsi layanan muncul di Manajemen Komputer, Layanan. Deskripsi bukan properti objek Get-ServiceServiceController. Untuk melihat deskripsi layanan, gunakan Get-CimInstance yang mengembalikan objek Win32_Service yang mewakili layanan.

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

-DisplayName

Menentukan nama tampilan baru untuk layanan.

Catatan

Biasanya, Set-Service hanya beroperasi pada layanan Windows dan bukan driver. Namun, jika Anda menentukan nama driver, Set-Service dapat menargetkan driver.

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

-InputObject

Menentukan objek ServiceController yang mewakili layanan yang akan diubah. Masukkan variabel yang berisi objek, atau ketik perintah atau ekspresi yang mendapatkan objek, seperti Get-Service perintah. Anda dapat menggunakan alur untuk mengirim objek layanan ke Set-Service.

Type:ServiceController
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Menentukan nama layanan layanan yang akan diubah. Karakter kartubebas tidak diizinkan. Anda dapat menggunakan alur untuk mengirim nama layanan ke Set-Service.

Catatan

Biasanya, Set-Service hanya beroperasi pada layanan Windows dan bukan driver. Namun, jika Anda menentukan nama driver, Set-Service dapat menargetkan driver.

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

-PassThru

Mengembalikan objek ServiceController yang mewakili layanan yang diubah. Secara default, Set-Service tidak menghasilkan output apa pun.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
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 start-up sistem. Jika layanan yang dimulai secara otomatis tergantung 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 berlaku untuk driver perangkat.
  • Sistem - Menunjukkan bahwa layanan adalah driver perangkat yang dimulai oleh fungsi 'IOInitSystem()'. Nilai ini hanya berlaku untuk driver perangkat.

Nilai defaultnya adalah Otomatis.

Type:ServiceStartMode
Aliases:StartMode, SM, ST
Accepted values:Boot, System, Automatic, Manual, Disabled
Position:Named
Default value:Automatic
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Status

Menentukan status untuk layanan.

Nilai yang dapat diterima untuk parameter ini adalah sebagai berikut:

  • Dijeda. Menangguhkan layanan.
  • Berjalan. Memulai layanan.
  • Dihentikan. Menghentikan layanan.
Type:String
Accepted values:Paused, Running, Stopped
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Menunjukkan apa yang akan terjadi jika Set-Service 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 .

Catatan

Set-Service memerlukan izin yang ditingkatkan. Gunakan opsi Jalankan sebagai administrator.

Set-Service hanya dapat mengontrol layanan ketika pengguna saat ini memiliki izin untuk mengelola layanan. Jika perintah tidak berfungsi dengan benar, Anda mungkin tidak memiliki izin yang diperlukan.

Untuk menemukan nama layanan atau nama tampilan layanan, gunakan Get-Service. Nama layanan berada di kolom Nama dan nama tampilan berada di kolom DisplayName .