Win32_OperatingSystem 類別的 Win32Shutdown 方法

  • 發行項

Win32ShutdownWMI 類別方法提供 Win32 操作系統支援的一組完整關機選項。 其中包括註銷、關機、重新啟動，以及強制註銷、關機或重新啟動。

本主題使用Managed物件格式 （MOF） 語法。 如需使用此方法的詳細資訊，請參閱 呼叫方法。

語法

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

參數

旗標 [in]

要關閉電腦的點陣圖旗標集。 若要強制命令，請將 Force 旗標 （4） 新增至命令值。 使用 Force 搭配遠端電腦上的關機或重新啟動會立即關閉所有專案（包括 WMI、COM 等等），或重新啟動遠端電腦。 這會導致不確定的傳回值。

0 （0x0）

註銷 - 將使用者註銷計算機。 註銷會停止與呼叫exit函式之進程安全性內容相關聯的所有進程、將目前使用者註銷系統，並顯示登入對話方塊。

4 （0x4）

強制註銷 （0 + 4） - 立即將使用者註銷計算機，而不會通知應用程式登入會話即將結束。 這可能會導致數據遺失。

1 （0x1）

關機 - 將電腦關機至安全關閉電源的點。 （所有檔案緩衝區都會排清到磁碟，並停止所有執行中的進程。使用者會看到訊息， It is now safe to turn off your computer.

在關機期間，系統會將訊息傳送給每個執行中的應用程式。 應用程式會在處理訊息時執行任何清除，並傳回 True，表示它們可以終止。

5 （0x5）

強制關機 （1 + 4） - 將電腦關機至安全關閉電源的點。 （所有檔案緩衝區都會排清到磁碟，並停止所有執行中的進程。使用者會看到訊息， It is now safe to turn off your computer.

使用強制關機方法時，所有服務，包括 WMI，都會立即關閉。 因此，如果您要對遠端電腦執行腳本，您將無法接收傳回值。

2 （0x2）

重新啟動 - 關機，然後重新啟動計算機。

6 （0x6）

強制重新啟動 （2 + 4） - 關閉，然後重新啟動電腦。

使用強制重新啟動方法時，所有服務，包括 WMI，都會立即關閉。 因此，如果您要對遠端電腦執行腳本，您將無法接收傳回值。

8 （0x8）

電源關閉 - 關閉電腦並關閉電源（如果有問題的電腦支援）。

12 （0xC）

強制關閉電源 （8 + 4） - 關閉電腦並關閉電源（如果受問題的電腦支援）。

使用強制關閉電源方法時，所有服務，包括 WMI，都會立即關閉。 因此，如果您要對遠端電腦執行腳本，您將無法接收傳回值。

保留 [in]

擴充 Win32Shutdown 的方法。 目前會 忽略 Reserved 參數。

傳回值

傳回零 （0） 表示成功。 任何其他數位都表示錯誤。 如需錯誤碼，請參閱 WMI 錯誤常數或 WbemErrorEnum。 如需一般 HRESULT 值，請參閱 系統錯誤碼。

成功 （0）

其他 （1–4294967295）

備註

若要更有效率地管理組織中的計算機，系統管理員需要能夠從遠端關閉或重新啟動計算機，或從遠端註銷使用者。 執行這些工作的能力可讓系統管理員安裝軟體、重新設定電腦設定、從網路移除計算機，以及執行其他工作，而不需要手動關閉或重新啟動每部計算機。

例如，若要執行網路升級，您可能需要關閉在特定網路區段上執行的所有計算機。 若要強制組策略升級，您必須將用戶註銷其計算機。 如果組織中的任何地方都存在計算機病毒，您可能想要在病毒有機會傳播之前，盡可能關閉盡可能多的計算機。 關閉和重新啟動計算機，並以程式設計方式註銷使用者的能力，而不是手動註銷，可能是一個巨大的節省時間。

呼叫進程必須具有 SE_SHUTDOWN_NAME 許可權。

Win32ShutdownTracker 方法在 Win32_OperatingSystem 中提供 Win32Shutdown 方法支援的相同關機選項集，但也可讓您指定批注、關機原因或逾時。

Win32Shutdown 方法沒有鎖定工作站的參數，讓使用者登入。 不過，您可以使用下列命令，從命令行鎖定工作站：

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

範例

下列 PowerShell 範例會使用 Win32Shutdown 方法來關閉指定的電腦。

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

下列 PowerShell 程式代碼範例會使用 get-wmiobject Cmdlet 中的 EnableAllPrivileges 來達到適當的許可權。

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

下列 VB.NET 範例程式代碼會使用 Shutdown 方法來重新啟動或註銷系統。

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

需求

需求 值
最低支援的用戶端
 Windows Vista
最低支援的伺服器
 Windows Server 2008
Namespace
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

另請參閱

作業系統類別

Win32_OperatingSystem

Win32ShutdownTracker

WMI 工作：桌面管理

使用 VBScript 執行特殊許可權作業