Metode Win32Shutdown dari kelas Win32_OperatingSystem

Artikel
11/10/2023

Metode kelas Win32ShutdownWMI menyediakan serangkaian opsi matikan lengkap yang didukung oleh sistem operasi Win32. Ini termasuk keluar, mematikan, me-reboot, dan memaksa keluar, mematikan, atau me-reboot.

Topik ini menggunakan sintaksIs Managed Object Format (MOF). Untuk informasi selengkapnya tentang menggunakan metode ini, lihat Memanggil Metode.

Sintaks

uint32 Win32Shutdown(
  [in] sint32 Flags,
  [in] sint32 Reserved = 
);

Parameter

Bendera [in]

Set bendera bitmapped untuk mematikan komputer. Untuk memaksa perintah, tambahkan bendera Paksa (4) ke nilai perintah. Menggunakan Paksa bersama dengan Matikan atau Reboot pada komputer jarak jauh segera mematikan semuanya (termasuk WMI, COM, dan sebagainya), atau me-reboot komputer jarak jauh. Ini menghasilkan nilai pengembalian yang tidak ditentukan.

0 (0x0)

Log Keluar - Mencatat pengguna dari komputer. Pengelogan menghentikan semua proses yang terkait dengan konteks keamanan proses yang memanggil fungsi keluar, mencatat pengguna saat ini dari sistem, dan menampilkan kotak dialog masuk.

4 (0x4)

Log Keluar Paksa (0 + 4) - Segera mencatat pengguna dari komputer dan tidak memberi tahu aplikasi bahwa sesi masuk berakhir. Ini dapat mengakibatkan hilangnya data.

1 (0x1)

Matikan - Mematikan komputer ke titik di mana ia aman untuk mematikan daya. (Semua buffer file dibersihkan ke disk, dan semua proses yang berjalan dihentikan.) Pengguna melihat pesan, It is now safe to turn off your computer.

Selama mematikan sistem mengirim pesan ke setiap aplikasi yang sedang berjalan. Aplikasi melakukan pembersihan saat memproses pesan dan mengembalikan True untuk menunjukkan bahwa mereka dapat dihentikan.

5 (0x5)

Matikan Paksa (1 + 4) - Mematikan komputer ke titik di mana ia aman untuk mematikan daya. (Semua buffer file dibersihkan ke disk, dan semua proses yang berjalan dihentikan.) Pengguna melihat pesan, It is now safe to turn off your computer.

Ketika pendekatan matikan paksa digunakan, semua layanan, termasuk WMI, segera dimatikan. Karena itu, Anda tidak akan dapat menerima nilai pengembalian jika Anda menjalankan skrip terhadap komputer jarak jauh.

2 (0x2)

Reboot - Matikan lalu mulai ulang komputer.

6 (0x6)

Reboot Paksa (2 + 4) - Matikan lalu mulai ulang komputer.

Ketika pendekatan boot ulang paksa digunakan, semua layanan, termasuk WMI, segera dimatikan. Karena itu, Anda tidak akan dapat menerima nilai pengembalian jika Anda menjalankan skrip terhadap komputer jarak jauh.

8 (0x8)

Matikan - Mematikan komputer dan mematikan daya (jika didukung oleh komputer yang bersangkutan).

12 (0xC)

Daya Mati Paksa (8 + 4) - Mematikan komputer dan mematikan daya (jika didukung oleh komputer yang bersangkutan).

Ketika pendekatan pemadaman paksa digunakan, semua layanan, termasuk WMI, segera dimatikan. Karena itu, Anda tidak akan dapat menerima nilai pengembalian jika Anda menjalankan skrip terhadap komputer jarak jauh.

Dicadangkan [dalam]

Sarana untuk memperpanjang Win32Shutdown. Saat ini, parameter Cadangan diabaikan.

Nilai hasil

Mengembalikan nol (0) untuk menunjukkan keberhasilan. Angka lain menunjukkan kesalahan. Untuk kode kesalahan, lihat Konstanta Kesalahan WMI atau WbemErrorEnum. Untuk nilai HRESULT umum, lihat Kode Kesalahan Sistem.

Sukses (0)
Lainnya (1–4294967295)

Keterangan

Untuk manajemen komputer yang lebih efisien dalam organisasi, administrator memerlukan kemampuan untuk mematikan atau memulai ulang komputer dari jarak jauh, atau untuk keluar dari jarak jauh pengguna. Kemampuan untuk melakukan tugas-tugas ini memungkinkan administrator menginstal perangkat lunak, mengonfigurasi ulang pengaturan komputer, menghapus komputer dari jaringan, dan melakukan tugas lain tanpa harus mematikan atau memulai ulang setiap komputer secara manual.

Misalnya, untuk melakukan peningkatan jaringan, Anda mungkin perlu mematikan semua komputer yang berjalan pada segmen jaringan tertentu. Untuk memaksa peningkatan Kebijakan Grup, Anda perlu mencatat pengguna dari komputer mereka. Jika virus komputer ada di mana saja di organisasi Anda, Anda mungkin ingin mematikan komputer sebanyak mungkin, sebelum virus memiliki kesempatan untuk menyebar. Kemampuan untuk mematikan dan menghidupkan ulang komputer dan untuk log keluar pengguna secara terprogram alih-alih secara manual dapat menjadi penghemat waktu yang sangat besar.

Proses panggilan harus memiliki hak istimewa SE_SHUTDOWN_NAME .

Metode Win32ShutdownTracker menyediakan serangkaian opsi matikan yang sama yang didukung oleh metode Win32Shutdown di Win32_OperatingSystem tetapi juga memungkinkan Anda menentukan komentar, alasan penonaktifan, atau batas waktu.

Metode Win32Shutdown tidak memiliki parameter untuk mengunci stasiun kerja, membiarkan pengguna masuk. Namun, stasiun kerja dapat dikunci dari baris perintah dengan menggunakan perintah berikut:

% windir %\System32\rundll32.exe user32.dll,LockWorkStation

Contoh

Contoh PowerShell berikut menggunakan metode Win32Shutdown untuk mematikan komputer yang ditentukan.

$computername= "."
$win32OS = get-wmiobject win32_operatingsystem -computername $computername
$win32OS.psbase.Scope.Options.EnablePrivileges = $true
$win32OS.win32shutdown(8)

Sampel kode PowerShell berikut menggunakan cmdlet EnableAllPrivileges dari get-wmiobject untuk mencapai hak istimewa yang tepat.

$win32OS = get-wmiobject win32_operatingsystem -computername $computername -EnableAllPrivileges
$win32OS.win32shutdown(8)

Kode sampel VB.NET berikut menggunakan metode Matikan untuk me-reboot atau keluar dari sistem.

Dim

testResult AsSingle

Dim WMIServiceObject, ComputerObject AsObject 

'Now get some privileges 

WMIServiceObject = GetObject(
"Winmgmts:{impersonationLevel=impersonate,(Debug,Shutdown)}")
ForEach ComputerObject In WMIServiceObject.InstancesOf("Win32_OperatingSystem") 
    testResult = ComputerObject.Win32Shutdown(2 + 4, 0) 
    'reboot
    'testResult = ComputerObject.Win32Shutdown(0, 0) 'logoff 
    ' testResult = ComputerObject.Win32Shutdown(8 + 4, 0) 'shutdown 

If testResult <> 0 Then 

MsgBox("Sorry, an error has occurred while trying to perform selected operation") 

Else 

'Operation selected in statement above if condition would be carried out 

EndIf 

Next

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Ruang nama	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll