This cmdlet is part of the Vexasoft Cmdlet Library. You can download it now or click here to find out more.



Suspends (hibernates) a local or remote Windows computer.


  • Suspend-Computer [-ComputerName] [-Credential]


Suspend-Computer is used to hibernate a local or remote computer.


  • ComputerName The computer against which to run this cmdlet. You must always specify a computer name to this cmdlet. If you wish to run the cmdlet against the local computer, specify 'localhost' or '.' to this parameter.
  • Credential The credentials under which to run the cmdlet. By default this cmdlet will run as the current user. Using this parameter and the Get-PSCredential cmdlet you can specify an alternate set of credentials under which to execute this command.


Suspend-Computer accepts pipeline input for the ComputerName parameter and requires that the input object contains a property named either Computer, CN or ComputerName.


Suspend-Computer does not output any PowerShell objects.


Suspend-Computer requires that the Remote Registry and RPC services are started on the computer it is trying to access and that DNS services are available to resolve target host names.

Example 1

This command will hibernate the remote computer PC01:

C:\PS>Suspend-Computer -Computer PC01

Example 2

This command will hibernate the local computer:

C:\PS>Suspend-Computer -Computer .