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

Suspend-Computer

Synopsis

Suspends (hibernates) a local or remote Windows computer.

Syntax

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

Description

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

Parameters

  • 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.

Inputs

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

Outputs

Suspend-Computer does not output any PowerShell objects.

Notes

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 .