How to restart or shutdown a remote computer with comment from powershell

Question

I have been looking for a way to restart/shutdown a remote computer with comment from powershell.

The traditional Restart-Computer Cmdlet does not have these options. then somewhere they advised to use the native command for shutdown.exe. But this command does not support the use of credentials like powershell does.

The documentation for Restart-Computer indicates that it uses the WMI Win32Shutdown method. You may be able to build upon the similar Win32ShutdownTracker method that does incluse comment and reason. — Damien_The_Unbeliever
– Damien_The_Unbeliever, Commented Sep 3, 2017 at 7:11

Mark Wragg · Accepted Answer · 2017-09-03 09:06:56Z

4

On a related research, I stumbled upon the WMI Class Win32_OperatingSystem which comes with a method Win32ShutdownTracker.

The documentation for the Win32Shutdowntracker() method is available here: https://msdn.microsoft.com/en-us/library/aa394057(v=vs.85).aspx

It takes four parameters as explained below:

Timeout [Integer] in seconds
Comment [String]
Reason Code [Integer] Can be found here: (https://msdn.microsoft.com/en-us/library/windows/desktop/aa376885(v=vs.85).aspx)
Flag [Integer] which will actually perform the function. (Explained in the documentation for win32Shutdowntracker)

So the code to Force Restart a remote machine becomes:

(Get-WmiObject -Class Win32_OperatingSystem -ComputerName $Computer).Win32Shutdowntracker(0, "This is a custom comment", 0x00000000, 6)

Adding Credentials through a PScredential object is now easy:

(Get-WmiObject -Class Win32_OperatingSystem -ComputerName $Computer -Credential $CustomCredentials).Win32Shutdowntracker(0, "This is a custom comment", 0x00000000, 6)

edited Sep 3, 2017 at 9:06

Mark Wragg

23.6k7 gold badges48 silver badges77 bronze badges

answered Sep 3, 2017 at 7:21

Sid

2,6861 gold badge13 silver badges22 bronze badges

Sign up to request clarification or add additional context in comments.

1 Comment

Sid Over a year ago

powershellchronicles.com/2017/09/09/…

Collectives™ on Stack Overflow

How to restart or shutdown a remote computer with comment from powershell

1 Answer 1

1 Comment

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

1 Answer 1

1 Comment

Your Answer

Sign up or log in

Post as a guest

Related