ServiceController Kelas

Definisi

Ruang nama:

System.ServiceProcess

Rakitan:

System.ServiceProcess.ServiceController.dll

Paket:

System.ServiceProcess.ServiceController v11.0.0-preview.2.26159.112

Sumber:

ServiceController.cs

Mewakili layanan Windows dan memungkinkan Anda menyambungkan ke layanan yang sedang berjalan atau berhenti, memanipulasinya, atau mendapatkan informasi tentang layanan tersebut.

public ref class ServiceController : System::ComponentModel::Component

public class ServiceController : System.ComponentModel.Component

type ServiceController = class
    inherit Component

Public Class ServiceController
Inherits Component

Warisan

Object

MarshalByRefObject

Component

ServiceController

Contoh

Contoh berikut menunjukkan penggunaan ServiceController kelas untuk mengontrol SimpleService contoh layanan.

using System;
using System.ServiceProcess;
using System.Diagnostics;
using System.Threading;

namespace ServiceControllerSample
{
    class Program
    {
        public enum SimpleServiceCustomCommands
        { StopWorker = 128, RestartWorker, CheckWorker };
        static void Main(string[] args)
        {
            ServiceController[] scServices;
            scServices = ServiceController.GetServices();

            foreach (ServiceController scTemp in scServices)
            {

                if (scTemp.ServiceName == "Simple Service")
                {
                    // Display properties for the Simple Service sample
                    // from the ServiceBase example.
                    ServiceController sc = new ServiceController("Simple Service");
                    Console.WriteLine("Status = " + sc.Status);
                    Console.WriteLine("Can Pause and Continue = " + sc.CanPauseAndContinue);
                    Console.WriteLine("Can ShutDown = " + sc.CanShutdown);
                    Console.WriteLine("Can Stop = " + sc.CanStop);
                    if (sc.Status == ServiceControllerStatus.Stopped)
                    {
                        sc.Start();
                        while (sc.Status == ServiceControllerStatus.Stopped)
                        {
                            Thread.Sleep(1000);
                            sc.Refresh();
                        }
                    }
                    // Issue custom commands to the service
                    // enum SimpleServiceCustomCommands
                    //    { StopWorker = 128, RestartWorker, CheckWorker };
                    sc.ExecuteCommand((int)SimpleServiceCustomCommands.StopWorker);
                    sc.ExecuteCommand((int)SimpleServiceCustomCommands.RestartWorker);
                    sc.Pause();
                    while (sc.Status != ServiceControllerStatus.Paused)
                    {
                        Thread.Sleep(1000);
                        sc.Refresh();
                    }
                    Console.WriteLine("Status = " + sc.Status);
                    sc.Continue();
                    while (sc.Status == ServiceControllerStatus.Paused)
                    {
                        Thread.Sleep(1000);
                        sc.Refresh();
                    }
                    Console.WriteLine("Status = " + sc.Status);
                    sc.Stop();
                    while (sc.Status != ServiceControllerStatus.Stopped)
                    {
                        Thread.Sleep(1000);
                        sc.Refresh();
                    }
                    Console.WriteLine("Status = " + sc.Status);
                    String[] argArray = new string[] { "ServiceController arg1", "ServiceController arg2" };
                    sc.Start(argArray);
                    while (sc.Status == ServiceControllerStatus.Stopped)
                    {
                        Thread.Sleep(1000);
                        sc.Refresh();
                    }
                    Console.WriteLine("Status = " + sc.Status);
                    // Display the event log entries for the custom commands
                    // and the start arguments.
                    EventLog el = new EventLog("Application");
                    EventLogEntryCollection elec = el.Entries;
                    foreach (EventLogEntry ele in elec)
                    {
                        if (ele.Source.IndexOf("SimpleService.OnCustomCommand") >= 0 |
                            ele.Source.IndexOf("SimpleService.Arguments") >= 0)
                            Console.WriteLine(ele.Message);
                    }
                }
            }
        }
    }
}
// This sample displays the following output if the Simple Service
// sample is running:
//Status = Running
//Can Pause and Continue = True
//Can ShutDown = True
//Can Stop = True
//Status = Paused
//Status = Running
//Status = Stopped
//Status = Running
//4:14:49 PM - Custom command received: 128
//4:14:49 PM - Custom command received: 129
//ServiceController arg1
//ServiceController arg2

Imports System.ServiceProcess
Imports System.Diagnostics
Imports System.Threading



Class Program

    Public Enum SimpleServiceCustomCommands
        StopWorker = 128
        RestartWorker
        CheckWorker
    End Enum 'SimpleServiceCustomCommands

    Shared Sub Main(ByVal args() As String)
        Dim scServices() As ServiceController
        scServices = ServiceController.GetServices()

        Dim scTemp As ServiceController
        For Each scTemp In scServices

            If scTemp.ServiceName = "Simple Service" Then
                ' Display properties for the Simple Service sample 
                ' from the ServiceBase example
                Dim sc As New ServiceController("Simple Service")
                Console.WriteLine("Status = " + sc.Status.ToString())
                Console.WriteLine("Can Pause and Continue = " + _
                    sc.CanPauseAndContinue.ToString())
                Console.WriteLine("Can ShutDown = " + sc.CanShutdown.ToString())
                Console.WriteLine("Can Stop = " + sc.CanStop.ToString())
                If sc.Status = ServiceControllerStatus.Stopped Then
                    sc.Start()
                    While sc.Status = ServiceControllerStatus.Stopped
                        Thread.Sleep(1000)
                        sc.Refresh()
                    End While
                End If
                ' Issue custom commands to the service
                ' enum SimpleServiceCustomCommands 
                '    { StopWorker = 128, RestartWorker, CheckWorker };
                sc.ExecuteCommand(Fix(SimpleServiceCustomCommands.StopWorker))
                sc.ExecuteCommand(Fix(SimpleServiceCustomCommands.RestartWorker))
                sc.Pause()
                While sc.Status <> ServiceControllerStatus.Paused
                    Thread.Sleep(1000)
                    sc.Refresh()
                End While
                Console.WriteLine("Status = " + sc.Status.ToString())
                sc.Continue()
                While sc.Status = ServiceControllerStatus.Paused
                    Thread.Sleep(1000)
                    sc.Refresh()
                End While
                Console.WriteLine("Status = " + sc.Status.ToString())
                sc.Stop()
                While sc.Status <> ServiceControllerStatus.Stopped
                    Thread.Sleep(1000)
                    sc.Refresh()
                End While
                Console.WriteLine("Status = " + sc.Status.ToString())
                Dim argArray() As String = {"ServiceController arg1", "ServiceController arg2"}
                sc.Start(argArray)
                While sc.Status = ServiceControllerStatus.Stopped
                    Thread.Sleep(1000)
                    sc.Refresh()
                End While
                Console.WriteLine("Status = " + sc.Status.ToString())
                ' Display the event log entries for the custom commands
                ' and the start arguments.
                Dim el As New EventLog("Application")
                Dim elec As EventLogEntryCollection = el.Entries
                Dim ele As EventLogEntry
                For Each ele In elec
                    If ele.Source.IndexOf("SimpleService.OnCustomCommand") >= 0 Or ele.Source.IndexOf("SimpleService.Arguments") >= 0 Then
                        Console.WriteLine(ele.Message)
                    End If
                Next ele
            End If
        Next scTemp

    End Sub
End Class
' This sample displays the following output if the Simple Service
' sample is running:
'Status = Running
'Can Pause and Continue = True
'Can ShutDown = True
'Can Stop = True
'Status = Paused
'Status = Running
'Status = Stopped
'Status = Running
'4:14:49 PM - Custom command received: 128
'4:14:49 PM - Custom command received: 129
'ServiceController arg1
'ServiceController arg2

Keterangan

Anda dapat menggunakan ServiceController kelas untuk menyambungkan dan mengontrol perilaku layanan yang ada. Saat Anda membuat instans ServiceController kelas, Anda mengatur propertinya sehingga berinteraksi dengan layanan Windows tertentu. Anda kemudian dapat menggunakan kelas untuk memulai, menghentikan, dan memanipulasi layanan.

Anda kemungkinan besar akan menggunakan ServiceController komponen dalam kapasitas administratif. Misalnya, Anda dapat membuat aplikasi Windows atau Web yang mengirim perintah kustom ke layanan melalui ServiceController instans. Ini akan berguna, karena snap-in Konsol Manajemen Microsoft Service Control Manager (SCM) tidak mendukung perintah kustom.

Setelah membuat instans ServiceController, Anda harus mengatur dua properti di dalamnya untuk mengidentifikasi layanan yang berinteraksi dengannya: nama komputer dan nama layanan yang ingin Anda kontrol.

Nota

Secara default, MachineName diatur ke komputer lokal, jadi Anda tidak perlu mengubahnya kecuali Anda ingin mengatur instans untuk menunjuk ke komputer lain.

Umumnya, penulis layanan menulis kode yang menyesuaikan tindakan yang terkait dengan perintah tertentu. Misalnya, layanan dapat berisi kode untuk merespons ServiceBase.OnPause perintah. Dalam hal ini, pemrosesan kustom untuk Pause tugas berjalan sebelum sistem menjeda layanan.

Set perintah yang dapat diproses layanan tergantung pada propertinya; misalnya, Anda dapat mengatur CanStop properti untuk layanan ke false. Pengaturan ini membuat Stop perintah tidak tersedia pada layanan tertentu; ini mencegah Anda menghentikan layanan dari SCM dengan menonaktifkan tombol yang diperlukan. Jika Anda mencoba menghentikan layanan dari kode Anda, sistem akan menimbulkan kesalahan dan menampilkan pesan kesalahan "Gagal berhenti servicename."

Konstruktor

Nama	Deskripsi
ServiceController()	Menginisialisasi instans ServiceController baru kelas yang tidak terkait dengan layanan tertentu.
ServiceController(String, String)	Menginisialisasi instans ServiceController baru kelas yang terkait dengan layanan yang ada pada komputer yang ditentukan.
ServiceController(String)	Menginisialisasi instans ServiceController baru kelas yang terkait dengan layanan yang ada di komputer lokal.

Properti

Nama	Deskripsi
CanPauseAndContinue	Mendapatkan nilai yang menunjukkan apakah layanan dapat dijeda dan dilanjutkan.
CanShutdown	Mendapatkan nilai yang menunjukkan apakah layanan harus diberi tahu ketika sistem dimatikan.
CanStop	Mendapatkan nilai yang menunjukkan apakah layanan dapat dihentikan setelah dimulai.
DependentServices	Mendapatkan serangkaian layanan yang bergantung pada layanan yang terkait dengan instans ini ServiceController .
DisplayName	Mendapatkan atau menetapkan nama yang mudah diingat untuk layanan.
MachineName	Mendapatkan atau menyetel nama komputer tempat layanan ini berada.
ServiceHandle	Mendapatkan handel untuk layanan.
ServiceName	Mendapatkan atau mengatur nama yang mengidentifikasi layanan yang dirujuk instans ini.
ServicesDependedOn	Kumpulan layanan yang bergantung pada layanan ini.
ServiceType	Mendapatkan jenis layanan yang dirujuk objek ini.
StartType	Mendapatkan nilai yang menunjukkan bagaimana layanan yang diwakili oleh ServiceController objek dimulai.
Status	Mendapatkan status layanan yang dirujuk oleh instans ini.

Metode

Nama	Deskripsi
Close()	Memutuskan sambungan instans ini ServiceController dari layanan dan membebaskan semua sumber daya yang dialokasikan instans.
Continue()	Melanjutkan layanan setelah dijeda.
Dispose(Boolean)	Merilis sumber daya yang tidak dikelola yang ServiceController digunakan oleh dan secara opsional merilis sumber daya terkelola.
ExecuteCommand(Int32)	Menjalankan perintah kustom pada layanan.
GetDevices()	Mengambil layanan pengandar perangkat pada komputer lokal.
GetDevices(String)	Mengambil layanan pengandar perangkat pada komputer yang ditentukan.
GetServices()	Mengambil semua layanan pada komputer lokal, kecuali untuk layanan pengandar perangkat.
GetServices(String)	Mengambil semua layanan pada komputer yang ditentukan, kecuali untuk layanan pengandar perangkat.
Pause()	Menangguhkan operasi layanan.
Refresh()	Merefresh nilai properti dengan mereset properti ke nilainya saat ini.
Start()	Memulai layanan, tidak meneruskan argumen.
Start(String[])	Memulai layanan, meneruskan argumen yang ditentukan.
Stop()	Menghentikan layanan ini dan layanan apa pun yang bergantung pada layanan ini.
Stop(Boolean)	Menghentikan layanan dan secara opsional layanan apa pun yang bergantung pada layanan ini.
WaitForStatus(ServiceControllerStatus, TimeSpan)	Menunggu layanan mencapai status yang ditentukan atau waktu habis yang ditentukan kedaluwarsa.
WaitForStatus(ServiceControllerStatus)	Tak terbatas menunggu layanan mencapai status yang ditentukan.

Lihat juga

• ServiceBase
• ServiceControllerStatus
• ServiceType