kelas Win32_BaseService
Kelas WMI abstrak Win32_BaseService mewakili objek yang dapat dieksekusi yang diinstal dalam database registri yang dikelola oleh Service Control Manager. File yang dapat dieksekusi yang terkait dengan layanan dapat dimulai pada waktu boot oleh program boot atau oleh sistem. Ini juga dapat dimulai sesuai permintaan oleh Service Control Manager. Layanan atau proses apa pun yang tidak dimiliki oleh pengguna tertentu, dan yang menyediakan antarmuka untuk beberapa fungsionalitas yang didukung oleh sistem komputer, adalah turunan (atau anggota) dari kelas ini.
Contoh: Layanan klien protokol konfigurasi host dinamis (DHCP) pada sistem komputer yang menjalankan Windows Server.
Sintaks berikut disederhanakan dari kode Managed Object Format (MOF) dan menyertakan semua properti yang diwariskan. Properti tercantum dalam urutan alfabet, bukan urutan MOF.
Sintaks
[SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("DeleteInstance"), Abstract, Provider("CIMWin32"), UUID("{8502C4C4-5FBB-11D2-AAC1-006008C78BC7}"), DisplayName("System Drivers and Services"), AMENDMENT]
class Win32_BaseService : CIM_Service
{
boolean AcceptPause;
boolean AcceptStop;
string Caption;
string CreationClassName;
string Description;
boolean DesktopInteract;
string DisplayName;
string ErrorControl;
uint32 ExitCode;
datetime InstallDate;
string Name;
string PathName;
uint32 ServiceSpecificExitCode;
string ServiceType;
boolean Started;
string StartMode;
string StartName;
string State;
string Status;
string SystemCreationClassName;
string SystemName;
uint32 TagId;
};
Anggota
Kelas Win32_BaseService memiliki jenis anggota ini:
Metode
Kelas Win32_BaseService memiliki metode ini.
| Metode | Deskripsi |
|---|---|
| Perubahan | Memodifikasi layanan. |
| ChangeStartMode | Memodifikasi mode mulai layanan. |
| Buat | Membuat layanan baru. |
| Hapus | Menghapus layanan yang sudah ada. |
| InterrogateService | Meminta agar layanan memperbarui statusnya ke manajer layanan. |
| PauseService | Upaya untuk menempatkan layanan dalam status dijeda. |
| ResumeService | Mencoba menempatkan layanan dalam status dilanjutkan. |
| StartService | Mencoba menempatkan layanan ke status startup-nya. |
| StopService | Metode kelas yang menempatkan layanan dalam status berhenti. |
| UserControlService | Mencoba mengirim kode kontrol yang ditentukan pengguna ke layanan. |
Properti
Kelas Win32_BaseService memiliki properti ini.
-
AcceptPause
-
-
Jenis data: boolean
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32API| Struktur Layanan| SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_PAUSE_CONTINUE"), DisplayName ("Layanan Menerima Jeda")
Layanan dapat dijeda.
-
-
AcceptStop
-
-
Jenis data: boolean
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32API| Struktur Layanan| SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_STOP"), DisplayName ("Layanan Menerima Berhenti")
Layanan dapat dihentikan.
-
-
Keterangan
-
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MaxLen (64), DisplayName ("Keterangan")
Deskripsi singkat objek .
Properti ini diwarisi dari CIM_ManagedSystemElement.
-
-
CreationClassName
-
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: CIM_Key, DisplayName ("Nama Kelas")
Nama kelas konkret pertama yang muncul dalam rantai pewarisan yang digunakan dalam pembuatan instans. Ketika digunakan dengan properti kunci kelas lainnya, properti memungkinkan semua instans kelas ini dan subkelasnya diidentifikasi secara unik.
Properti ini diwarisi dari CIM_Service.
-
-
Deskripsi
-
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: DisplayName ("Deskripsi")
Deskripsi objek .
Properti ini diwarisi dari CIM_ManagedSystemElement.
-
-
DesktopInteract
-
-
Jenis data: boolean
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32API| Struktur Layanan| QUERY_SERVICE_CONFIG|dwServiceType| SERVICE_INTERACTIVE_PROCESS"), DisplayName ("Berinteraksi Dengan Desktop")
Layanan dapat membuat atau berkomunikasi dengan windows di desktop.
-
-
DisplayName
-
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32API| Struktur Layanan| QUERY_SERVICE_CONFIG|lpDisplayName"), DisplayName ("Nama Tampilan")
Nama tampilan layanan. String ini memiliki panjang maksimum 256 karakter. Nama ini dipertahankan huruf besar/kecil di Service Control Manager. Perbandingan DisplayName selalu tidak peka huruf besar/kecil.
Batasan: Menerima nilai yang sama dengan properti Nama .
Contoh: "Atdisk"
-
-
ErrorControl
-
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32API| Struktur Layanan| QUERY_SERVICE_CONFIG|dwErrorControl"), DisplayName ("Tingkat Keparahan Kegagalan Startup")
Tingkat keparahan kesalahan. Layanan gagal dimulai. Nilai menunjukkan tindakan yang diambil oleh program startup jika kegagalan terjadi. Semua kesalahan dicatat oleh sistem komputer.
-
-
Abaikan ("Abaikan")
-
Pengguna tidak diberi tahu.
-
Normal ("Normal")
-
Pengguna diberi tahu.
-
Parah ("Parah")
-
Sistem dimulai ulang dengan konfigurasi terakhir yang diketahui baik.
-
Kritis ("Kritis")
-
Sistem mencoba untuk memulai ulang dengan konfigurasi yang baik.
-
Tidak diketahui ("Tidak Diketahui")
-
Tindakan yang diambil tidak ditentukan.
ExitCode
-
Jenis data: uint32
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32API| Struktur Layanan| SERVICE_STATUS|dwWin32ExitCode"), DisplayName ("Kode Keluar")
Menentukan masalah apa pun yang dihadapi dalam memulai atau menghentikan layanan. Properti ini diatur ke ERROR_SERVICE_SPECIFIC_ERROR (1066) ketika kesalahan unik untuk layanan yang diwakili oleh kelas ini, dan informasi tentang kesalahan tersedia di properti ServiceSpecificExitCode . Layanan menetapkan nilai ini ke NO_ERROR saat berjalan, dan sekali lagi setelah penghentian normal.
InstallDate
-
Jenis data: tanggalwaktu
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Tanggal Penginstalan")
Objek telah diinstal. Properti ini tidak memerlukan nilai untuk menunjukkan bahwa objek diinstal.
Properti ini diwarisi dari CIM_ManagedSystemElement.
Nama
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: Kunci
Pengidentifikasi unik layanan, yang memberikan indikasi fungsionalitas yang dikelola. Fungsionalitas ini dijelaskan secara lebih rinci di properti Deskripsi objek.
Properti ini diwarisi dari CIM_ManagedSystemElement.
PathName
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32API| Struktur Layanan| QUERY_SERVICE_CONFIG|lpBinaryPathName"), DisplayName ("Nama Jalur File")
Jalur yang sepenuhnya memenuhi syarat ke file biner layanan yang mengimplementasikan layanan.
Contoh: "\SystemRoot\System32\drivers\afd.sys"
ServiceSpecificExitCode
-
Jenis data: uint32
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32API| Struktur Layanan| SERVICE_STATUS|dwServiceSpecificExitCode"), DisplayName ("Kode Keluar Khusus Server")
Kode kesalahan khusus layanan untuk kesalahan yang terjadi saat layanan dimulai atau dihentikan. Kode keluar ditentukan oleh layanan yang diwakili oleh kelas ini. Nilai ini hanya diatur ketika nilai ExitCodepropertyERROR_SERVICE_SPECIFIC_ERROR (1066).
ServiceType
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32API| Struktur Layanan| QUERY_SERVICE_CONFIG|dwServiceType"), DisplayName ("Jenis Layanan")
Layanan yang disediakan untuk proses panggilan.
Driver Kernel ("Driver Kernel")
Driver Sistem File ("Driver Sistem File")
Adapter ("Adapter")
Driver Recognizer ("Driver Recognizer")
Proses Sendiri ("Proses Sendiri")
Proses Berbagi ("Proses Berbagi")
Proses Interaktif ("Proses Interaktif")
Dimulai
-
Jenis data: boolean
-
Jenis akses: Baca-saja
-
Kualifikasi: DisplayName ("Started")
Layanan telah dimulai.
Properti ini diwarisi dari CIM_Service.
StartMode
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: Mengambil alih ("StartMode"), DisplayName ("Mode Mulai")
Mode mulai layanan dasar Windows.
Properti ini diwarisi dari CIM_Service.
Boot ("Boot")
Driver perangkat dimulai oleh pemuat sistem operasi (hanya berlaku untuk layanan driver).
Sistem ("Sistem")
Driver perangkat dimulai oleh proses inisialisasi sistem operasi. Nilai ini hanya berlaku untuk layanan driver.
Otomatis ("Otomatis")
Layanan yang akan dimulai secara otomatis oleh manajer kontrol layanan selama memulai sistem.
Manual ("Manual")
Layanan yang akan dimulai oleh manajer kontrol layanan saat proses memanggil metode StartService .
Dinonaktifkan ("Dinonaktifkan")
Layanan yang tidak dapat lagi dimulai.
StartName
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32API| Struktur Layanan| QUERY_SERVICE_CONFIG|lpServiceStartName"), DisplayName ("Nama Akun Awal")
Nama akun tempat layanan berjalan. Bergantung pada jenis layanan, nama akun mungkin dalam bentuk "DomainName\Username" atau format UPN (Username@DomainName). Proses layanan akan dicatat menggunakan salah satu dari dua formulir ini saat berjalan. Jika akun milik domain bawaan, ".\Username" dapat ditentukan. Jika NULL ditentukan, layanan akan masuk sebagai akun LocalSystem. Untuk driver tingkat kernel atau sistem, StartName berisi nama objek driver (yaitu, \FileSystem\Rdr atau \Driver\Xns) yang digunakan sistem input dan output (I/O) untuk memuat driver perangkat. Selain itu, jika NULL ditentukan, driver berjalan dengan nama objek default yang dibuat oleh sistem I/O berdasarkan nama layanan. Contoh: "DWDOM\Admin".
Provinsi
-
Jenis data: string
-
Jenis akses: Baca/tulis
-
Kualifikasi: MappingStrings ("Win32API| Struktur Layanan| SERVICE_STATUS|dwCurrentState "), DisplayName ("State")
Status layanan dasar saat ini.
Dihentikan ("Dihentikan")
Mulai Tertunda ("Mulai Tertunda")
Berhenti Tertunda ("Berhenti Tertunda")
Menjalankan ("Berjalan")
Lanjutkan Tertunda ("Lanjutkan Tertunda")
Jeda Tertunda ("Jeda Tertunda")
Dijeda ("Dijeda")
Tidak diketahui ("Tidak Diketahui")
Windows Server 2008 dan Windows Vista: Properti ini bersifat baca-saja.
Status
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MaxLen (10), DisplayName ("Status")
Status objek saat ini. Berbagai status operasional dan nonoperasional dapat ditentukan. Status operasional meliputi: "OK", "Degraded", dan "Pred Fail" (elemen, seperti hard disk drive berkemampuan SMART, mungkin berfungsi dengan baik tetapi memprediksi kegagalan dalam waktu dekat). Status nonoperational meliputi: "Error", "Starting", "Stopping", dan "Service". Yang terakhir, "Layanan", dapat berlaku selama resilvering cermin disk, memuat ulang daftar izin pengguna, atau pekerjaan administratif lainnya. Tidak semua pekerjaan tersebut online, namun elemen terkelola tidak "OK" atau di salah satu status lainnya.
Properti ini diwarisi dari CIM_ManagedSystemElement.
Nilai yang valid mencakup sebagai berikut:
OK ("OK")
Kesalahan ("Kesalahan")
Terdegradasi ("Terdegradasi")
Tidak diketahui ("Tidak Diketahui")
Pred Fail ("Pred Fail")
Memulai ("Memulai")
Menghentikan ("Berhenti")
Layanan ("Layanan")
Stres ("Stres")
NonRecover ("NonRecover")
Tidak Ada Kontak ("Tidak Ada Kontak")
Lost Comm ("Lost Comm")
SystemCreationClassName
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: Disebarluaskan ("CIM_System. CreationClassName"), CIM_Key, DisplayName ("Nama Kelas Sistem")
Ketik nama sistem yang menghosting layanan ini.
Properti ini diwarisi dari CIM_Service.
SystemName
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: Disebarluaskan ("CIM_System. Nama"), CIM_Key, DisplayName ("Nama Sistem")
Nama sistem yang menghosting layanan ini.
Properti ini diwarisi dari CIM_Service.
TagId
-
Jenis data: uint32
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32API| Struktur Layanan| QUERY_SERVICE_CONFIG|dwTagId"), DisplayName ("Id Tag")
Nilai tag unik untuk layanan ini dalam grup. Nilai 0 (nol) menunjukkan bahwa layanan belum diberi tag. Tag dapat digunakan untuk memesan layanan star tup dalam grup urutan beban dengan menentukan vektor pesanan tag di registri yang terletak di: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\GroupOrderList. Tag hanya dievaluasi untuk layanan jenis mulai Driver Kernel dan Driver Sistem File yang memiliki mode Boot atau System start.
Keterangan
Kelas Win32_BaseService berasal dari CIM_Service.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows Vista |
| Server minimum yang didukung |
Windows Server 2008 |
| Ruang nama |
Root\CIMV2 |
| MOF |
|
| DLL |
|
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk